Traces (OTLP)

Endpoint POST /v1/traces

Los SDKs y Collectors de OpenTelemetry exportan spans aquí, y los SDKs de Blipit también envían sus spans aquí.

1Petición

X-Blipit-Key o Authorization: Bearer, pública o secreta. Cuerpo OTLP/HTTP JSON de hasta 4 MB, se acepta gzip, deflate o brotli, como máximo 1.000 spans por petición. service.name del recurso da nombre al servicio; los spans de servidor y consumidor y los raíz se convierten en transacciones. Las descripciones se cortan a 1.000 caracteres (sentencias db 2.000); se conservan 32 etiquetas de 256 caracteres cada una.

ini
OTEL_EXPORTER_OTLP_ENDPOINT=https://in.blipit.io
OTEL_EXPORTER_OTLP_PROTOCOL=http/json
OTEL_EXPORTER_OTLP_HEADERS=x-blipit-key=<public key>
OTEL_SERVICE_NAME=shop-api

2Respuestas

200 {accepted: true, spans: n}. 202 {accepted: false, reason: 'monthly span allowance used up'}. 400 JSON ilegible. 413 más de 1.000 spans. 415 tipo de contenido protobuf. 401 clave desconocida.

Conviene saber

  • Spans al mes: Free 1M, Solo 2M, Team 10M, Scale 20M; se conservan 7 días en Free y Solo, 14 en Team y Scale.
  • gRPC y protobuf no se leen; mantén el protocolo en http/json.
  • 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.