OpenTelemetry API
Use the OpenTelemetry API to send OTLP/HTTP protobuf traces and logs to Altertable. Altertable writes accepted telemetry into the built-in opentelemetry catalog for the target environment.
For application setup, prefer the standard OpenTelemetry SDKs. This page documents the HTTP endpoints those SDKs and collectors send to.
API endpoint
Hostname | Port | Protocol |
|---|---|---|
api.altertable.ai | 443 (HTTPS) | OTLP/HTTP protobuf |
Authentication
Authenticate requests with the same HTTP Basic Auth credentials used by the Lakehouse API. Base64-encode your credentials in the format lakehouse_username:lakehouse_password:
echo -n "YOUR_LAKEHOUSE_USERNAME:YOUR_LAKEHOUSE_PASSWORD" | base64
Then send the encoded value in the Authorization header:
Authorization: Basic <ALTERTABLE_BASIC_AUTH_TOKEN>
Endpoints
Signal | Endpoint | Request body | Content type |
|---|---|---|---|
Traces | POST https://api.altertable.ai/v1/traces | OTLP ExportTraceServiceRequest protobuf payload | application/x-protobuf |
Logs | POST https://api.altertable.ai/v1/logs | OTLP ExportLogsServiceRequest protobuf payload | application/x-protobuf |
Altertable does not support OpenTelemetry metrics yet. Do not send OTLP metrics payloads to Altertable.
POST/v1/traces
- Authentication
- HTTP Basic Auth
- Permission
- Write telemetry
Parameters
- Content-Typeapplication/x-protobuf· header · Required
- OTLP protobuf media type.
- bodyExportTraceServiceRequest· body · Required
- Binary OTLP trace export payload.
Accepted spans are written to opentelemetry.main.spans.
POST/v1/logs
- Authentication
- HTTP Basic Auth
- Permission
- Write telemetry
Parameters
- Content-Typeapplication/x-protobuf· header · Required
- OTLP protobuf media type.
- bodyExportLogsServiceRequest· body · Required
- Binary OTLP log export payload.
Accepted log records are written to opentelemetry.main.logs.
Related docs
- OpenTelemetry ingest: enable the catalog and configure SDKs or collectors.
- OpenTelemetry OTLP specification: request payload definitions and protocol behavior.
- Lakehouse API authentication: Basic Auth format for lakehouse credentials.