ログドレイン

ログドレインは、サービスの実行時ログを書き込まれたそばから自分のログツールに転送します：Datadog、Grafana Loki（Grafana Cloud を含む）、または任意の HTTPS エンドポイント。ログドレインは Pro 以上のプランに含まれます。

ドレインを追加する

チームのオーナーと管理者は、Account settings → Log Drains（サイドバーで選んだチームが対象）を開き、Add log drain をクリックします。

ドレイン	必要なもの
Datadog	API キー（Datadog の Organization Settings → API Keys）と、アカウントのサイト（`datadoghq.com` や `datadoghq.eu` など）。
Loki	push の URL（例：`https://logs-prod-012.grafana.net/loki/api/v1/push`。パスのない URL には `/loki/api/v1/push` が付きます）。Grafana Cloud では、ユーザー（スタックの数値 ID）と `logs:write` 権限のトークン。マルチテナントの Loki のテナントは `X-Scope-OrgID` で送ります。
HTTP	任意の `https://` URL。Zenavo は署名付きの JSON を POST します（後述）。

All projects, including new ones か、一部のプロジェクトだけを選びます。Test はすぐに 1 行送り、届いたかどうかを表示します。チームあたり最大 5 個のドレインを作れます。

URL、API キー、パスワードはシークレットです。暗号化して保存され、コンソールには送信先のホストとパスしか表示されません。Zenavo はアドレスがすべてパブリックなホストにだけ送信し、リダイレクトには従いません。ドレインの追加、変更、テスト、削除は監査ログに記録されます。

送られるもの

動いているサービスが出力する全行です。他と同じく変数の値は伏せ字（[REDACTED]）になり、チーム、プロジェクト、サービスのラベルが付きます。ビルドログは転送されません。

ドレイン	形式
Datadog	`https://http-intake.logs.<site>/api/v2/logs` に送信。`ddsource: zenavo`、`service` はサービス名、`hostname` はプロジェクト名、タグは `project`、`project_id`、`service_id`、`team_id`。
Loki	サービスごとに 1 ストリーム。ラベルは `source="zenavo"`、`project`、`project_id`、`service`、`service_id`、`team_id`。
HTTP	下記の JSON。

行は最大 500 行ずつ、または 2 秒ごとにまとめて送られます。失敗したバッチは 1、5、15 秒後に再試行します。ドレインが拒否したリクエスト（API キーの誤りなど、408 と 429 以外の 4xx 応答）は再試行しません。それでも失敗したバッチは破棄されます。各ドレインは最大 10,000 行をバッファーし、追いつかない場合は新しい行から破棄します。コンソールには、各ドレインの最後の配信結果か失敗理由と、破棄した行数が表示されます。コンソールのログ（ライブも保存済みも）がドレインの影響を受けることはありません。

配信は at-least-once です。コントロールプレーンが再起動すると、直前の数分が再送されることがあります。

HTTP のペイロード

json

{
  "logs": [
    {
      "time": "2026-10-22T08:00:00.123456789Z",
      "message": "GET /cart 200 12ms",
      "team_id": "team_…",
      "project_id": "proj_…",
      "project": "shop",
      "service_id": "svc-…",
      "service": "web"
    }
  ]
}

2xx の応答なら配信済みとみなします。各リクエストには X-Zenavo-Timestamp（Unix 秒）と X-Zenavo-Signature: v1=<hex> が付きます。後者はドレインの署名シークレットで <timestamp>.<生のボディ> を HMAC-SHA256 したもので、通知の Webhook と同じ方式です。シークレット（whsec_…）はドレインの追加時に一度だけ表示されます。New secret で入れ替えると、新しいものが一度だけ表示されます。

プラン

ログドレインには Pro、Team、Enterprise のいずれかのプランが必要です。それを含まないプランに変わると、ドレインの転送は止まります。ドレインのオフ、編集、削除は引き続きでき、アップグレードすると再開します。

ログドレイン ​

ドレインを追加する ​

送られるもの ​

HTTP のペイロード ​

プラン ​

ログドレイン

ドレインを追加する

送られるもの

HTTP のペイロード

プラン