Logs

1Formato de Blipit

X-Blipit-Key o Authorization: Bearer, pública o secreta. Cuerpo: un array JSON, un solo objeto o NDJSON; hasta 1.000 líneas y 1 MB tras descomprimir gzip, deflate o brotli. Por línea: message (obligatorio, cortado a 8 KB; msg también se acepta), level (trace, debug, info, warn, error, fatal; si falta es info), timestamp (ISO o epoch, limitado a un día atrás y cinco minutos adelante), service, environment, trace_id, attributes (objeto plano, hasta 50 valores de cadena, número 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"}}]'

2Respuestas

202 {accepted: true, stored, rejected, errors}: las líneas incorrectas se omiten y se indican. 202 {accepted: false, reason: 'log quota reached'} una vez agotada la cuota del mes. 400 cuando el cuerpo no es JSON o ninguna línea es válida. 413 cuando el cuerpo o el número de líneas supera el límite. 401 clave desconocida.

3OTLP

POST /v1/logs con las mismas cabeceras y OTLP/HTTP JSON (protobuf recibe 415). Los atributos de recurso service.name y deployment.environment se convierten en service y environment; los números de severidad se asignan a los seis niveles. Responde 200 {} o {partialSuccess: {rejectedLogRecords, errorMessage}}, también cuando se alcanza la cuota.

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>

Conviene saber

• Cuota mensual por bytes almacenados: Free 1 GB, Solo 5 GB, Team 20 GB, Scale 100 GB; retención 3, 14, 30, 30 días.
• 300 peticiones por minuto y clave, compartidas con eventos y spans.