{"id":29543470,"url":"https://github.com/tinybirdco/tinybird-otel-template","last_synced_at":"2026-03-11T12:13:46.088Z","repository":{"id":300903750,"uuid":"1004209436","full_name":"tinybirdco/tinybird-otel-template","owner":"tinybirdco","description":"A Tinybird project template for OpenTelemetry-based instrumentation","archived":false,"fork":false,"pushed_at":"2025-07-22T09:52:14.000Z","size":25,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-22T11:42:22.654Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"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/tinybirdco.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}},"created_at":"2025-06-18T09:27:56.000Z","updated_at":"2025-07-22T09:52:18.000Z","dependencies_parsed_at":"2025-06-24T07:42:21.035Z","dependency_job_id":null,"html_url":"https://github.com/tinybirdco/tinybird-otel-template","commit_stats":null,"previous_names":["tinybirdco/tinybird-otel-template"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tinybirdco/tinybird-otel-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinybirdco%2Ftinybird-otel-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinybirdco%2Ftinybird-otel-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinybirdco%2Ftinybird-otel-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinybirdco%2Ftinybird-otel-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tinybirdco","download_url":"https://codeload.github.com/tinybirdco/tinybird-otel-template/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinybirdco%2Ftinybird-otel-template/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266563915,"owners_count":23948689,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2025-07-17T14:01:12.095Z","updated_at":"2026-03-11T12:13:46.081Z","avatar_url":"https://github.com/tinybirdco.png","language":null,"funding_links":[],"categories":["Others"],"sub_categories":[],"readme":"# Tinybird OpenTelemetry Template\n\n[OpenTelemetry](https://opentelemetry.io/) is an open-source observability framework for collecting, processing, and exporting telemetry data (metrics, traces, and logs) from your applications and infrastructure.\n\nIntegrating Tinybird as an OpenTelemetry backend, you can analyze observability data in real time, build dashboards, and enrich it with other data sources.\n\nLearn more about observability with Tinybird at https://www.tinybird.co/observability\n\n![](./opentelemetry.png)\n\n## Set up the project\n\nFork the GitHub repository and deploy the data project to Tinybird.\n\n```bash\n# select or create a new workspace\ntb login\n\n# deploy the template\ntb --cloud deploy --template https://github.com/tinybirdco/tinybird-otel-template/tree/main/\n\n# you'll need this token for the opentelemetry exporter configuration\ntb --cloud token copy OTEL_TINYBIRD_TOKEN\n\n# check your Tinybird API host needed for the opentelemetry exporter configuration\ntb info\n```\n\n## Send logs, metrics and traces\n\nPaste the Tinybird OpenTelemetry `exporter` configuration into your OTel collector instance:\n\n```yaml\nreceivers:\n  otlp:\n    protocols:\n      grpc:\n        endpoint: 0.0.0.0:4317\n      http:\n        endpoint: 0.0.0.0:4318\n\nprocessors:\n  batch:\n    timeout: 10s\n    send_batch_size: 8192\n\nexporters:\n  tinybird:\n    endpoint: ${OTEL_TINYBIRD_API_HOST}         # Your Events API endpoint, e.g. https://api.us-east.aws.tinybird.co\n    token: ${OTEL_TINYBIRD_TOKEN}               # Token with append permissions\n    sending_queue:\n      enabled: true\n      queue_size: 104857600                # Total memory buffer in bytes (100 MB)\n      sizer: bytes\n      batch:\n        flush_timeout: 5s                  # Max wait time before flushing\n        min_size: 1024000                  # Min batch size: 1 MB\n        max_size: 8388608                  # Max batch size: 8 MB (Events API limit is 10 MB)\n    retry_on_failure:\n      enabled: true\n    metrics:\n      sum:\n        datasource: otel_metrics_sum\n      histogram:\n        datasource: otel_metrics_histogram\n      exponential_histogram:\n        datasource: otel_metrics_exponential_histogram\n      gauge:\n        datasource: otel_metrics_gauge\n    logs:\n      datasource: otel_logs\n    traces:\n      datasource: otel_traces\n\nservice:\n  pipelines:\n    metrics:\n      receivers: [otlp]\n      processors: [batch]\n      exporters: [tinybird]\n\n    traces:\n      receivers: [otlp]\n      processors: [batch]\n      exporters: [tinybird]\n\n    logs:\n      receivers: [otlp]\n      processors: [batch]\n      exporters: [tinybird]\n```\n\n\u003e The Tinybird OpenTelemetry Exporter is officially available in the [OpenTelemetry Collector Contrib repository](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/tinybirdexporter) as of release v0.131.0. You can use the official OpenTelemetry Collector distributions that include the Tinybird exporter out of the box.\n\nMake sure you are running a release version of the OpenTelemetry Collector higher than release v0.131.0.\n\n- [GitHub Releases](https://github.com/open-telemetry/opentelemetry-collector-contrib/releases)\n- [Docker Hub](https://hub.docker.com/r/otel/opentelemetry-collector-contrib)\n\n### Environment variables\n\n* `OTEL_TINYBIRD_API_HOST`: The API host for your Tinybird workspace (e.g., `https://api.tinybird.co`). You can get it with `tb info`\n* `OTEL_TINYBIRD_TOKEN`: A Tinybird token with **append** permissions to the target Data Sources (`otel_metrics`, `otel_traces`, `otel_logs`). Grab yours with `tb --cloud token copy OTEL_TINYBIRD_TOKEN`\n\n## Analyzing logs, traces and metrics with Grafana\n\nYou can connect your logs, traces and metrics in Tinybird to compatible visualization tools using the [ClickHouse HTTP interface](https://www.tinybird.co/docs/forward/work-with-data/publish-data/clickhouse-interface).\n\nLearn how to use [Grafana](https://www.tinybird.co/docs/forward/work-with-data/publish-data/guides/connect-grafana) to explore logs, traces and build alerts out of your metrics.\n\n## opentelemetry-demo\n\nClone the [opentelemetry-demo](https://github.com/tinybirdco/opentelemetry-demo) repository for a quick demo on how to run the whole observability stack locally\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftinybirdco%2Ftinybird-otel-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftinybirdco%2Ftinybird-otel-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftinybirdco%2Ftinybird-otel-template/lists"}