Skip to content

Updated and fixed opentelemetry input plugin options configuration table. Fixes #2152. #2153

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 10 commits into from
Nov 9, 2025
+46 −12
Merged

Updated and fixed opentelemetry input plugin options configuration table. Fixes #2152. #2153

Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
b066390
Updated and fixed opentelemetry input plugin options configuration ta…
eschabell Nov 7, 2025
1ece961
Fixed linting issue on options description.
eschabell Nov 7, 2025
400b54f
Fixed linting issue on options description.
eschabell Nov 7, 2025
f382640
Fixed more linting issue on options description.
eschabell Nov 7, 2025
74f1771
Update pipeline/inputs/opentelemetry.md
eschabell Nov 9, 2025
080ca5d
Update pipeline/inputs/opentelemetry.md
eschabell Nov 9, 2025
a36d86f
Update pipeline/inputs/opentelemetry.md
eschabell Nov 9, 2025
28f6ba4
Update pipeline/inputs/opentelemetry.md
eschabell Nov 9, 2025
7500238
Update pipeline/inputs/opentelemetry.md
eschabell Nov 9, 2025
ec01d7d
CodeRabbitAI findings applied to opentelemetry input plugin docs update.
eschabell Nov 9, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 46 additions & 12 deletions pipeline/inputs/opentelemetry.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,18 +10,52 @@ Fluent Bit has a compliant implementation which fully supports `OTLP/HTTP` and `

## Configuration

| Key | Description | Default |
|---|---|---|
| `listen` | The network address to listen on. | `0.0.0.0` |
| `port` | The port for Fluent Bit to listen for incoming connections. In Fluent Bit 3.0.2 or later, this port is used for both transport `OTLP/HTTP` and `OTLP/GRPC`. | `4318` |
| `tag` | Tag for all data ingested by this plugin. This will only be used if `tag_from_uri` is set to `false`. Otherwise, the tag will be created from the URI. | _none_ |
| `tag_key` | Specify the key name to overwrite a tag. If set, the tag will be overwritten by a value of the key. | _none_ |
| `raw_traces` | Route trace data as a log. | `false` |
| `buffer_max_size` | Specify the maximum buffer size in `KB`, `MB`, or `GB` to the HTTP payload. | `4M` |
| `buffer_chunk_size` | Initial size and allocation strategy to store the payload (advanced users only)` | `512K` |
| `successful_response_code` | Allows for setting a successful response code. Supported values: `200`, `201`, or `204`. | `201` |
| `tag_from_uri` | By default, the tag will be created from the URI. For example, `v1_metrics` from `/v1/metrics`. This must be set to false if using `tag`. | `true` |
| `threaded` | Indicates whether to run this input in its own [thread](../../administration/multithreading.md#inputs). | `false` |
| Key | Description | Default |
|-------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------|
| `alias` | Sets an alias for multiple instances of the same input plugin. If no alias is specified, a default name will be assigned using the plugin name followed by a dot and a sequence number. | _none_ |
| `buffer_max_size` | Specify the maximum buffer size in `KB`, `MB`, or `GB` to the HTTP payload. | `4M` |
| `buffer_chunk_size` | Initial size and allocation strategy to store the payload (advanced users only). | `512K` |
| `encode_profiles_as_log` | Encode profiles received as text and ingest them in the logging pipeline. | `true` |
| `host` | The hostname. | `localhost` |
| `http2` | Enable or disable HTTP/2 support. | `true` |
| `listen` | The network address to listen on. | `0.0.0.0` |
| `log_level` | Specifies the log level for this plugin. If not set here, the plugin uses the global log level specified in the `service` section of your configuration file. | `info` |
| `log_supress_interval` | Suppresses log messages from this plugin that appear similar within a specified time interval. `0` no suppression. | `0` |
| `logs_body_key` | Specify a body key. | _none_ |
| `logs_metadata_key` | Specify a metadata key. | `otlp` |
| `mem_buf_limit` | Set a memory buffer limit for the input plugin. If the limit is reached, the plugin will pause until the buffer is drained. The value is in bytes. If set to 0, the buffer limit is disabled. | `0` |
| `net.accept_timeout` | Set maximum time allowed to establish an incoming connection. This time includes the TLS handshake. | `10s` |
| `net.accept_timeout_log_error` | On client accept timeout, specify if it should log an error. When disabled, the timeout is logged as a debug message. | `true` |
| `net.backlog` | Set the backlog size for listening sockets. | `128` |
| `net.io_timeout` | Set maximum time a connection can stay idle. | `0s` |
| `net.keepalive` | Enable or disable keepalive support. | `true` |
| `net.share_port` | Allow multiple plugins to bind to the same port. | `false` |
| `port` | The port for Fluent Bit to listen for incoming connections. | `4318` |
| `profiles_support` | This is an experimental feature, feel free to test it but don't enable this in production environments. | `false` |
| `raw_traces` | Forward traces without processing. | `false` |
| `routable` | If set to `true`, the data generated by the plugin will be routable, meaning that it can be forwarded to other plugins or outputs. If set to `false`, the data will be discarded. | `true` |
| `storage.pause_on_chunks_overlimit` | Enable pausing on an input when they reach their chunks limit. | _none_ |
| `storage.type` | Sets the storage type for this input, one of: `filesystem`, `memory` or `memrb`. | `memory` |
| `successful_response_code` | Allows for setting a successful response code. Supported values: `200`, `201`, or `204`. | `201` |
| `tag` | Set a tag for the events generated by this input plugin. | _none_ |
| `tag_from_uri` | By default, the tag will be created from the URI. For example, `v1_metrics` from `/v1/metrics`. This must be set to false if using `tag`. | `true` |
| `tag_key` | Specify the key name to overwrite a tag. If set, the tag will be overwritten by a value of the key. | _none_ |
| `threaded` | Enable threading on an input. | `false` |
| `thread.ring_buffer.capacity` | Set custom ring buffer capacity when the input runs in threaded mode. | `1024` |
| `thread.ring_buffer.window` | Set custom ring buffer window percentage for threaded inputs. | `5` |
| `tls` | Enable or disable TLS/SSL support. | `off` |
| `tls.ca_file` | Absolute path to CA certificate file. | _none_ |
| `tls.ca_path` | Absolute path to scan for certificate files. | _none_ |
| `tls.cert_file` | Absolute path to Certificate file. | _none_ |
| `tls.ciphers` | Specify TLS ciphers up to TLSv1.2. | _none_ |
| `tls.debug` | Set TLS debug level. Accepts `0` (No debug), `1`(Error), `2` (State change), `3` (Informational) and `4` (Verbose). | `1` |
| `tls.key_file` | Absolute path to private Key file. | _none_ |
| `tls.key_passwd` | Optional password for tls.key_file file. | _none_ |
| `tls.max_version` | Specify the maximum version of TLS. | _none_ |
| `tls.min_version` | Specify the minimum version of TLS. | _none_ |
| `tls.verify` | Force certificate validation. | `on` |
| `tls.verify_hostname` | Enable or disable to verify hostname. | `off` |
| `tls.vhost` | Hostname to be used for TLS SNI extension. | _none_ |

Raw traces means that any data forwarded to the traces endpoint (`/v1/traces`) will be packed and forwarded as a log message, and won't be processed by Fluent Bit. The traces endpoint by default expects a valid `protobuf` encoded payload, but you can set the `raw_traces` option in case you want to get trace telemetry data to any of the Fluent Bit supported outputs.

Expand Down