Trace(OTLP)

Endpoint POST /v1/traces

OpenTelemetry SDK 和 Collector 将 span 导出到这里,Blipit SDK 也把它们的 span 发送到这里。

1请求

X-Blipit-Key 或 Authorization: Bearer,公钥或私密密钥。OTLP/HTTP JSON 请求体最大 4 MB,接受 gzip、deflate 或 brotli,每个请求最多 1,000 个 span。资源中的 service.name 用于命名服务;服务端和消费者 span 以及根 span 变为事务。描述截断至 1,000 个字符(数据库语句 2,000 个);保留 32 个各 256 字符的标签。

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

2响应

200 {accepted: true, spans: n}。202 {accepted: false, reason: 'monthly span allowance used up'}。400 无法读取的 JSON。413 超过 1,000 个 span。415 protobuf 内容类型。401 未知密钥。

须知

  • 每月 span 数:Free 100 万,Solo 200 万,Team 1000 万,Scale 2000 万;Free 和 Solo 保留 7 天,Team 和 Scale 保留 14 天。
  • 不读取 gRPC 和 protobuf;请将协议保持为 http/json。
  • 当数据来自与项目不同的平台时返回 409,例如 {"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"}。事件、会话、日志、OTLP 追踪和指标、错误报告、回放和 Web Vitals 都会这样应答。被拒绝的数据不会保存,也不计入配额。Blipit SDK 会记录一次这个错误,并在本次运行的剩余时间内停止发送。解决方法:为该平台创建一个项目并使用它的密钥。

遇到问题?发邮件至 support@blipit.io。每个项目的密钥和项目 id 在 app.blipit.io 的“API 密钥”下。