التتبعات (OTLP)

نقطة النهاية POST /v1/traces

تصدّر حزم OpenTelemetry SDK والـ Collectors الـ spans إلى هنا، وترسل حزم Blipit SDK الـ spans الخاصة بها إلى هنا أيضًا.

1الطلب

X-Blipit-Key أو Authorization: Bearer، عام أو سري. جسم OTLP/HTTP JSON حتى 4 ميغابايت، مع قبول gzip أو deflate أو brotli، بحد أقصى 1,000 نطاق لكل طلب. يسمّي service.name من المورد الخدمة؛ وتصبح نطاقات الخادم والمستهلك والجذور معاملات. تُقطع الأوصاف عند 1,000 حرف (عبارات db عند 2,000)؛ ويُحتفظ بـ 32 وسمًا من 256 حرفًا لكل منها.

ini
OTEL_EXPORTER_OTLP_ENDPOINT=https://in.blipit.io
OTEL_EXPORTER_OTLP_PROTOCOL=http/json
OTEL_EXPORTER_OTLP_HEADERS=x-blipit-key=<public key>
OTEL_SERVICE_NAME=shop-api

2الاستجابات

200 {accepted: true, spans: n}. 202 {accepted: false, reason: 'monthly span allowance used up'}. 400 JSON غير قابل للقراءة. 413 أكثر من 1,000 نطاق. 415 نوع محتوى protobuf. 401 مفتاح مجهول.

من المفيد معرفته

  • النطاقات شهريًا: Free ‏1 مليون، Solo ‏2 مليون، Team ‏10 ملايين، Scale ‏20 مليونًا؛ تُحفظ 7 أيام على Free وSolo، و14 على Team وScale.
  • لا يُقرأ gRPC وprotobuf؛ أبقِ البروتوكول على http/json.
  • 409 عندما تأتي البيانات من منصة غير منصة المشروع، مثلًا {"error": "This project is for iOS. Create a separate Android project in Blipit and use its key.", "reason": "platform_mismatch", "project_platform": "ios", "sent_platform": "android"}. تجيب الأحداث والجلسات والسجلات وتتبعات ومقاييس OTLP وتقارير الأخطاء وتسجيلات الجلسات وweb vitals كلها بهذه الطريقة. البيانات المرفوضة لا تُحفظ ولا تُحسب من الحصة. تسجّل حزم Blipit SDK هذا الخطأ مرة واحدة وتتوقف عن الإرسال لبقية التشغيل. للإصلاح، أنشئ مشروعًا لتلك المنصة واستخدم مفتاحه.

هل واجهتك مشكلة؟ راسل support@blipit.io. المفاتيح ومعرّف كل مشروع موجودة تحت مفاتيح API في app.blipit.io.