Drains
プロジェクトのログ、Web Analytics、Web Vitals を HTTPS 転送先へ送ります。
プロジェクトの 設定 → Drains から、新しい観測イベントを任意の HTTPS エンドポイントへ転送できます。チームのオーナーと管理者が、作成・編集・停止・再開・テスト・削除を行えます。停止中を含め、1プロジェクトあたり5件まで設定できます。
Drain ごとに ログ、Web Analytics、Web Vitals を選択します。ログはアプリ、middleware、workflow の実行記録と、成功・失敗・中断したビルドの保存済みログです。Analytics は受理済みのブラウザー・サーバーイベントと既存の PostHog サマリー、Vitals は受理済みのパフォーマンス指標を転送します。
転送先を設定する
公開 DNS 名の HTTPS URL と、JSON または NDJSON を指定します。認証ヘッダーは JSON オブジェクトで入力できます。値は暗号化して保存し、取得 API や画面へ返しません。空欄は保存済みの値を維持し、{} は削除します。
配送要求が新しいログを生成して同じ Drain に戻ることを防ぐため、Arkor のプラットフォームドメイン・アプリの URL・登録済みカスタムドメインは転送先にできません。配送直前にも確認し、外部ホストが後から Arkor に登録された場合は、要求や再送を行わず失敗として記録します。
初期値は JSON、すべての環境・ソース、取得できたイベントの100%です。環境情報を持たない旧形式の server analytics は、環境を限定すると除外されます。上流で破棄・サンプリングされたイベントは復元できません。
作成時の署名用シークレットをコピーしてください。一度だけ表示され、再生成すると以前の鍵は使えなくなります。テストイベントを送信 は合成データを配送待ちにし、通常の配送とは別に結果を表示します。複数のテストが受理された場合も、それぞれ配送待ちに残りますが、画面には最新のテスト結果だけを表示します。テスト成功は受信先が要求を受理したことを示し、保存を保証するものではありません。
イベントを受信する
JSON はイベントの配列、NDJSON は1行につき1つのイベントです。各イベントは schemaVersion、id、timestamp、type、source、projectId、取得できる場合の deploymentId・environment、内容の data を持ちます。実行ログの data はアプリ・middleware・workflow の種類、ビルドログは分割の順序を示します。
Worker が Custom Context を出力した場合、実行・console・例外の記録に data.customContext が含まれます。キーと値は転送前にマスクします。Context を運ぶ内部の行は表示しません。曖昧な Context、切り詰め、安全に保持できなかった項目がある場合は、data.customContextIncomplete: true が付与されます。
取得できる場合の data.correlationId は、同じ HTTP リクエストを処理する middleware とアプリの Worker を結びます。Drains は各実行自身の Context を転送し、別の Worker の Context を待機したり、独立して届く実行間でコピーしたりしません。受信側では projectId・deploymentId・data.correlationId で記録をまとめられます。配送順や全記録の到着は保証されません。関連付けの ID は、重複排除に使うイベントの id とは異なります。
x-arkor-drain-batch-id は配送バッチの ID です。x-arkor-drain-signature は sha256=<hex> 形式で、受信した UTF-8 本文そのものと署名用シークレットから計算した HMAC-SHA256 です。定数時間の比較で検証し、保存を完了してから2xxを返してください。次の例では、JSON を解析する前の本文をそのまま検証します。
import { createHmac, timingSafeEqual } from 'node:crypto';
const body = await request.text();
const expected = Buffer.from(
`sha256=${createHmac('sha256', signingSecret).update(body, 'utf8').digest('hex')}`,
);
const received = Buffer.from(request.headers.get('x-arkor-drain-signature') ?? '');
if (expected.length !== received.length || !timingSafeEqual(expected, received)) {
return new Response(null, { status: 403 });
}
// Persist events durably before responding with a 2xx status.再送と設定変更
10秒以内に2xxを返すと成功になります。通信障害、タイムアウト、408、429、5xx は最大3回再送します。リダイレクトとその他の失敗ステータスは再送しません。Retry-After は最大1時間まで反映します。配送待ちの期限は24時間です。HTTP の同時送信は全体で5件、チームごとに1件、同じ認証アカウントが所有する全チーム・プロジェクト・Drain で1件までです。空き枠の待機では HTTP の再送回数を消費せず、元の期限も延長しません。遅い受信先は同じ所有者アカウントの他の Drain を待たせる場合があります。Queue の順序や一定時間内の配送は保証しません。
同じイベントが複数回届き、順序が変わる場合があります。バッチ ID だけでなくイベントの id で重複を排除してください。Queue が受理する前の収集はベストエフォートで、既存のサイズ上限・切り詰めを維持します。同じアカウントが所有する全チーム・全ソースで、サーバー時刻の1分ごとに分割後600メッセージ、UTF-8で30,000,000 bytes、60,000イベントの収集上限を共有します。分割した全件が収まる場合だけ Queue に投入し、超過するとサンプリング100%でも受理前にその収集単位を破棄します。保存済みビルドログは元の24時間の期限内で配送待ちを維持します。固定の分単位のため、境界をまたぐ短時間には上限の2倍まで受理し得ます。
停止・削除・設定変更・所有者変更は、配送待ちのイベントを無効にします。すでに受信先への送信を開始した要求は取り消せません。設定の保存・再開後は、その時点以降の新しいイベントから送信します。それ以前に収集したイベントや投入待ちの完了済みビルドログは破棄し、過去データを再送しません。作成・設定保存・再開と同じミリ秒の通常イベントも、順序を区別できないため破棄します。実行ログは既存デプロイへ非同期に接続し、画面には接続中・接続済み・切断中・未接続、または接続更新の失敗を表示します。解除が完了すると未接続になります。
プロジェクトを停止・削除すると実行ログの接続解除が予約されます。再開・復元すると、有効な実行ログ Drain がある場合に再接続が予約されます。定期同期により、既存 Worker へ再デプロイなしで反映します。接続の変更は非同期で、配送直前にはプロジェクトの現在の状態を再確認します。
アプリの応答速度
実行ログはアプリの実行完了後に Cloudflare Tail Worker で収集し、外部 HTTP 配送は独立した Queue Worker で行います。文書や静的アセットの配送に DB 読み取り、転送先への要求、レスポンス本文の複製を追加しません。Analytics と Vitals は collector の応答引き渡し後に有効設定を確認して Queue へ入れます。対応する有効な Drain がないプロジェクトは収集 Queue を使用しません。広く有効にする前に Cloudflare 上で Tail 接続前後の TTFB を測定してください。