Getting Started

Send logs, traces, and metrics to Refrax using OpenTelemetry SDKs.

1. Create an account

Sign up at refrax.onl/signup and copy your ingestion API key from Settings.

2. Send telemetry

POST JSON batches to the ingest endpoint (CPX11 profile — no OTLP collector required):

curl -X POST https://ingest.refrax.onl/ingest/v1/batch \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REFRAX_API_KEY" \
  -d '{"logs":[{"timestamp":"2026-01-01T00:00:00Z","severity":"INFO","body":"hello","service":"api"}]}'

# Or use the demo script:
REFRAX_API_KEY=rfx_... node scripts/demo-ingest.js

3. OpenTelemetry (advanced)

For full OTLP, run the OTel Collector (see docker-compose.dev.yml) or use a custom exporter that posts to /ingest/v1/batch.

4. Verify

Open the dashboard and check Services, Logs, and Traces pages for incoming data.