# OpenTelemetry

The OpenTelemetry plugin allows you to take logs, metrics, and traces from Fluent Bit and submit them to an OpenTelemetry HTTP endpoint.

Important Note: At the moment only HTTP endpoints are supported.

| Key                                      | Description                                                                                                                                                                                                                                                                                                                        | Default         |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
| host                                     | IP address or hostname of the target HTTP Server                                                                                                                                                                                                                                                                                   | 127.0.0.1       |
| http\_user                               | Basic Auth Username                                                                                                                                                                                                                                                                                                                |                 |
| http\_passwd                             | Basic Auth Password. Requires HTTP\_user to be set                                                                                                                                                                                                                                                                                 |                 |
| port                                     | TCP port of the target HTTP Server                                                                                                                                                                                                                                                                                                 | 80              |
| proxy                                    | Specify an HTTP Proxy. The expected format of this value is `http://HOST:PORT`. Note that HTTPS is **not** currently supported. It is recommended not to set this and to configure the [HTTP proxy environment variables](https://docs.fluentbit.io/manual/administration/http-proxy) instead as they support both HTTP and HTTPS. |                 |
| metrics\_uri                             | Specify an optional HTTP URI for the target web server listening for metrics, e.g: /v1/metrics                                                                                                                                                                                                                                     | /               |
| logs\_uri                                | Specify an optional HTTP URI for the target web server listening for logs, e.g: /v1/logs                                                                                                                                                                                                                                           | /               |
| traces\_uri                              | Specify an optional HTTP URI for the target web server listening for traces, e.g: /v1/traces                                                                                                                                                                                                                                       | /               |
| header                                   | Add a HTTP header key/value pair. Multiple headers can be set.                                                                                                                                                                                                                                                                     |                 |
| log\_response\_payload                   | Log the response payload within the Fluent Bit log                                                                                                                                                                                                                                                                                 | false           |
| logs\_body\_key                          | The log body key to look up in the log events body/message. Sets the Body field of the opentelemtry logs data model.                                                                                                                                                                                                               | message         |
| logs\_trace\_id\_message\_key            | The trace id key to look up in the log events body/message. Sets the TraceId field of the opentelemtry logs data model.                                                                                                                                                                                                            | traceId         |
| logs\_span\_id\_message\_key             | The span id key to look up in the log events body/message. Sets the SpanId field of the opentelemtry logs data model.                                                                                                                                                                                                              | spanId          |
| logs\_severity\_text\_message\_key       | The severity text id key to look up in the log events body/message. Sets the SeverityText field of the opentelemtry logs data model.                                                                                                                                                                                               | severityText    |
| logs\_severity\_number\_message\_key     | The severity number id key to look up in the log events body/message. Sets the SeverityNumber field of the opentelemtry logs data model.                                                                                                                                                                                           | severityNumber  |
| add\_label                               | This allows you to add custom labels to all metrics exposed through the OpenTelemetry exporter. You may have multiple of these fields                                                                                                                                                                                              |                 |
| compress                                 | Set payload compression mechanism. Option available is 'gzip'                                                                                                                                                                                                                                                                      |                 |
| logs\_observed\_timestamp\_metadata\_key | Specify an ObservedTimestamp key to look up in the metadata.                                                                                                                                                                                                                                                                       | $ObservedKey    |
| logs\_timestamp\_metadata\_key           | Specify a Timestamp key to look up in the metadata.                                                                                                                                                                                                                                                                                | $Timestamp      |
| logs\_severity\_key\_metadata\_key       | Specify a SeverityText key to look up in the metadata.                                                                                                                                                                                                                                                                             | $SeverityText   |
| logs\_severity\_number\_metadata\_key    | Specify a SeverityNumber key to look up in the metadata.                                                                                                                                                                                                                                                                           | $SeverityNumber |
| logs\_trace\_flags\_metadata\_key        | Specify a Flags key to look up in the metadata.                                                                                                                                                                                                                                                                                    | $Flags          |
| logs\_span\_id\_metadata\_key            | Specify a SpanId key to look up in the metadata.                                                                                                                                                                                                                                                                                   | $SpanId         |
| logs\_trace\_id\_metadata\_key           | Specify a TraceId key to look up in the metadata.                                                                                                                                                                                                                                                                                  | $TraceId        |
| logs\_attributes\_metadata\_key          | Specify an Attributes key to look up in the metadata.                                                                                                                                                                                                                                                                              | $Attributes     |

## Getting Started

The OpenTelemetry plugin works with logs and only the metrics collected from one of the metric input plugins. In the following example, log records generated by the dummy plugin and the host metrics collected by the node exporter metrics plugin are exported by the OpenTelemetry output plugin.

```
# Dummy Logs & traces with Node Exporter Metrics export using OpenTelemetry output plugin
# -------------------------------------------
# The following example collects host metrics on Linux and dummy logs & traces and delivers
# them through the OpenTelemetry plugin to a local collector :
#
[SERVICE]
    Flush                1
    Log_level            info

[INPUT]
    Name                 node_exporter_metrics
    Tag                  node_metrics
    Scrape_interval      2

[INPUT]
    Name                 dummy
    Tag                  dummy.log
    Rate                 3

[INPUT]
    Name                 event_type
    Type                 traces

[OUTPUT]
    Name                 opentelemetry
    Match                *
    Host                 localhost
    Port                 443
    Metrics_uri          /v1/metrics
    Logs_uri             /v1/logs
    Traces_uri           /v1/traces
    Log_response_payload True
    Tls                  On
    Tls.verify           Off
    logs_body_key $message
    logs_span_id_message_key span_id
    logs_trace_id_message_key trace_id
    logs_severity_text_message_key loglevel
    logs_severity_number_message_key lognum
    # add user-defined labels
    add_label            app fluent-bit
    add_label            color blue
```