API-referentie
Logs
Endpoint POST /api/v1/logs and POST /v1/logs
Twee endpoints schrijven naar dezelfde tabel: Blipit's eigen JSON-formaat en het OpenTelemetry-logs-endpoint. Beide accepteren beide sleutels en zijn begrensd per request, per minuut en per maand.
1Blipit-formaat
X-Blipit-Key of Authorization: Bearer, publiek of geheim. Body: een JSON-array, één object, of NDJSON; tot 1.000 regels en 1 MB nadat gzip, deflate of brotli is uitgepakt. Per regel: message (verplicht, afgekapt op 8 KB; msg wordt ook geaccepteerd), level (trace, debug, info, warn, error, fatal; ontbrekend is info), timestamp (ISO of epoch, begrensd op één dag terug en vijf minuten vooruit), service, environment, trace_id, attributes (plat object, tot 50 string-, getal- of booleanwaarden).
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"}}]'2Antwoorden
202 {accepted: true, stored, rejected, errors}: ongeldige regels worden overgeslagen en benoemd. 202 {accepted: false, reason: 'log quota reached'} zodra het maandtegoed op is. 400 als de body geen JSON is of geen enkele regel geldig is. 413 als de body of het aantal regels over de limiet gaat. 401 onbekende sleutel.
3OTLP
POST /v1/logs met dezelfde headers en OTLP/HTTP JSON (protobuf krijgt 415). De resource-attributen service.name en deployment.environment worden service en environment; severity-nummers worden afgebeeld op de zes niveaus. Antwoordt 200 {} of {partialSuccess: {rejectedLogRecords, errorMessage}}, ook wanneer het quotum is bereikt.
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>Goed om te weten
- Tegoed per maand in opgeslagen bytes: Free 1 GB, Solo 2 GB, Team 8 GB, Scale 12 GB; bewaartermijn 3, 7, 14, 14 dagen.
- 300 requests per minuut per sleutel, gedeeld met events en spans.
- 409 als de gegevens van een ander platform komen dan dat van het project, bijvoorbeeld {"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, sessies, logs, OTLP-traces en -metrics, bugmeldingen, replays en web vitals antwoorden allemaal zo. Geweigerde gegevens worden niet opgeslagen en tellen niet mee voor het quotum. De Blipit-SDK's loggen deze fout één keer en sturen de rest van de run niets meer. Los het op door een project voor dat platform aan te maken en de sleutel daarvan te gebruiken.
Kom je er niet uit? Mail support@blipit.io. Sleutels en het project-id van elk project staan onder API-sleutels in app.blipit.io.