Riferimento API
Log
Endpoint POST /api/v1/logs and POST /v1/logs
Due endpoint scrivono nella stessa tabella: il formato JSON di Blipit e l'endpoint dei log OpenTelemetry. Entrambi accettano entrambe le chiavi e sono limitati per richiesta, al minuto e al mese.
1Formato Blipit
X-Blipit-Key o Authorization: Bearer, pubblica o segreta. Corpo: un array JSON, un singolo oggetto, o NDJSON; fino a 1.000 righe e 1 MB dopo la decompressione gzip, deflate o brotli. Per riga: message (obbligatorio, tagliato a 8 KB; anche msg è accettato), level (trace, debug, info, warn, error, fatal; se manca è info), timestamp (ISO o epoch, limitato a un giorno indietro e cinque minuti avanti), service, environment, trace_id, attributes (oggetto piatto, fino a 50 valori stringa, numero o booleano).
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"}}]'2Risposte
202 {accepted: true, stored, rejected, errors}: le righe non valide vengono saltate e indicate. 202 {accepted: false, reason: 'log quota reached'} una volta esaurita la quota del mese. 400 quando il corpo non è JSON o nessuna riga è valida. 413 quando il corpo o il numero di righe supera il limite. 401 chiave sconosciuta.
3OTLP
POST /v1/logs con gli stessi header e OTLP/HTTP JSON (protobuf riceve 415). Gli attributi resource service.name e deployment.environment diventano service ed environment; i numeri di severità vengono mappati sui sei livelli. Risponde 200 {} oppure {partialSuccess: {rejectedLogRecords, errorMessage}}, anche quando la quota è raggiunta.
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>Buono a sapersi
- Quota mensile per byte salvati: Free 1 GB, Solo 2 GB, Team 8 GB, Scale 12 GB; conservazione 3, 7, 14, 14 giorni.
- 300 richieste al minuto per chiave, condivise con eventi e span.
- 409 quando i dati arrivano da una piattaforma diversa da quella del progetto, per esempio {"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"}. Eventi, sessioni, log, trace e metriche OTLP, segnalazioni di bug, replay e web vitals rispondono tutti così. I dati rifiutati non vengono salvati e non contano nella quota. Gli SDK di Blipit registrano questo errore una volta e smettono di inviare per il resto dell'esecuzione. Per risolvere, crea un progetto per quella piattaforma e usa la sua chiave.
Bloccato? Scrivi a support@blipit.io. Le chiavi e l'id di ogni progetto sono sotto Chiavi API in app.blipit.io.