Referência da API
Traces (OTLP)
Endpoint POST /v1/traces
SDKs e Collectors do OpenTelemetry exportam spans para cá, e os SDKs do Blipit também enviam seus spans para cá.
1Requisição
X-Blipit-Key ou Authorization: Bearer, pública ou secreta. Corpo OTLP/HTTP JSON de até 4 MB, gzip, deflate ou brotli aceitos, no máximo 1.000 spans por requisição. service.name do resource nomeia o serviço; spans de servidor e consumidor e raízes viram transações. As descrições são cortadas em 1.000 caracteres (instruções de banco de dados em 2.000); 32 tags de 256 caracteres cada são mantidas.
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-api2Respostas
200 {accepted: true, spans: n}. 202 {accepted: false, reason: 'monthly span allowance used up'}. 400 JSON ilegível. 413 mais de 1.000 spans. 415 content type protobuf. 401 chave desconhecida.
Bom saber
- Spans por mês: Free 1M, Solo 2M, Team 10M, Scale 20M; mantidos 7 dias no Free e no Solo, 14 no Team e no Scale.
- gRPC e protobuf não são lidos; mantenha o protocolo em http/json.
- 409 quando os dados vêm de uma plataforma diferente da do projeto, por exemplo {"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, sessões, logs, traces e métricas OTLP, relatórios de erros, replays e web vitals respondem todos assim. Os dados recusados não são guardados nem contam para a quota. Os SDKs do Blipit registam este erro uma vez e deixam de enviar durante o resto da execução. Para resolver, crie um projeto para essa plataforma e use a chave dele.
Travou? Envie um e-mail para support@blipit.io. As chaves e o id de cada projeto ficam em Chaves de API no app.blipit.io.