API リファレンス

ログ

エンドポイント POST /api/v1/logs and POST /v1/logs

2つのエンドポイントが同じテーブルに書き込みます：Blipit 独自の JSON 形式と OpenTelemetry のログエンドポイントです。どちらもいずれのキーでも受け付け、リクエストごと、分ごと、月ごとに制限されます。

1Blipit 形式

X-Blipit-Key または Authorization: Bearer、公開またはシークレット。ボディ：JSON 配列、単一オブジェクト、または NDJSON。gzip、deflate、brotli の展開後で最大 1,000 行かつ 1 MB。行ごと：message（必須、8 KB で切り詰め。msg も可）、level（trace、debug、info、warn、error、fatal。省略時は info）、timestamp（ISO またはエポック。1日前から5分後までに丸められる）、service、environment、trace_id、attributes（フラットなオブジェクト、最大50個の文字列・数値・真偽値）。

sh
curl https://in.blipit.io/api/v1/logs \
  -H "Content-Type: application/json" -H "X-Blipit-Key: <secret key>" \
  -d '[{"level":"error","message":"payment declined","service":"api","trace_id":"4bf92f3577b34da6a3ce929d0e0e4736","attributes":{"order_id":42,"gateway":"stripe"}}]'

2レスポンス

202 {accepted: true, stored, rejected, errors}：不正な行はスキップされ、その旨が示されます。202 {accepted: false, reason: 'log quota reached'} は月の枠を使い切った場合。400 はボディが JSON でないか有効な行がない場合。413 はボディまたは行数が上限を超えた場合。401 は不明なキー。

3OTLP

同じヘッダーと OTLP/HTTP JSON で POST /v1/logs（protobuf は 415）。リソース属性 service.name と deployment.environment は service と environment になり、severity 番号は6つのレベルに対応付けられます。レスポンスは 200 {} または {partialSuccess: {rejectedLogRecords, errorMessage}} で、クォータに達した場合も同様です。

ini
OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=https://in.blipit.io/v1/logs
OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=http/json
OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-blipit-key=<secret key>

知っておくと便利

  • 月間の枠（保存バイト数）：Free 1 GB、Solo 5 GB、Team 20 GB、Scale 100 GB。保持は3、14、30、30日。
  • キーごとに1分あたり300リクエスト。イベントとスパンと共有。

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