OTLP के माध्यम से अपने ऑब्ज़र्वेबिलिटी स्टैक में पुनर्प्राप्ति ट्रेस एक्सपोर्ट करें।
Seizn प्रत्येक पुनर्प्राप्ति ऑपरेशन के लिए OpenTelemetry ट्रेस नेटिव रूप से एक्सपोर्ट करता है। एंड-टू-एंड ऑब्ज़र्वेबिलिटी के लिए किसी भी OTLP-संगत बैकएंड से कनेक्ट करें।
एनवायरनमेंट वेरिएबल के माध्यम से OTLP एक्सपोर्ट कॉन्फ़िगर करें।
# Enable OTLP export in your Seizn client
# Set these environment variables
# Required: OTLP endpoint
export SEIZN_OTLP_ENDPOINT="https://your-collector:4318"
# Optional: Authentication
export SEIZN_OTLP_HEADERS="Authorization=Bearer your-token"
# Optional: Service name (default: seizn-client)
export SEIZN_SERVICE_NAME="my-rag-app"Datadog Agent या सीधे API के माध्यम से Datadog APM में ट्रेस एक्सपोर्ट करें।
# Option 1: Direct to Datadog (via Agent)
export SEIZN_OTLP_ENDPOINT="http://localhost:4318"
# Datadog Agent must have OTLP receiver enabled
# Option 2: Direct to Datadog API
export SEIZN_OTLP_ENDPOINT="https://trace.agent.datadoghq.com"
export SEIZN_OTLP_HEADERS="DD-API-KEY=your-datadog-api-key"
# Enable in Seizn
export SEIZN_TELEMETRY_ENABLED="true"otlp_config:
receiver:
protocols:
http:
endpoint: 0.0.0.0:4318Grafana Tempo (क्लाउड या सेल्फ-होस्टेड) में ट्रेस भेजें।
# Grafana Cloud
export SEIZN_OTLP_ENDPOINT="https://tempo-us-central1.grafana.net/tempo"
export SEIZN_OTLP_HEADERS="Authorization=Basic $(echo -n 'instance-id:api-token' | base64)"
# Self-hosted Tempo
export SEIZN_OTLP_ENDPOINT="http://tempo:4318"
# Enable in Seizn
export SEIZN_TELEMETRY_ENABLED="true"नेटिव OTLP रिसीवर समर्थन के साथ Jaeger में एक्सपोर्ट करें।
# Jaeger with OTLP receiver (v1.35+)
export SEIZN_OTLP_ENDPOINT="http://jaeger:4318"
export SEIZN_TELEMETRY_ENABLED="true"# Run Jaeger with OTLP support
docker run -d --name jaeger \
-e COLLECTOR_OTLP_ENABLED=true \
-p 16686:16686 \
-p 4318:4318 \
jaegertracing/all-in-one:latestहेड-बेस्ड या टेल-बेस्ड सैंपलिंग के साथ ट्रेस वॉल्यूम नियंत्रित करें।
import { Seizn } from 'seizn';
const client = new Seizn({
apiKey: process.env.SEIZN_API_KEY,
telemetry: {
enabled: true,
samplingRate: 0.1, // Sample 10% of traces
// Or use tail-based sampling
sampleOnlyErrors: true,
sampleSlowRequests: {
enabled: true,
thresholdMs: 1000,
},
},
});बेहतर फ़िल्टरिंग के लिए रिसोर्स और स्पैन एट्रिब्यूट जोड़ें।
const client = new Seizn({
apiKey: process.env.SEIZN_API_KEY,
telemetry: {
enabled: true,
resourceAttributes: {
'deployment.environment': 'production',
'service.version': '1.2.3',
'service.namespace': 'rag-apps',
},
spanAttributes: {
'user.tier': 'enterprise',
'feature.flag.rerank': 'enabled',
},
},
});बैच सेटिंग्स के साथ एक्सपोर्ट प्रदर्शन ऑप्टिमाइज़ करें।
const client = new Seizn({
apiKey: process.env.SEIZN_API_KEY,
telemetry: {
enabled: true,
batchConfig: {
maxQueueSize: 2048,
scheduledDelayMs: 5000,
maxExportBatchSize: 512,
},
},
});| समस्या | कारण | समाधान |
|---|---|---|
| कोई ट्रेस दिखाई नहीं दे रहा | टेलीमेट्री अक्षम या एंडपॉइंट गलत | SEIZN_TELEMETRY_ENABLED=true सेट करें और एंडपॉइंट सत्यापित करें |
| कनेक्शन अस्वीकृत | कलेक्टर चालू नहीं या गलत पोर्ट | कलेक्टर स्थिति और पोर्ट 4318 जांचें |
| ट्रेस में स्पैन गायब | सैंपलिंग दर बहुत कम | सैंपलिंग दर बढ़ाएं या सैंपलिंग अक्षम करें |
टेलीमेट्री समस्याओं के निवारण के लिए डीबग लॉगिंग सक्षम करें।
export SEIZN_TELEMETRY_DEBUG="true"
export OTEL_LOG_LEVEL="debug"