repodb/telemetry-default-collector repository overview

⁠RepoDB Telemetry Collector API

A RESTful API that ingests telemetry data emitted by RepoDB libraries and persists it to RepoDB PGSQL⁠.

⁠Authentication

Every endpoint (except /docs, /redoc, and /openapi.json) requires an X-API-Key header matching the API_KEY environment variable. Requests with a missing or invalid key receive 401 Unauthorized.

All client libraries are passing this header to authenticate against this API.

⁠Running with Docker

Create the network (skip if it already exists):

docker network create repodb

Run the image:

docker run -d --name repodb-telemetry-default-collector \
  -p 5000:5000 \
  -e API_KEY=RepoDB2026 \
  -e CONNECTION_STRING="postgresql://postgres:RepoDB2026@repodb-insights-postgres:5432/repodb_insights" --network=repodb \
  repodb/telemetry-default-collector:latest

The API listens on port 5000. Interactive API docs are available at /docs (Swagger UI) and /redoc (ReDoc).

⁠Configuration

The service is configured entirely via environment variables: