> Source: https://clickhouse.github.io/loom/ko/reference/operations/audit/ (Markdown: https://clickhouse.github.io/loom/ko/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>`입니다. 신원 필드(`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)에서는 네임스페이스와 에이전트도 채워집니다. 자세한 내용은 [신원과 네임스페이스](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md)를 참고하세요. [연산 색인](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)에서 역할, 종류, MCP `all` 목록을 설명합니다. 알 수 없는 입력 필드도 처리되며 `ignored_args`에 이름이 표시됩니다.

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

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

## `audit.list`

감사 로그를 조회합니다(행별 해시로 변조를 감지할 수 있음).

`POST /v1/audit.list` · MCP `loom_audit_list` · 역할 `viewer` · 읽기 · MCP `all` 툴셋에는 나열되지 않음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(신원 튜플의 첫 번째 요소). |
| `namespace` | `str \| None` | `None` | None: 호출자가 읽을 수 있는 모든 네임스페이스. 읽을 수 없는 네임스페이스를 지정하면 빈 페이지가 반환됩니다. |
| `event_type` | `str \| None` | `None` | 정확히 일치 |
| `since` | `datetime \| None` | `None` | ts >= since인 행만 |
| `limit` | `int` | `50` | 페이지당 최대 이 개수의 행을 최신순으로 반환합니다. 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 -->
