감사 로그¶
감사 로그 페이지는 /connector-audit 경로에 해당합니다.
이 페이지는 애플리케이션이 기록한 커넥터 작업을 나열하고, 각 항목의 세부 내용을 확인하게 해줍니다.
페이지가 보여주는 내용¶
connector, capability, agent run id, 또는 since/until 시간 범위로 항목을 필터링하고, 최신순 또는 오래된순으로 정렬할 수 있습니다. 목록은 추가 항목을 페이지 단위로 불러옵니다. Clear 버튼은 agent run id 필터와 두 시간 필터를 초기화하지만, connector와 capability 필터는 그대로 둡니다.
각 감사 항목에는 다음 정보가 포함될 수 있습니다.
- 커넥터 이름
- operation id
- 실행 시각
- read, write, destructive 같은 capability 수준
- 존재할 경우 agent run id 또는 approval id
- rollback 또는 undo verdict
세부 드로어¶
항목을 클릭하면 세부 드로어가 열립니다.
드로어에는 다음 정보가 표시됩니다.
- entry id와 capability 같은 identity 필드
- 마스킹된 파라미터 또는 일반 파라미터
- undo state 세부 정보
- rollback verdict 세부 정보
undo가 가능한 항목은 drawer에서 undo 작업을 실행할 수 있습니다. 요청이 성공하면 감사 상태를 새로 고치며, 거부되면 기록된 실패 유형을 표시합니다.
agent run id가 있는 항목에는 drawer에 "Filter by this run" 버튼도 표시됩니다. 이 버튼을 클릭하면 run id 필터가 해당 항목의 run으로 설정되고 drawer가 닫히며, 그 run이 다룬 모든 항목으로 범위가 좁혀진 목록으로 돌아갑니다.
항목 내보내기¶
페이지 상단의 Export CSV와 Export JSON 버튼을 사용하면 현재 화면에 로드된 항목뿐 아니라 현재 필터에 일치하는 모든 항목을 다운로드할 수 있습니다. 필터링된 목록이 비어 있으면 두 버튼 모두 비활성화됩니다.
내보내기는 connector, capability, agent run id, 시간 범위 필터를 적용하지만 최신순/오래된순 정렬 옵션은 적용하지 않습니다. 내보낸 항목은 항상 기록된 순서, 즉 오래된순으로 정렬됩니다.
JSON 내보내기에는 전체 entry 레코드가 포함됩니다. CSV 내보내기는 다음 컬럼으로 구성된 축약된 요약입니다: id, occurredAt, connectorName, operationId, capability, agentRunId, approvalId, correlationId, outcome, verdict. 파라미터, undo state, 마스킹 메타데이터는 JSON 내보내기에서만 확인할 수 있습니다.
한 번의 내보내기는 최대 25,000개 항목까지 처리합니다. 필터에 일치하는 항목이 이보다 많으면 일부만 담긴 파일을 내려받는 대신, 범위를 좁혀 달라는 메시지와 함께 내보내기가 실패합니다. 일부 항목이 조용히 빠진 감사 내보내기는 아예 실패한 내보내기보다 위험하기 때문입니다. connector, capability, agent run id, 시간 범위 필터로 범위를 줄인 뒤 다시 시도하세요. 기본 retention 정책은 10,000개 항목을 보관하므로, 이 제한은 retention을 늘렸거나 preserve된 항목이 많은 설치 환경에서만 발생합니다.
다운로드되는 파일 이름은 connector-audit-export-<timestamp>.csv 또는 .json입니다. 내보낸 감사 데이터는 애플리케이션의 마스킹 경계를 벗어나므로, 감사 로그 자체와 동일한 주의로 다뤄야 합니다.
이 페이지가 중요한 이유¶
감사 로그는 다음 상황에서 유용합니다.
- 커넥터가 실제로 어떤 작업을 했는지 검토할 때
- 어떤 작업이 되돌릴 수 있는지 확인할 때
- 승인과 연결된 활동을 추적할 때
- 원시 로그를 바로 열기 전에 커넥터 워크플로우를 디버깅할 때