0.12.5Neue Boost-Version verfügbar
Neue Versionv0.12.5Aug 23, 2026

Neue Boost-Version verfügbar— More filters and safer output

Neueste Version herunterladenVersionshinweise

$ telemetry

Boost-Traces an Ihre Observability-Plattform senden

Boost exportiert immer bereinigte OpenTelemetry-Spans an den konfigurierten Boost-Endpunkt. Für dieselben Spans in Ihrem eigenen Backend setzen Sie EXTERNAL_OTEL_ENDPOINT und EXTERNAL_OTEL_HEADERS oder EXTERNAL_OTEL_TOKEN.

Wie Boost das externe Ziel wählt

  • EXTERNAL_OTEL_ENDPOINT aktiviert das zusätzliche kundeneigene OTLP-Ziel.
  • EXTERNAL_OTEL_HEADERS sendet kommagetrennte key=value-Header und hat Vorrang vor dem Token-Shortcut.
  • EXTERNAL_OTEL_TOKEN ist ein Shortcut für Authorization=Bearer <token>.
  • Nutzen Sie host:port für OTLP/gRPC oder http://host / https://host für OTLP/HTTP.

Schnelle Einrichtung

Wählen Sie Ihre Plattform, ersetzen Sie Platzhalter und exportieren Sie die Variablen in Shell, CI-Job oder Agent-Umgebung, die Boost ausführt.

# 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

Plattformbeispiele

Coralogix

Senden Sie an den Coralogix OTLP-gRPC-Ingress mit einem Send-Your-Data-API-Key.

OTLP
Token-Typ
Coralogix Send-Your-Data API key
Endpunkt
ingress.:443
export EXTERNAL_OTEL_ENDPOINT=ingress.<coralogix-domain>:443
export EXTERNAL_OTEL_HEADERS='Authorization=Bearer <CORALOGIX_SEND_YOUR_DATA_API_KEY>'

Ersetzen Sie durch Ihre Regionsdomain, z. B. eu1.coralogix.com oder us1.coralogix.com.

Datadog

Nutzen Sie einen lokalen Datadog Agent für das übliche OTLP-Setup oder direkten OTLP-Ingest, wenn Ihr Konto es erlaubt.

OTLP
Token-Typ
Datadog API key for direct ingest; no app header for local Agent
Endpunkt
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>'

Direkter OTLP-Ingest ist kontobasiert und HTTP/protobuf. Die meisten Teams zeigen Boost auf einen lokalen Agent.

Elastic Cloud / Elastic APM

Senden Sie OTLP-Traces an verwaltetes Elastic Cloud OTLP oder einen Elastic APM Server.

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

Für APM-Secret-Tokens: Authorization=Bearer . Für API-Keys: Authorization=ApiKey .

Grafana Cloud

Nutzen Sie den OTLP-Endpunkt und Basic-Auth-Token aus der Grafana-Cloud-OpenTelemetry-Kachel.

OTLP
Token-Typ
Grafana Cloud instance ID plus API token encoded as Basic auth
Endpunkt
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>'

Grafana Cloud zeigt auch OTLP/HTTP-Endpunkte. Für Boost ist gRPC host:443 am portabelsten.

Honeycomb

Senden Sie OTLP-Traces direkt an Honeycomb mit Ihrem API-Key.

OTLP
Token-Typ
Honeycomb API key
Endpunkt
api.honeycomb.io:443
export EXTERNAL_OTEL_ENDPOINT=api.honeycomb.io:443
export EXTERNAL_OTEL_HEADERS='x-honeycomb-team=<HONEYCOMB_API_KEY>'

Für EU: api.eu1.honeycomb.io:443. Honeycomb-Classic-Nutzer können x-honeycomb-dataset= hinzufügen.

New Relic

Senden Sie OTLP-Traces direkt an New Relic mit Ihrem License Key.

OTLP
Token-Typ
New Relic license key
Endpunkt
otlp.nr-data.net:443
export EXTERNAL_OTEL_ENDPOINT=otlp.nr-data.net:443
export EXTERNAL_OTEL_HEADERS='api-key=<NEW_RELIC_LICENSE_KEY>'

Für EU: otlp.eu01.nr-data.net:443. Für FedRAMP: gov-otlp.nr-data.net:443.

Wo Variablen setzen

Lokale Agenten

Exportieren Sie die Variablen in der Shell-Umgebung, die Editor oder Agent erbt. Starten Sie den Editor nach Änderungen an Shell-Startdateien neu.

GitHub Actions

Speichern Sie Tokens in GitHub-Actions-Secrets und mappen Sie sie in die Job-Umgebung, die Boost ausführt. Committen Sie keine echten Tokens in Workflows.

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

Sicherheitshinweise

  • Nutzen Sie ein Provider-Token mit den engsten verfügbaren Ingest-Berechtigungen.
  • Bevorzugen Sie EXTERNAL_OTEL_HEADERS, wenn der Provider einen anderen Header als Authorization braucht.
  • Boost bereinigt Spans vor dem Export und verteilt sie an Boost-Endpunkt und Ihren externen Endpunkt.
  • Setzen Sie EXTERNAL_OTEL_ENDPOINT nur, wenn Spans außerhalb des Standard-Boost-Ziels gespiegelt werden sollen.