0.12.4Nueva versión de Boost disponible
Nueva versiónv0.12.4Aug 19, 2026

Nueva versión de Boost disponible— Smarter savings and cleaner output

Descargar la última versiónNotas de la versión

$ telemetry

Envía trazas de Boost a tu plataforma de observabilidad

Boost exporta spans OpenTelemetry sanitizados al endpoint configurado. Para duplicarlos en tu backend, define EXTERNAL_OTEL_ENDPOINT y EXTERNAL_OTEL_HEADERS o EXTERNAL_OTEL_TOKEN.

Cómo elige Boost el destino externo

  • EXTERNAL_OTEL_ENDPOINT activa el destino OTLP adicional del cliente.
  • EXTERNAL_OTEL_HEADERS envía cabeceras key=value separadas por comas y tiene prioridad sobre el atajo de token.
  • EXTERNAL_OTEL_TOKEN es un atajo para Authorization=Bearer <token>.
  • Usa host:port para OTLP/gRPC o http://host / https://host para endpoints OTLP/HTTP.

Configuración rápida

Elige tu plataforma, sustituye marcadores y exporta las variables donde se ejecuta Boost.

# generic OTLP/gRPC collector
export EXTERNAL_OTEL_ENDPOINT=otel-collector.example.com:4317
export EXTERNAL_OTEL_HEADERS='Authorization=Bearer <collector-token>'

# local OTLP/HTTP collector
export EXTERNAL_OTEL_ENDPOINT=http://localhost:4318

Ejemplos por plataforma

Coralogix

Envía al endpoint OTLP gRPC de Coralogix con una API key Send-Your-Data.

OTLP
Tipo de token
Coralogix Send-Your-Data API key
Endpoint
ingress.:443
export EXTERNAL_OTEL_ENDPOINT=ingress.<coralogix-domain>:443
export EXTERNAL_OTEL_HEADERS='Authorization=Bearer <CORALOGIX_SEND_YOUR_DATA_API_KEY>'

Sustituye por tu región.

Datadog

Usa un Datadog Agent local o ingest OTLP directo si tu cuenta lo permite.

OTLP
Tipo de token
Datadog API key for direct ingest; no app header for local Agent
Endpoint
http://localhost:4318
# local Datadog Agent
export EXTERNAL_OTEL_ENDPOINT=http://localhost:4318

# direct OTLP traces ingest
export EXTERNAL_OTEL_ENDPOINT=<DATADOG_PROVIDED_OTLP_TRACES_HTTPS_ENDPOINT>
export EXTERNAL_OTEL_HEADERS='dd-api-key=<DD_API_KEY>,dd-otlp-source=<DATADOG_ASSIGNED_SOURCE>'

La mayoría de equipos apuntan Boost a un Agent local.

Elastic Cloud / Elastic APM

Envía trazas OTLP a Elastic Cloud o APM Server.

OTLP
Tipo de token
Elastic encoded API key, Elastic APM API key, or Elastic APM secret token
Endpoint
https://
export EXTERNAL_OTEL_ENDPOINT=https://<elastic-otlp-or-apm-endpoint>
export EXTERNAL_OTEL_HEADERS='Authorization=ApiKey <ELASTIC_ENCODED_API_KEY>'

Para secret tokens de APM Server, usa Authorization=Bearer.

Grafana Cloud

Usa el endpoint OTLP y token Basic auth de Grafana Cloud.

OTLP
Tipo de token
Grafana Cloud instance ID plus API token encoded as Basic auth
Endpoint
otlp-gateway-.grafana.net:443
export EXTERNAL_OTEL_ENDPOINT=otlp-gateway-<region>.grafana.net:443
export EXTERNAL_OTEL_HEADERS='Authorization=Basic <BASE64_INSTANCE_ID_COLON_TOKEN>'

El formato gRPC host:443 es el más portable.

Honeycomb

Envía trazas OTLP directamente a Honeycomb con tu API key.

OTLP
Tipo de token
Honeycomb API key
Endpoint
api.honeycomb.io:443
export EXTERNAL_OTEL_ENDPOINT=api.honeycomb.io:443
export EXTERNAL_OTEL_HEADERS='x-honeycomb-team=<HONEYCOMB_API_KEY>'

En EU usa api.eu1.honeycomb.io:443.

New Relic

Envía trazas OTLP a New Relic con tu license key.

OTLP
Tipo de token
New Relic license key
Endpoint
otlp.nr-data.net:443
export EXTERNAL_OTEL_ENDPOINT=otlp.nr-data.net:443
export EXTERNAL_OTEL_HEADERS='api-key=<NEW_RELIC_LICENSE_KEY>'

En EU usa otlp.eu01.nr-data.net:443.

Dónde definir las variables

Agentes locales

Exporta las variables en el shell que hereda tu editor o agente. Reinicia el editor tras cambiar archivos de inicio.

GitHub Actions

Guarda tokens en secrets de GitHub Actions y mapéalos al entorno del job. No commits tokens reales.

env:
  EXTERNAL_OTEL_ENDPOINT: otlp.nr-data.net:443
  EXTERNAL_OTEL_HEADERS: api-key=${{ secrets.NEW_RELIC_LICENSE_KEY }}

Notas de seguridad

  • Usa un token del proveedor con los permisos de ingest más restrictivos disponibles.
  • Prefiere EXTERNAL_OTEL_HEADERS cuando el proveedor necesite un nombre de cabecera distinto de Authorization.
  • Boost sanitiza los spans antes de exportar y los replica al endpoint de Boost y al tuyo.
  • No definas EXTERNAL_OTEL_ENDPOINT salvo que quieras duplicar spans fuera del destino de telemetría por defecto.