Riferimento API
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.
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-api2Risposte
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.