> Source: https://clickhouse.github.io/loom/ja/reference/operations/audit/ (Markdown: https://clickhouse.github.io/loom/ja/reference/operations/audit.md)

<!-- i18n: source=docs/reference/operations/audit.md blob=3784ae0eeadc2b668a2bddeec8f9dc890a7690f1 model=claude-sonnet-5-5 -->
> このページは[英語の原文](https://clickhouse.github.io/loom/reference/operations/audit/)の機械翻訳です。内容は英語の原文が優先されます。
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/audit/), which is authoritative.

<a id="audit-operations"></a>

# `audit` オペレーション

各 `audit.*` オペレーションが受け取るフィールドと返すフィールドの正確な一覧です。

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

すべての op は HTTP の `POST /v1/<op>` と MCP ツール `loom_<op>` で呼び出せます。ID フィールド（`org`、`namespace`、`agent`、`user_id`、`session_id`）は、トランスポートが対応している場合にトークンと MCP セッションから補完されます。シングルユーザーのサーバーでトークンなしに HTTP で呼び出した場合は、`code.*` と `tracker.*`（それぞれのプレーンの値を保持します）を除くすべての op でインストールの org が使われ、[一部の op](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) では名前空間とエージェントも補完されます。詳しくは [ID と名前空間](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md) を参照してください。ロール、種別、MCP の `all` 一覧については [オペレーション一覧](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md) で説明しています。未知の入力フィールドは受け付けられ、`ignored_args` に名前が示されます。

<!-- prettier-ignore-start -->

<a id="auditlist"></a>

## `audit.list`

監査ログ（行ごとのハッシュによる改ざん検知付き）を照会します。

`POST /v1/audit.list` · MCP `loom_audit_list` · ロール `viewer` · 読み取り · MCP の `all` ツールセットには含まれません

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（ID タプルの最初の要素）。 |
| `namespace` | `str \| None` | `None` | None の場合は、呼び出し元が読み取れるすべての名前空間が対象です。読み取れない名前空間を指定すると、空のページが返ります。 |
| `event_type` | `str \| None` | `None` | 完全一致 |
| `since` | `datetime \| None` | `None` | ts >= since の行のみ |
| `limit` | `int` | `50` | 1 ページあたりの最大行数（新しい順）。1 から 500 まで。 |
| `cursor` | `str \| None` | `None` | 前のページから得た不透明なトークン |
| `fields` | `list[str] \| None` | `None` | 呼び出し元が読み取る出力フィールド（行モデルに対して解決されるホワイトリスト。未知の名前は 422 になります）。未指定の場合はすべてのフィールドです。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `rows` | `list[AuditListRow]` | 監査行のページ（新しい順。同時刻のものは `request_id` で順序付けされます）。 |
| `next_cursor` | `str \| None` | 次の（より古い）ページを取得するには、これを `cursor` として渡します。このページが最後の場合は None です。 |

<!-- prettier-ignore-end -->
