Trace (OTLP)

Endpoint POST /v1/traces

SDK e Collector OpenTelemetry esportano qui gli span, e anche gli SDK Blipit inviano qui i loro span.

1Richiesta

X-Blipit-Key o Authorization: Bearer, pubblica o segreta. Corpo OTLP/HTTP JSON fino a 4 MB, gzip, deflate o brotli accettati, al massimo 1.000 span per richiesta. service.name dalla resource dà il nome al servizio; gli span server e consumer e le radici diventano transazioni. Le descrizioni sono tagliate a 1.000 caratteri (istruzioni db 2.000); vengono conservati 32 tag di 256 caratteri ciascuno.

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

2Risposte

200 {accepted: true, spans: n}. 202 {accepted: false, reason: 'monthly span allowance used up'}. 400 JSON illeggibile. 413 più di 1.000 span. 415 content type protobuf. 401 chiave sconosciuta.

Buono a sapersi

  • Span al mese: Free 1M, Solo 2M, Team 10M, Scale 20M; conservati 7 giorni su Free e Solo, 14 su Team e Scale.
  • gRPC e protobuf non vengono letti; mantieni il protocollo su http/json.
  • 409 quando i dati arrivano da una piattaforma diversa da quella del progetto, per esempio {"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"}. Eventi, sessioni, log, trace e metriche OTLP, segnalazioni di bug, replay e web vitals rispondono tutti così. I dati rifiutati non vengono salvati e non contano nella quota. Gli SDK di Blipit registrano questo errore una volta e smettono di inviare per il resto dell'esecuzione. Per risolvere, crea un progetto per quella piattaforma e usa la sua chiave.

Bloccato? Scrivi a support@blipit.io. Le chiavi e l'id di ogni progetto sono sotto Chiavi API in app.blipit.io.