Compatibility

LivePreview ContractVerification Required

LogDB OTLP and S3 query compatibility matrix.

Compatibility matrix for LogDB OTLP ingest, optional gRPC, local query, S3 query-read selection, explicit signal exclusions, and future S3 publication work.

Current availability

Private Beta. Public beta is scheduled for November 2, 2026.

Matrix Snapshot

Matrix rows: 12
Status values: 6
Query stores: 2

Audience

Use this matrix when deciding whether a LogDB ingest, query, S3, or signal-scope behavior is active, locally bounded, unsupported, preview-only, future-facing, or still waiting on reviewer acceptance.

Maturity Status

Live Ingest And Query

Live

OTLP HTTP/protobuf, OTLP JSON compatibility, custom endpoint helpers, optional gRPC, and local retained-record query are grounded in the LogDB OTLP and query reference.

S3 And BYOC Boundary

Verification Required

S3 query-read selection, customer-owned storage direction, tenant policy language, and BYOC handoff remain review-bound. S3 publication is future work.

Compatibility Scope

Ingest Surface

The matrix covers custom endpoint helpers, native OTLP HTTP/protobuf, OTLP JSON compatibility, and optional OTLP/gRPC logs and traces.

Query Surface

Local segment query is active by default. S3 query-read can be configured, but that does not make ingest publish to S3.

Signal Boundary

Metrics and profiles are explicit exclusions. Current LogDB docs stay focused on logs, traces, retained segment search, and replay foundations.

Status Legend

Supported

Implemented and validated for the exact documented scope.

Partial

Some behavior works, but documented gaps, limits, or exclusions apply.

Unsupported

Not implemented, intentionally unavailable, or rejected at runtime.

Preview

Contract, fixture, or bounded surface exists before complete customer-facing support.

Future

Roadmap direction only; no current runtime behavior should be expected.

Verification Required

Evidence or reviewer acceptance is missing for a support claim.

OTLP And Query Matrix

Matrix owner: logdb-docs-owner. Required reviewers: logdb-product-sme, docs-qa-reviewer.

Review cadence: 45 days
Warning window: 14 days
Due soon rows: 0
Stale rows: 0

LogDB OTLP and S3 query compatibility rows
Capability	Status	Maturity	Notes	Evidence	Last reviewed
Native OTLP HTTP/protobuf logs and traces	Supported	Live	POST /v1/logs and POST /v1/traces accept OTLP protobuf batches with tenant headers and WAL-backed publication.	LDB-EVID-001 LDB-EVID-008 DOCS-033	2026-08-16Due 2026-09-30Current
OTLP HTTP JSON compatibility logs and traces	Supported	Live	POST /v1/otlp/logs and POST /v1/otlp/traces accept OpenTelemetry-shaped JSON, enforce tenant admission, and return deterministic record IDs.	LDB-EVID-002 LDB-EVID-007 LDB-EVID-008	2026-08-16Due 2026-09-30Current
Custom endpoint JSON helpers	Supported	Live	POST and GET /v1/endpoint/{activation_id} helper routes are implemented but remain separate from the tenant-admitted OTLP contract.	LDB-EVID-001 LDB-EVID-008	2026-08-16Due 2026-09-30Current
Optional OTLP/gRPC logs and traces	Partial	Live	Generated LogsService and TraceService export methods run only when LOGDB_OTLP_GRPC_BIND_ADDRESS is configured.	LDB-EVID-001 LDB-EVID-008 LDB-EVID-009	2026-08-16Due 2026-09-30Current
Local retained-record query	Supported	Live	POST /v1/query reads local segment bundles by dataset, exact record ID, exact trace ID, time filters, pagination, and deadline controls.	LDB-EVID-004 LDB-EVID-008 DOCS-033	2026-08-16Due 2026-09-30Current
Configured S3 query-read store	Partial	Verification Required	LOGDB_QUERY_STORE=s3 changes only the POST /v1/query read path for retained segment bundles. Ingest still writes through the local data and WAL path.	LDB-EVID-004 LDB-EVID-009 LDB-EVID-010	2026-08-16Due 2026-09-30Current
Tenant admission and query authorization	Verification Required	Verification Required	Local policy requires x-logdb-tenant, bearer credentials, matching OTLP tenant claims, dataset authorization, and quota checks; security review must accept external wording.	LDB-EVID-003 LDB-EVID-008 LDB-EVID-010	2026-08-16Due 2026-09-30Current
Ingest and query limits	Partial	Verification Required	OTLP batches cap at 512 records, gateway budgets are configurable, tenant windows apply, query pages default to 100 and cap at 500.	LDB-EVID-004 LDB-EVID-008 LDB-EVID-009	2026-08-16Due 2026-09-30Current
Metrics and profiles ingest	Unsupported	Verification Required	Current LogDB docs cover logs, traces, retained segment search, and replay foundations only. Metrics and profiles are outside the documented route surface.	LDB-EVID-006 LDB-EVID-008 LogDB product hub	2026-08-16Due 2026-09-30Current
Live ingest publication to S3	Future	Future	S3-backed publication needs approved-bucket conformance, operations evidence, and release review before it can be documented as active behavior.	LDB-EVID-005 LDB-EVID-009 PROJECT_MANAGEMENT.md	2026-08-16Due 2026-09-30Current
Replay coordinator foundations	Preview	Preview Contract	Local coordinator, checkpoint, and audit evidence can be discussed as preview foundations; public replay APIs and external sinks remain future-facing.	LDB-EVID-006 LogDB product hub	2026-08-16Due 2026-09-30Current
AWS BYOC package and customer-owned storage direction	Verification Required	Verification Required	Terraform, Helm, and offline preflight artifacts exist, but full deployment readiness and customer-owned S3 publication require operations and security acceptance.	LDB-EVID-009 LDB-EVID-010 DOCS-034	2026-08-16Due 2026-09-30Current

Current Limits

Ingest, query, and store boundaries
Limit	Value	Applies to
OTLP batch size	512 records	HTTP/protobuf logs, HTTP/protobuf traces, JSON compatibility logs and traces, and gRPC exports
OTLP gateway in-flight requests	64 by default	Shared HTTP and gRPC ingest backpressure
OTLP gateway in-flight records	8192 by default	Shared HTTP and gRPC ingest backpressure
OTLP gateway in-flight bytes	33554432 by default	Shared HTTP and gRPC ingest backpressure
Tenant admission window	10000 records, 16 MiB, 16 concurrent requests per 60 seconds	Local development tenant policy and policy-derived ingest checks
Query page size	Default 100, maximum 500	POST /v1/query
Endpoint recent readback	100 records	GET /v1/endpoint/{activation_id}/recent_100
Query store selection	Local by default, S3 query-read when configured	Query read path only

Explicit Exclusions

Metrics ingest, profiles ingest, dashboarding, SIEM replacement, public replay APIs, external sinks, and live S3 publication are outside the active LogDB route surface described by this matrix.

Evidence

DOCS-039 evidence map
Matrix area	Evidence	Status	Last reviewed
OTLP and query route surface	LDB-EVID-001, LDB-EVID-008, and DOCS-033	pending	2026-08-16
Quickstart-supported workflow	LDB-EVID-007 and /products/logdb/quickstart/	pending	2026-08-16
S3 query-read and BYOC configuration	LDB-EVID-009 and DOCS-034	pending	2026-08-16
Compatibility page artifact	LDB-EVID-010 and docs/compatibility/DOCS-039-logdb-otlp-s3-query-compatibility.md	pending	2026-08-16

Internal review records track this LogDB compatibility matrix and the evidence required to change row status.

Limits

This matrix covers current LogDB ingest and query documentation only. It does not approve S3 publication, BYOC deployment readiness, public replay APIs, external sinks, support, availability, performance, scale, security, compliance, or GA claims.

See the OTLP and query reference for route behavior and the configuration and BYOC reference for S3 query-read settings.

Safe Next Steps

Available: DOCS-024
Run OTLP ingest and query quickstart
Exercise OTLP JSON compatibility ingest, exact-record query, trace pagination, tenant headers, and cleanup.
Available: DOCS-033
Read OTLP and query reference
Use route shapes, tenant headers, query filters, limits, errors, and S3 query-read boundary language behind each matrix row.
Available: DOCS-034
Read configuration and BYOC reference
Check local runtime settings, optional gRPC bind, WAL modes, S3 query-read variables, and BYOC handoff limits.
Available
Review LogDB evidence
Check source records before expanding LogDB S3, BYOC, replay, support, security, or operational wording.
Available: DOCS-042
Read known limits
See metrics/profile exclusions, S3 query-read behavior, replay API, external sink, and BYOC boundaries.
Available: DOCS-043
Track matrix review workflow
Use the workflow for stale-row checks, evidence refresh, owner review, and release-note updates.