Loglar

Endpoint POST /api/v1/logs and POST /v1/logs

İki endpoint aynı tabloya yazar: Blipit'in kendi JSON formatı ve OpenTelemetry logs endpoint'i. İkisi de her iki anahtarı kabul eder ve istek, dakika ve ay başına sınırlıdır.

1Blipit formatı

X-Blipit-Key ya da Authorization: Bearer, public ya da secret. Gövde: bir JSON dizisi, tek bir nesne ya da NDJSON; gzip, deflate ya da brotli açıldıktan sonra en fazla 1.000 satır ve 1 MB. Satır başına: message (zorunlu, 8 KB'ta kesilir; msg de kabul edilir), level (trace, debug, info, warn, error, fatal; eksikse info), timestamp (ISO ya da epoch, bir gün geriye ve beş dakika ileriye sınırlanır), service, environment, trace_id, attributes (düz nesne, en fazla 50 string, sayı ya da boolean değer).

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"}}]'

2Yanıtlar

202 {accepted: true, stored, rejected, errors}: hatalı satırlar atlanır ve belirtilir. 202 {accepted: false, reason: 'log quota reached'} ayın kotası dolduğunda. 400 gövde JSON değilse ya da hiçbir satır geçerli değilse. 413 gövde ya da satır sayısı limitin üzerindeyse. 401 bilinmeyen anahtar.

3OTLP

Aynı başlıklarla ve OTLP/HTTP JSON ile POST /v1/logs (protobuf 415 alır). service.name ve deployment.environment kaynak öznitelikleri service ve environment olur; severity numaraları altı seviyeye eşlenir. 200 {} ya da {partialSuccess: {rejectedLogRecords, errorMessage}} yanıtı verir; kota dolduğunda da.

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>

Bilmekte fayda var

  • Saklanan byte'a göre aylık kota: Free 1 GB, Solo 2 GB, Team 8 GB, Scale 12 GB; saklama 3, 7, 14, 14 gün.
  • Anahtar başına dakikada 300 istek; olaylar ve span'lerle paylaşılır.
  • Veriler projenin platformundan farklı bir platformdan geldiğinde 409 döner, örneğin {"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"}. Olaylar, oturumlar, loglar, OTLP iz ve metrikleri, hata raporları, replay'ler ve web vitals aynı şekilde yanıt verir. Reddedilen veriler saklanmaz ve kotaya sayılmaz. Blipit SDK'ları bu hatayı bir kez loglar ve çalışmanın geri kalanında göndermeyi durdurur. Çözmek için o platform için bir proje oluşturun ve onun anahtarını kullanın.

Takıldınız mı? support@blipit.io adresine e-posta gönderin. Her projenin anahtarları ve proje id'si app.blipit.io içindeki API anahtarları altındadır.