Referencia de la API
Logs
Endpoint POST /api/v1/logs and POST /v1/logs
Dos endpoints escriben en la misma tabla: el formato JSON propio de Blipit y el endpoint de logs de OpenTelemetry. Ambos aceptan cualquiera de las claves y tienen límites por petición, por minuto y por mes.
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 2 GB, Team 8 GB, Scale 12 GB; retención 3, 7, 14, 14 días.
- 300 peticiones por minuto y clave, compartidas con eventos y spans.
- 409 cuando los datos vienen de una plataforma distinta a la del proyecto, por ejemplo {"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"}. Eventos, sesiones, logs, trazas y métricas OTLP, informes de errores, replays y web vitals responden igual. Los datos rechazados no se guardan ni cuentan para la cuota. Los SDK de Blipit registran este error una vez y dejan de enviar durante el resto de la ejecución. Para solucionarlo, crea un proyecto para esa plataforma y usa su clave.
¿Atascado? Escribe a support@blipit.io. Las claves y el id de cada proyecto están en Claves API en app.blipit.io.