Use OpenTelemetry protocol endpoints
This feature is available only to specific Chronosphere Observability Platform users, and has not been announced or officially released. Do not share or discuss this feature, or information about it, with anyone outside of your organization.
Chronosphere Observability Platform supports ingesting log data using OpenTelemetry protocol (OTLP) HTTP ingestion endpoints.
For best results, ingest telemetry through a local OpenTelemetry Collector or Fluent Bit for processing and batching. Sending telemetry directly from an OpenTelemetry SDK can be less reliable.
Requirements
Your OTLP configuration must meet certain requirements.
API-Token
header: All requests must include theAPI-Token
HTTP header, with the API token of a valid service account with write permissions as the value.- OTLP version support: Only v1.0 and higher are supported.
- Supported compression methods: Chronosphere supports
gzip
compression. - Encryption: All requests must be encrypted using TLS.
Recommendations
Chronosphere recommends setting the timeout value for a logs request to 30 seconds, and to enable retries to prevent transient network errors from causing data loss.
OTLP endpoint URLs
Observability Platform provides HTTP endpoints for logs, metrics, and traces.
Telemetry type | HTTP endpoint URL |
---|---|
Logs | https://TENANT.chronosphere.io/data/opentelemetry/v1/logs |
Metrics | https://TENANT.chronosphere.io/data/opentelemetry/v1/metrics |
Traces | https://TENANT.chronosphere.io/data/opentelemetry/v1/traces |
Replace TENANT
with your organization prefixed to your Observability Platform
instance. For example, MY_ORGANIZATION
.chronosphere.io
.
OpenTelemetry exporters complete the path based on the telemetry type. For the otlphttp
exporter, set the endpoint base path as follows:
exporters:
otlphttp/chronosphere:
endpoint: https://TENANT.chronosphere.io/data/opentelemetry/
...
For an example OTLP exporter configuration, see Configure the OpenTelemetry Collector.