LogDB OTLP ingest and query quickstart.

Set one endpoint, the local development tenant credentials, and the trace ID used by the trace query.

export LOGDB_ENDPOINT=http://127.0.0.1:4318
export LOGDB_TENANT=local
export LOGDB_TOKEN=local-dev-token
export LOGDB_DATASET=checkout
export LOGDB_TRACE_ID=4bf92f3577b34da6a3ce929d0e0e4736

These values point at the local development policy. The dataset comes from the OTLP resource attribute service.name=checkout.

Post one OpenTelemetry-shaped JSON compatibility log batch and keep the response for record ID extraction.

LOG_RESPONSE="$(curl -s -X POST "$LOGDB_ENDPOINT/v1/otlp/logs" \
  -H 'content-type: application/json' \
  -H "x-logdb-tenant: $LOGDB_TENANT" \
  -H "authorization: Bearer $LOGDB_TOKEN" \
  --data '{
    "resourceLogs": [{
      "resource": {
        "attributes": [
          {"key": "tenant_id", "value": {"stringValue": "local"}},
          {"key": "service.name", "value": {"stringValue": "checkout"}}
        ]
      },
      "scopeLogs": [{
        "logRecords": [{
          "timeUnixNano": "1783947600000000000",
          "body": {"stringValue": "payment accepted"}
        }]
      }]
    }]
  }')"

printf '%s\n' "$LOG_RESPONSE"

{"status":"accepted","signal":"log","accepted_records":1,"record_ids":["logdb_..."]}

Extract the first deterministic logdb_... record ID from the accepted response.

LOG_RECORD_ID="$(printf '%s' "$LOG_RESPONSE" | sed -nE 's/.*"record_ids":\["([^"]+)".*/\1/p')"
printf '%s\n' "$LOG_RECORD_ID"

logdb_...

Search the retained local segment bundles by exact record ID using the same tenant header and bearer token.

curl -s -X POST "$LOGDB_ENDPOINT/v1/query" \
  -H 'content-type: application/json' \
  -H "x-logdb-tenant: $LOGDB_TENANT" \
  -H "authorization: Bearer $LOGDB_TOKEN" \
  --data @- <<JSON
{
  "dataset": "$LOGDB_DATASET",
  "filter": {
    "record_id": "$LOG_RECORD_ID"
  },
  "page": {
    "limit": 10
  }
}
JSON

{
  "status": "ok",
  "api_version": "v1",
  "tenant_id": "local",
  "dataset": "checkout",
  "matched_records": 1,
  "results": [{
    "record": {
      "record_id": "logdb_...",
      "source": "v1.otlp_http",
      "signal": "log",
      "raw_payload": {"record": {"body": {"stringValue": "payment accepted"}}}
    }
  }],
  "used_indexes": ["record_id"]
}

Post two trace spans with the same trace ID so the query route can prove a retained trace selection.

TRACE_RESPONSE="$(curl -s -X POST "$LOGDB_ENDPOINT/v1/otlp/traces" \
  -H 'content-type: application/json' \
  -H "x-logdb-tenant: $LOGDB_TENANT" \
  -H "authorization: Bearer $LOGDB_TOKEN" \
  --data '{
    "resourceSpans": [{
      "resource": {
        "attributes": [
          {"key": "tenant_id", "value": {"stringValue": "local"}},
          {"key": "service.name", "value": {"stringValue": "checkout"}}
        ]
      },
      "scopeSpans": [{
        "spans": [
          {
            "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
            "spanId": "00f067aa0ba902b7",
            "name": "POST /checkout",
            "startTimeUnixNano": "1783947600000000000"
          },
          {
            "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
            "spanId": "00f067aa0ba902b8",
            "name": "SELECT inventory",
            "startTimeUnixNano": "1783947600000000100"
          }
        ]
      }]
    }]
  }')"

printf '%s\n' "$TRACE_RESPONSE"

{"status":"accepted","signal":"trace","accepted_records":2,"record_ids":["logdb_...","logdb_..."]}

Search the same dataset by exact trace ID and request one result so pagination is visible.

TRACE_QUERY_RESPONSE="$(curl -s -X POST "$LOGDB_ENDPOINT/v1/query" \
  -H 'content-type: application/json' \
  -H "x-logdb-tenant: $LOGDB_TENANT" \
  -H "authorization: Bearer $LOGDB_TOKEN" \
  --data @- <<JSON
{
  "dataset": "$LOGDB_DATASET",
  "filter": {
    "trace_id": "$LOGDB_TRACE_ID"
  },
  "page": {
    "limit": 1
  }
}
JSON
)"

printf '%s\n' "$TRACE_QUERY_RESPONSE"

{
  "status": "ok",
  "tenant_id": "local",
  "dataset": "checkout",
  "matched_records": 2,
  "results": [{"record": {"signal": "trace"}}],
  "page": {"limit": 1, "cursor": null, "next_cursor": "1"},
  "used_indexes": ["identity.trace_id"]
}

Use the returned cursor to fetch the second retained trace record.

curl -s -X POST "$LOGDB_ENDPOINT/v1/query" \
  -H 'content-type: application/json' \
  -H "x-logdb-tenant: $LOGDB_TENANT" \
  -H "authorization: Bearer $LOGDB_TOKEN" \
  --data @- <<JSON
{
  "dataset": "$LOGDB_DATASET",
  "filter": {
    "trace_id": "$LOGDB_TRACE_ID"
  },
  "page": {
    "limit": 1,
    "cursor": "1"
  }
}
JSON

{
  "status": "ok",
  "matched_records": 2,
  "results": [{"record": {"signal": "trace"}}],
  "page": {"limit": 1, "cursor": "1", "next_cursor": null}
}

Send a query without the local tenant headers to see the current local policy reject the request.

curl -s -X POST "$LOGDB_ENDPOINT/v1/query" \
  -H 'content-type: application/json' \
  --data '{"dataset":"checkout"}'

{"status":"rejected","retryable":false,"error":{"kind":"missing_tenant","message":"x-logdb-tenant header is required",...}}

Return to the service terminal and stop the startup script. It terminates the owned LogDB process before deleting the temporary directory it printed.

# Press Ctrl-C in the service terminal running bash start-logdb.sh.

The script exits, the local LogDB process stops, and only the printed /tmp/logdb-quickstart.<unique> directory is removed.