API リファレンス

トレース（OTLP）

エンドポイント POST /v1/traces

OpenTelemetry の SDK と Collector はここにスパンをエクスポートします。Sentry SDK は代わりにエンベロープエンドポイント経由でトランザクションを送り、同じテーブルに格納されます。

1リクエスト

X-Blipit-Key または Authorization: Bearer、公開またはシークレット。OTLP/HTTP JSON ボディは 4 MB まで、gzip、deflate、brotli 可、1リクエストあたり最大 1,000 スパン。リソースの service.name がサービス名になり、サーバースパン、コンシューマースパン、ルートスパンはトランザクションになります。説明は 1,000 文字（DB ステートメントは 2,000）で切り詰められ、256文字のタグが32個保持されます。

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 スパン超。415 は protobuf のコンテンツタイプ。401 は不明なキー。

知っておくと便利

  • 月間スパン数：Free 1M、Solo 5M、Team 20M、Scale 100M。保持は Free と Solo で7日、Team と Scale で30日。
  • gRPC と protobuf は読み取れません。プロトコルは http/json のままにしてください。

お困りですか？support@blipit.io までメールしてください。各プロジェクトのキーと正確な DSN は app.blipit.io の「APIキー」にあります。