Skip to content
Oriel

OTLP ingest reference

Oriel accepts OpenTelemetry Protocol data over gRPC and HTTP.

Endpoints

Section titled “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, /v1/metrics, and /v1/profiles. The dedicated :4318 listener remains available by default for existing exporters.

Profiles are OTLP’s development-stage fourth signal; Oriel folds each profile’s samples into collapsed stacks at ingest and queries them through the profiles OQL source. See Continuous profiling.

Use bearer auth:

Authorization: Bearer orl_...

Token shape

Section titled “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

Section titled “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, profiles; defaults to all.
Expiry Optional.

Environment resolution

Section titled “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

Section titled “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

Section titled “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.