Traces (OTLP)

Endpoint POST /v1/traces

Les SDK et Collectors OpenTelemetry exportent leurs spans ici, et les SDK Blipit y envoient aussi les leurs.

1Requête

X-Blipit-Key ou Authorization: Bearer, publique ou secrète. Corps JSON OTLP/HTTP jusqu'à 4 Mo, gzip, deflate ou brotli acceptés, au plus 1 000 spans par requête. service.name de la ressource nomme le service ; les spans server et consumer et les racines deviennent des transactions. Les descriptions sont coupées à 1 000 caractères (instructions db 2 000) ; 32 tags de 256 caractères chacun sont conservés.

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

2Réponses

200 {accepted: true, spans: n}. 202 {accepted: false, reason: 'monthly span allowance used up'}. 400 JSON illisible. 413 plus de 1 000 spans. 415 type de contenu protobuf. 401 clé inconnue.

Bon à savoir

  • Spans par mois : Free 1 M, Solo 2 M, Team 10 M, Scale 20 M ; conservés 7 jours sur Free et Solo, 14 sur Team et Scale.
  • gRPC et protobuf ne sont pas lus ; gardez le protocole sur http/json.
  • 409 quand les données viennent d'une autre plateforme que celle du projet, par exemple {"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"}. Les événements, sessions, logs, traces et métriques OTLP, rapports de bug, replays et web vitals répondent tous ainsi. Les données refusées ne sont pas enregistrées et ne comptent pas dans le quota. Les SDK Blipit écrivent cette erreur une fois dans les logs et n'envoient plus rien pendant le reste de l'exécution. Pour corriger, créez un projet pour cette plateforme et utilisez sa clé.

Bloqué ? Écrivez à support@blipit.io. Les clés et l'identifiant de chaque projet sont sous Clés API dans app.blipit.io.