Logs

1Blipit-Format

X-Blipit-Key oder Authorization: Bearer, öffentlich oder geheim. Body: ein JSON-Array, ein einzelnes Objekt oder NDJSON; bis 1.000 Zeilen und 1 MB nach dem Entpacken von gzip, deflate oder brotli. Pro Zeile: message (erforderlich, bei 8 KB abgeschnitten; msg wird auch akzeptiert), level (trace, debug, info, warn, error, fatal; fehlend ist info), timestamp (ISO oder Epoch, begrenzt auf einen Tag zurück und fünf Minuten voraus), service, environment, trace_id, attributes (flaches Objekt, bis 50 String-, Zahl- oder Boolean-Werte).

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

2Antworten

202 {accepted: true, stored, rejected, errors}: Fehlerhafte Zeilen werden übersprungen und benannt. 202 {accepted: false, reason: 'log quota reached'}, sobald das Monatskontingent aufgebraucht ist. 400, wenn der Body kein JSON ist oder keine Zeile gültig ist. 413, wenn Body oder Zeilenanzahl über dem Limit liegen. 401 unbekannter Schlüssel.

3OTLP

POST /v1/logs mit denselben Headern und OTLP/HTTP JSON (Protobuf erhält 415). Die Resource-Attribute service.name und deployment.environment werden zu service und environment; Severity-Nummern werden auf die sechs Level abgebildet. Antwortet 200 {} oder {partialSuccess: {rejectedLogRecords, errorMessage}}, auch wenn das Kontingent erreicht ist.

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>

Gut zu wissen

• Kontingent pro Monat nach gespeicherten Bytes: Free 1 GB, Solo 5 GB, Team 20 GB, Scale 100 GB; Aufbewahrung 3, 14, 30, 30 Tage.
• 300 Requests pro Minute und Schlüssel, geteilt mit Events und Spans.