tree 57dad026e168a605137769116ed92fb85ed20e7e
parent aa4b551befb9c8fcdb880503e27a8b9f8e1550f8
author JackieTien97 <jackietien97@gmail.com> 1776494279 +0800
committer JackieTien97 <jackietien97@gmail.com> 1776494279 +0800

[IOTDB-xxxx] Add OpenTelemetry (OTLP/HTTP) receiver for storing AI coding assistant telemetry

Add an OTLP/HTTP receiver to IoTDB's REST service that accepts
OpenTelemetry traces, metrics, and logs via standard OTLP/HTTP
endpoints. This enables storing telemetry data from AI coding
assistants (Claude Code, Codex, Gemini CLI, etc.) directly into
IoTDB's table model for local analytics.

Key design decisions:
- Reuses the existing REST service (Jetty + Jersey) on port 18080
  rather than introducing a new server or gRPC dependency
- Database name is derived dynamically from each request's
  service.name resource attribute (e.g. claude-code -> claude_code,
  codex -> codex), so different tools land in separate databases
- OTLP attributes are flattened into typed TAG/ATTRIBUTE/FIELD
  columns instead of being stored as opaque JSON blobs, enabling
  efficient time-series queries without JSON parsing
- Schema (database + tables) is created automatically on first
  ingest via idempotent DDL

New files (external-service-impl/rest/.../protocol/otlp/v1/):
- OtlpTracesResource/MetricsResource/LogsResource: JAX-RS endpoints
  at /rest/v1/otlp/v1/{traces,metrics,logs}
- OtlpService: singleton managing per-database sessions and schema
- OtlpSchemaInitializer: idempotent CREATE DATABASE/TABLE DDL
- OtlpIngestor + OtlpTableBatch: column-major batch -> InsertTablet
- OtlpTracesConverter/MetricsConverter/LogsConverter: OTLP -> rows
- OtlpConverter: timestamp precision, hex encoding, attribute helpers
- OtlpHttp: protobuf/JSON request parsing and response rendering

Modified files:
- rest/pom.xml: added opentelemetry-proto + protobuf-java-util deps
- AuthorizationFilter: bypass auth for /rest/v1/otlp/ paths
- IoTDBRestServiceConfig/Descriptor: added otlp_username/password
- iotdb-system.properties.template: documented OTLP config section