トレース(OTLP)

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

OpenTelemetry の SDK と Collector はここにスパンをエクスポートし、Blipit 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 2M、Team 10M、Scale 20M。保持は 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キー」にあります。