السجلات

نقطة النهاية POST /api/v1/logs and POST /v1/logs

تكتب نقطتا نهاية في الجدول نفسه: صيغة JSON الخاصة بـ Blipit ونقطة نهاية سجلات OpenTelemetry. تقبل كلتاهما أي المفتاحين ومحدودتان لكل طلب ولكل دقيقة ولكل شهر.

1صيغة Blipit

X-Blipit-Key أو Authorization: Bearer، عام أو سري. الجسم: مصفوفة JSON، أو كائن واحد، أو NDJSON؛ حتى 1,000 سطر و1 ميغابايت بعد فك gzip أو deflate أو brotli. لكل سطر: message (مطلوب، يُقطع عند 8 كيلوبايت؛ يُقبل msg أيضًا)، وlevel ‏(trace أو debug أو info أو warn أو error أو fatal؛ الغائب يُعد info)، وtimestamp ‏(ISO أو epoch، محصور بيوم للخلف وخمس دقائق للأمام)، وservice، وenvironment، وtrace_id، وattributes (كائن مسطّح، حتى 50 قيمة نصية أو رقمية أو منطقية).

sh
curl https://in.blipit.io/api/v1/logs \
  -H "Content-Type: application/json" -H "X-Blipit-Key: <secret key>" \
  -d '[{"level":"error","message":"payment declined","service":"api","trace_id":"4bf92f3577b34da6a3ce929d0e0e4736","attributes":{"order_id":42,"gateway":"stripe"}}]'

2الاستجابات

202 {accepted: true, stored, rejected, errors}: تُتخطى الأسطر غير الصالحة وتُذكر. 202 {accepted: false, reason: 'log quota reached'} بمجرد استنفاد حصة الشهر. 400 عندما لا يكون الجسم JSON أو لا يوجد سطر صالح. 413 عندما يتجاوز الجسم أو عدد الأسطر الحد. 401 مفتاح مجهول.

3OTLP

POST /v1/logs بالترويسات نفسها وOTLP/HTTP JSON (يحصل protobuf على 415). تصبح سمات المورد service.name وdeployment.environment هي service وenvironment؛ وتُربط أرقام الخطورة بالمستويات الستة. يجيب بـ 200 {} أو {partialSuccess: {rejectedLogRecords, errorMessage}}، وكذلك عند بلوغ الحصة.

ini
OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=https://in.blipit.io/v1/logs
OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=http/json
OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-blipit-key=<secret key>

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

  • الحصة شهريًا بالبايتات المخزّنة: Free ‏1 غيغابايت، Solo ‏2 غيغابايت، Team ‏8 غيغابايت، Scale ‏12 غيغابايت؛ الاحتفاظ 3 و7 و14 و14 يومًا.
  • 300 طلب في الدقيقة لكل مفتاح، مشتركة مع الأحداث والنطاقات.
  • 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.