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 5 GB, Team 20 GB, Scale 100 GB; conservazione 3, 14, 30, 30 giorni.
- 300 richieste al minuto per chiave, condivise con eventi e span.
Bloccato? Scrivi a support@blipit.io. Le chiavi e il DSN esatto di ogni progetto sono sotto Chiavi API in app.blipit.io.

