API-Referenz
Logs
Endpoint POST /api/v1/logs and POST /v1/logs
Zwei Endpoints schreiben in dieselbe Tabelle: das eigene JSON-Format von Blipit und der OpenTelemetry-Logs-Endpoint. Beide akzeptieren beide Schlüssel und sind pro Request, pro Minute und pro Monat begrenzt.
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 2 GB, Team 8 GB, Scale 12 GB; Aufbewahrung 3, 7, 14, 14 Tage.
- 300 Requests pro Minute und Schlüssel, geteilt mit Events und Spans.
- 409, wenn die Daten von einer anderen Plattform kommen als der des Projekts, zum Beispiel {"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"}. Events, Sessions, Logs, OTLP-Traces und -Metriken, Fehlerberichte, Replays und Web Vitals antworten alle so. Abgelehnte Daten werden nicht gespeichert und nicht auf das Kontingent angerechnet. Die Blipit-SDKs schreiben diesen Fehler einmal ins Log und senden für den Rest der Laufzeit nichts mehr. Zur Behebung ein Projekt für diese Plattform anlegen und dessen Schlüssel verwenden.
Kommen Sie nicht weiter? Schreiben Sie an support@blipit.io. Schlüssel und die Projekt-ID jedes Projekts finden Sie unter API-Schlüssel in app.blipit.io.