# getAuditLog

감사 기록을 배열로 읽습니다. 종류·순번·시간 필터로 필요한 범위만 조회할 수 있고 기록이 꺼져 있으면 빈 배열입니다.

Canonical: https://grid.syidax.com/ko/docs/methods/getAuditLog/

<a id="meaning"></a>

## 무엇을 하는 API인가요

감사 기록을 배열로 읽습니다. 종류·순번·시간 필터로 필요한 범위만 조회할 수 있고 기록이 꺼져 있으면 빈 배열입니다.

<a id="contract"></a>

## 입력과 결과의 정확한 타입

```typescript
getAuditLog(filter?: AuditLogFilter): Promise<AuditEntry[]>
```

| 인수 | 필수 여부 | 타입 |
| --- | --- | --- |
| filter | 선택 | AuditLogFilter |

반환 타입은 `Promise<AuditEntry[]>`입니다.

<a id="usage"></a>

## 사용 흐름

등록과 초기화를 마친 Grid 요소에서 grid.getAuditLog(…)를 호출합니다. 반환값은 await로 읽으세요. boolean이나 보고서를 반환하는 메서드는 결과를 확인한 뒤 다음 작업을 진행합니다.

<a id="types"></a>

## 관련 타입 읽기

- [AuditLogFilter](https://grid.syidax.com/ko/docs/types/AuditLogFilter.md)
- [AuditEntry](https://grid.syidax.com/ko/docs/types/AuditEntry.md)

<a id="recipes"></a>

## 기능별 설명과 예제

- [변경 이력 조회](https://grid.syidax.com/ko/docs/features/audit-log.md) — 감사 로그는 행·셀·선택 변경과 실행 취소·다시 실행 전이를 추적합니다. 현재 표의 값만으로 알 수 없는 변경 흐름을 확인하는 데 사용합니다.