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).

sh
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.

ini
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 5 GB, Team 20 GB, Scale 100 GB; bewaartermijn 3, 14, 30, 30 dagen.
  • 300 requests per minuut per sleutel, gedeeld met events en spans.

Kom je er niet uit? Mail support@blipit.io. Sleutels en de exacte DSN van elk project staan onder API-sleutels in app.blipit.io.