OTLP Troubleshooting

Common issues and solutions.

No Data Appearing

1. Check API Token

curl -X POST https://otlp.statusradar.dev/v1/traces \
  -H "X-App-Token: your-token" \
  -H "Content-Type: application/json" \
  -d '{"resourceSpans":[]}'

# Should return: 200 OK
# Error 401: Invalid token

2. Verify Endpoint

Correct endpoints:

• ✅ https://otlp.statusradar.dev/v1/traces
• ✅ https://otlp.statusradar.dev/v1/logs
• ❌ https://otlp.statusradar.dev/traces (missing /v1)

3. Check Network

# Test connectivity
curl -I https://otlp.statusradar.dev/v1/traces

# Should return: 405 Method Not Allowed (POST required)

High Data Volume

1. Sampling

const sampler = new TraceIdRatioBasedSampler(0.1);  // Sample 10%

2. Filter Spans

processor.onStart = (span) => {
  if (span.name === 'healthcheck') {
    return false;  // Don't export
  }
};

Quota Exceeded

Monitor usage: Dashboard → Observability → Apps → Usage

Solutions:

• Reduce sampling rate
• Filter noisy spans
• Purchase top-up credits

Spans Not Linked

Ensure context propagation:

// Service A
const headers = {};
propagation.inject(context.active(), headers);

// Service B
const ctx = propagation.extract(context.active(), req.headers);
context.with(ctx, () => {
  // Spans will be linked
});

Getting Help

• Documentation: https://statusradar.dev/docs
• Email: [email protected]
• Discord: https://discord.gg/statusradar