OTLP Ingest Reference

Oriel accepts OpenTelemetry Protocol data over gRPC and HTTP.

Endpoints

Protocol	Default address
OTLP gRPC	:4317
OTLP HTTP	:4318

When ingest.http_on_server = true and Oriel runs with --role=all, OTLP/HTTP is also accepted on the API/UI listener (server.http_addr) at /v1/traces, /v1/logs, and /v1/metrics. The dedicated :4318 listener remains available by default for existing exporters.

Use bearer auth:

Authorization: Bearer orl_...

Token Shape

Token secrets use:

orl_ + 26 Crockford base32 symbols + 6 Crockford CRC symbols

The server stores only sha256(secret). The token secret is shown once at creation.

Ingest Token Fields

Field	Meaning
Workspace	Fixed by the token.
Project	Required for ingest tokens.
Environment	Optional. If set, it pins all telemetry for the token.
Signals	Subset of traces, logs, metrics; defaults to all.
Expiry	Optional.

Environment Resolution

1. Token-pinned environment wins.
2. deployment.environment.name is used when the token does not pin an environment.
3. Legacy deployment.environment is used as a fallback.
4. Existing environment rows are used.
5. New environments are auto-registered when the project allows it and the cap has not been reached.
6. Otherwise the resource block is rejected.

Limits

Limit	Default
Attributes per row	128
Attribute key length	256 bytes
Attribute string value length	8192 bytes
Log body length	262144 bytes
Span events per span	128
Span links per span	64
Span/log rows per request	200000
Active metric series hard cap	2000000 per project per 24h estimate

Clamping produces ORL-1009 warnings. Oversized request row count produces ORL-1004.

Common Rejections

Code	Meaning
ORL-1001	Missing or invalid token.
ORL-1002	Token revoked or expired.
ORL-1003	Token does not permit the signal.
ORL-1005	Environment could not be resolved.
ORL-1006	Environment cap exceeded.
ORL-1010	Metric series cap exceeded.
ORL-1011	Timestamp outside acceptance window.
ORL-1012	Ingest is shedding load; retry later.