السجلات

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 قيمة نصية أو رقمية أو منطقية).

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}}، وكذلك عند بلوغ الحصة.

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 ‏5 غيغابايت، Team ‏20 غيغابايت، Scale ‏100 غيغابايت؛ الاحتفاظ 3 و14 و30 و30 يومًا.
• 300 طلب في الدقيقة لكل مفتاح، مشتركة مع الأحداث والنطاقات.