OpenTelemetry is an open-source observability framework for collecting, processing, and exporting telemetry data (metrics, traces, and logs) from your applications and infrastructure.
By integrating OpenTelemetry with Tinybird, you can analyze observability data in real time, build dashboards, and enrich it with other data sources.
Some common use cases for sending OpenTelemetry data to Tinybird include:
Read on to learn how to send data from OpenTelemetry to Tinybird.
Before you connect OpenTelemetry to Tinybird, ensure:
TipThe Tinybird OpenTelemetry Exporter is officially available in the OpenTelemetry Collector Contrib repository as of release v0.131.0. You can use the official OpenTelemetry Collector distributions that include the Tinybird exporter out of the box.
To get started quickly, you can use the Tinybird OpenTelemetry project template. This template provides ready-to-use Data Sources and Pipes for storing and analyzing your telemetry data in Tinybird.
# select or create a new workspace
tb login
# deploy the template
tb --cloud deploy --template https://github.com/tinybirdco/tinybird-otel-template/tree/main/
Below is an example configuration for the Tinybird OpenTelemetry Collector to export metrics, traces, and logs to Tinybird:
receivers:
otlp:
protocols:
grpc:
http:
processors:
batch:
timeout: 10s
send_batch_size: 8192
exporters:
tinybird:
endpoint: ${OTEL_TINYBIRD_API_HOST}
token: ${OTEL_TINYBIRD_TOKEN}
metrics:
sum:
datasource: otel_metrics_sum
histogram:
datasource: otel_metrics_histogram
exponential_histogram:
datasource: otel_metrics_exponential_histogram
gauge:
datasource: otel_metrics_gauge
traces:
datasource: otel_traces
logs:
datasource: otel_logs
service:
pipelines:
metrics:
receivers: [otlp]
processors: [batch]
exporters: [tinybird]
traces:
receivers: [otlp]
processors: [batch]
exporters: [tinybird]
logs:
receivers: [otlp]
processors: [batch]
exporters: [tinybird]
OTEL_TINYBIRD_API_HOST
: The API host for your Tinybird workspace (e.g., https://api.tinybird.co
).OTEL_TINYBIRD_TOKEN
: A Tinybird token with append permissions to the target Data Sources (otel_metrics
, otel_traces
, otel_logs
).