API 参考

Trace（OTLP）

Endpoint POST /v1/traces

OpenTelemetry SDK 和 Collector 将 span 导出到这里。Sentry SDK 则通过 envelope endpoint 发送事务，最终进入同一张表。

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 500 万，Team 2000 万，Scale 1 亿；Free 和 Solo 保留 7 天，Team 和 Scale 保留 30 天。
不读取 gRPC 和 protobuf；请将协议保持为 http/json。

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