{"id":37151450,"url":"https://github.com/r0mdau/fluentforwardexporter","last_synced_at":"2026-01-14T17:53:19.997Z","repository":{"id":207499645,"uuid":"719357746","full_name":"r0mdau/fluentforwardexporter","owner":"r0mdau","description":"Opentelemetry exporter for the Fluent Forward protocol","archived":false,"fork":false,"pushed_at":"2025-11-08T17:59:19.000Z","size":101,"stargazers_count":1,"open_issues_count":0,"forks_count":5,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-11-08T19:21:49.178Z","etag":null,"topics":["exporter","fluentd","go","golang","logging","opentelemetry","opentelemetry-collector"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/r0mdau.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-11-16T01:57:18.000Z","updated_at":"2025-11-08T17:58:47.000Z","dependencies_parsed_at":"2024-08-21T03:28:02.683Z","dependency_job_id":"c748300d-c9be-4937-ae0e-b488722030c7","html_url":"https://github.com/r0mdau/fluentforwardexporter","commit_stats":null,"previous_names":["r0mdau/fluentforwardexporter"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/r0mdau/fluentforwardexporter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r0mdau%2Ffluentforwardexporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r0mdau%2Ffluentforwardexporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r0mdau%2Ffluentforwardexporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r0mdau%2Ffluentforwardexporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/r0mdau","download_url":"https://codeload.github.com/r0mdau/fluentforwardexporter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r0mdau%2Ffluentforwardexporter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28428963,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T16:38:47.836Z","status":"ssl_error","status_checked_at":"2026-01-14T16:34:59.695Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["exporter","fluentd","go","golang","logging","opentelemetry","opentelemetry-collector"],"created_at":"2026-01-14T17:53:19.390Z","updated_at":"2026-01-14T17:53:19.985Z","avatar_url":"https://github.com/r0mdau.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Fluent Forward Exporter\n\u003c!-- status autogenerated section --\u003e\n| Status        |           |\n| ------------- |-----------|\n| Stability     | [development]: logs   |\n| Distributions | [contrib] |\n| Issues        | [![Open issues](https://img.shields.io/github/issues-search/open-telemetry/opentelemetry-collector-contrib?query=is%3Aissue%20is%3Aopen%20label%3Aexporter%2Ffluentforward%20\u0026label=open\u0026color=orange\u0026logo=opentelemetry)](https://github.com/open-telemetry/opentelemetry-collector-contrib/issues?q=is%3Aopen+is%3Aissue+label%3Aexporter%2Ffluentforward) [![Closed issues](https://img.shields.io/github/issues-search/open-telemetry/opentelemetry-collector-contrib?query=is%3Aissue%20is%3Aclosed%20label%3Aexporter%2Ffluentforward%20\u0026label=closed\u0026color=blue\u0026logo=opentelemetry)](https://github.com/open-telemetry/opentelemetry-collector-contrib/issues?q=is%3Aclosed+is%3Aissue+label%3Aexporter%2Ffluentforward) |\n| [Code Owners](https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/CONTRIBUTING.md#becoming-a-code-owner)    | [@r0mdau](https://www.github.com/r0mdau) |\n\n[development]: https://github.com/open-telemetry/opentelemetry-collector#development\n[contrib]: https://github.com/open-telemetry/opentelemetry-collector-releases/tree/main/distributions/otelcol-contrib\n\u003c!-- end autogenerated section --\u003e\n\nForward is the protocol used by Fluentd to route message between peers.\n\n- Protocol specification: [Forward protocol specification v1](https://github.com/fluent/fluentd/wiki/Forward-Protocol-Specification-v1)\n- Library used [IBM/fluent-forward-go](https://github.com/IBM/fluent-forward-go) (MIT License)\n\n## Getting Started\n\n### Settings\n\n| Property | Default value | Type | Description |\n|---|---|---|---|\n| endpoint.tcp_addr |  | string | **MANDATORY** Target URL to send `Forward` log streams to |\n| endpoint.validate_tcp_resolution | false | bool | Controls whether to validate the tcp address and fail at startup. |\n| connection_timeout | 30s | time.Duration | Maximum amount of time a dial will wait for a connect to complete |\n| tls.insecure | true | bool | If set to **true**, the connection is not secured with TLS. |\n| tls.insecure_skip_verify | false | bool | Controls whether the exporter verifies the server's certificate chain and host name. If **true**, any certificate is accepted and any host name. This mode is susceptible to man-in-the-middle attacks |\n| tls.ca_file | \"\" | string | Used for mTLS. Path to the CA cert. For a client this verifies the server certificate |\n| tls.cert_file | \"\" | string | Used for mTLS. Path to the client TLS cert to use |\n| tls.key_file | \"\" | string | Used for mTLS. Path to the client TLS key to use |\n| shared_key | \"\" | string | A key string known by the server, used for authorization |\n| require_ack| false | bool | Protocol delivery acknowledgment for log streams : true = at-least-once, false = at-most-once |\n| tag | \"tag\" | string | Fluentd tag is a string separated by '.'s (e.g. myapp.access), and is used as the directions for Fluentd's internal routing engine |\n| compress_gzip | false | bool | Transparent data compression. You can use this feature to reduce the transferred payload size |\n| default_labels_enabled | true | map[string]bool | If omitted then default labels will be added. If one of the labels is omitted then this label will be added |\n\nSee the default values in the method `createDefaultConfig()` in [factory.go](factory.go) file.\n\nExample, for `default_labels_enabled` that will add only the `timestamp` attribute in the log record:\n\n```yaml\nexporters:\n  fluentforward:\n    endpoint:\n      tcp_addr: a.new.fluentforward.target:24224\n    connection_timeout: 10s\n    require_ack: true\n    tag: nginx\n    compress_gzip: true\n    default_labels_enabled:\n      timestamp: true\n      level: false\n      message: false\n```\n\nBut a best practice is to have at least `timestamp`, `level` and `message` in the exported log record to a Fluent endpoint.\n\nExample with TLS enabled and shared key:\n\n```yaml\nexporters:\n  fluentforward:\n    endpoint:\n      tcp_addr: a.new.fluentforward.target:24224\n    connection_timeout: 10s\n    tls:\n      insecure: false\n    shared_key: otelcol-dev\n```\n\nExample with mutual TLS authentication (mTLS):\n\n```yaml\nexporters:\n  fluentforward:\n    endpoint:\n      tcp_addr: a.new.fluentforward.target:24224\n    connection_timeout: 10s\n    tls:\n      insecure: false\n      ca_file: ca.crt.pem\n      cert_file: client.crt.pem\n      key_file: client.key.pem\n```\n\n## Severity\n\nOpenTelemetry uses `record.severity` to track log levels.\n\n## Advanced Configuration\n\nQueued retry capabilities are enabled by default, see the [Exporter Helper queuing and retry settings](https://github.com/open-telemetry/opentelemetry-collector/blob/main/exporter/exporterhelper/README.md) to fine tune them.\n\nExample usage:\n\n```yaml\nexporters:\n  fluentforward:\n    endpoint:\n      tcp_addr: a.new.fluentforward.target:24224\n    connection_timeout: 10s\n    retry_on_failure:\n      enabled: true\n      initial_interval: 5s\n      max_interval: 30s\n      max_elapsed_time: 5m\n    sending_queue:\n      enabled: true\n      num_consumers: 10\n      queue_size: 2000\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr0mdau%2Ffluentforwardexporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fr0mdau%2Ffluentforwardexporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr0mdau%2Ffluentforwardexporter/lists"}