OpenTelemetry
OpenTelemetry support creates a managed opentelemetry catalog for logs and traces. Use it when you want application observability data to live next to product analytics, operational data, and business context in the same lakehouse.
Once enabled for an environment, Altertable accepts OTLP/HTTP protobuf exports and writes records into queryable tables:
Table | Description |
|---|---|
opentelemetry.main.spans | Trace spans with service, timing, status, attributes, events, and links |
opentelemetry.main.logs | Log records with severity, body, trace/span IDs, attributes, and resource attributes |
The tables are partitioned by event time and sorted for common service and trace lookups. You can query them with the same SQL engine, dashboards, insights, and agents you use for other catalogs.
Enable OpenTelemetry
- Open Catalogs in the target environment.
- Find OpenTelemetry in the new catalog options.
- Turn on the OpenTelemetry catalog.
- Configure your OpenTelemetry collector or SDK to export traces and logs to Altertable.
OpenTelemetry is enabled per environment. Each environment gets its own managed catalog and credentials boundary.
OTLP Endpoints
Send OTLP/HTTP protobuf data to the standard paths on api.altertable.ai:
Signal | Endpoint | Content type |
|---|---|---|
Traces | POST https://api.altertable.ai/v1/traces | application/x-protobuf |
Logs | POST https://api.altertable.ai/v1/logs | application/x-protobuf |
Authenticate with the same HTTP Basic Auth credentials used by the Lakehouse HTTP API. You can find those credentials in the Credentials section for the environment.
Send Data with OpenTelemetry SDKs
Use the standard OpenTelemetry SDK for your application language and configure its OTLP/HTTP exporter to send traces and logs to Altertable. The SDK handles instrumentation, batching, resource attributes, and protobuf encoding; Altertable receives the exported telemetry and writes it into the opentelemetry catalog.
See the OpenTelemetry SDK documentation for language-specific setup guides.
Learn more
- OpenTelemetry API: endpoint details for OTLP traces and logs.
- Query with Grafana: build Grafana panels over telemetry data.
- OpenTelemetry overview: when to use the managed telemetry catalog.