Troubleshooting Guide

Data Not Appearing

If your logs, metrics, or traces aren't showing up in Qorrelate, follow these steps:

# Test your credentials
curl -X POST https://qorrelate.io/v1/logs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Organization-Id: YOUR_ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"resourceLogs":[{"resource":{"attributes":[{"key":"test","value":{"stringValue":"true"}}]},"scopeLogs":[{"logRecords":[{"body":{"stringValue":"Test log"}}]}]}]}'

# Test connectivity
curl -v https://qorrelate.io/health

# If behind a proxy, check proxy settings
echo $HTTP_PROXY
echo $HTTPS_PROXY

# Python - force flush before exit
from opentelemetry import trace

provider = trace.get_tracer_provider()
provider.force_flush()  # Wait for data to be sent

// Node.js - shutdown gracefully
const { NodeSDK } = require('@opentelemetry/sdk-node');

process.on('SIGTERM', () => {
  sdk.shutdown().then(() => process.exit(0));
});

Authentication Errors

Missing or Incomplete Traces

If traces are partially missing or connections between services aren't showing:

Context Propagation Issues

Traces need context propagation headers to connect spans across services:

# Python - ensure propagation is configured
from opentelemetry.propagate import set_global_textmap
from opentelemetry.propagators.b3 import B3MultiFormat

# Use W3C Trace Context (default) or B3
set_global_textmap(B3MultiFormat())  # For B3 headers

Check these headers are being passed between services:

• traceparent (W3C Trace Context)
• tracestate (W3C Trace Context)
• x-b3-traceid, x-b3-spanid (B3 format)

High Query Latency

If queries are slow, try these optimizations:

• Narrow the time range: Querying smaller time windows is significantly faster.
• Use indexed fields: service.name, severity, and trace_id are indexed and fast to filter on.
• Avoid wildcards at the start: *error is slow. Use error* instead.
• Limit results: Use limit=100 instead of fetching thousands of records.

Python SDK Issues

# Make sure all packages are installed
pip install opentelemetry-api opentelemetry-sdk \
    opentelemetry-exporter-otlp-proto-http \
    opentelemetry-instrumentation

# Install all auto-instrumentation packages
opentelemetry-bootstrap -a install

# Run with auto-instrumentation
opentelemetry-instrument python app.py

Node.js SDK Issues

// tracing.js must be required FIRST
require('./tracing');  // This line must be first!

const express = require('express');
const app = express();
// ...

Kubernetes Issues

# Check collector logs
kubectl logs -n observability -l app.kubernetes.io/name=opentelemetry-collector

# Verify collector is running
kubectl get pods -n observability

# Test connectivity from app pod
kubectl exec -it your-app-pod -- curl -v http://otel-collector.observability.svc:4318/v1/traces

# Create the credentials secret
kubectl create secret generic qorrelate-credentials \
  --namespace observability \
  --from-literal=api-key=YOUR_API_KEY \
  --from-literal=org-id=YOUR_ORG_ID

Frequently Asked Questions

Still Need Help?