감사 추적

항목에 담기는 내용

항목에는 행위자의 종류와 id(팀원, 서비스 또는 여러분의 사용자), 작업, 대상 리소스, 커밋된 시각, 변경을 일으킨 요청의 id가 기록됩니다. 변경이 일어났다는 사실을 기록하며, 변경 전후의 값은 담지 않습니다.

변경과 함께 기록

각 항목은 설명하는 변경과 같은 데이터베이스 트랜잭션에서 기록되므로 둘 중 하나만 존재할 수 없습니다. 자체 이벤트를 내보내지 않는 변경도 호출된 작업의 이름으로 항목이 남습니다.

콘솔에서 읽기

감사 로그 화면은 액세스 아래에 있으며 작업, 리소스 유형, 리소스 id, 행위자, 날짜 범위로 필터링할 수 있습니다. 읽으려면 audit:read 권한이 필요합니다. 기본 제공되는 두 역할 중 Workspace administrator는 이 권한이 있고 Project administrator는 없습니다.

추적 기록은 프로젝트의 이벤트와 구성원 추가 및 제거 같은 워크스페이스 자체의 이벤트를 포함합니다. 특정 조직 안에서 보면 해당 조직과 그 아래 조직이 표시됩니다.

확인할 수 있는 항목

해지된 API 키와 레코드 소유자 변경이 기록됩니다. 비밀번호 해시가 포함된 내보내기와 AI 어시스턴트가 한 변경도 기록되며, 어시스턴트의 변경은 대신 행동한 사람에게 귀속됩니다. 모든 지원 액세스 요청, 승인, 거부도 여기에 있습니다.

90일 보관

추적 기록의 바탕인 이벤트 로그는 모든 요금제에서 90일 구간을 제공합니다. 프로젝트의 더 긴 이력이 필요하면 Event Log API로 로그를 앞으로 읽어 가야 하며, 이때 시크릿 키에는 events:list.project 스코프가 있어야 하고, 로그는 직접 저장해야 합니다. 90일보다 오래된 커서는 재개할 위치를 알려 주는 오류와 함께 거부됩니다. 공개 키나 로그인한 사용자의 토큰은 로그를 읽을 수 없습니다.