감사 로그는 Enterprise 조직에서만 사용할 수 있습니다.
조직 소유자 및 주 소유자는 설정 > 데이터 관리에서 "로그 내보내기" 버튼을 클릭하여 데이터를 내보낼 수 있습니다. 이 내보내기를 실행하면 지난 180일 동안의 조직 내 모든 감사 로그가 집계됩니다. 내보내기를 요청한 소유자는 24시간 동안 활성화되는 다운로드 링크가 포함된 이메일을 받게 됩니다. 로그가 집계되는 동안 내보내기 실행과 이메일 수신 사이에 지연이 있을 수 있습니다.
채팅 및 프로젝트의 제목과 내용은 감사 로그에서 내보낼 수 없습니다(고유 식별자만 내보내집니다). 그러나 채팅 입력/출력은 주 소유자가 데이터 내보내기를 통해 내보낼 수 있습니다.
로그 구조
감사 로그는 다음 열로 구성됩니다:
열 이름 | 유형 | 설명 |
created_at | datetime | 로그가 작성된 시간 |
actor_info | dict[str, Any] | 행위자에 대한 정보(사용 가능한 경우) |
event | AuditEventType | 이벤트 유형. |
event_info
| dict[str, Any]
| 특정 이벤트 유형에 대한 기타 관련 정보. |
entity_info | dict[str, Any] | 작업에 의해 영향을 받는 엔티티(관련이 있는 경우). 일반적으로 엔티티는 이벤트에 의해 영향을 받는 대상을 나타냅니다. |
ip_address | str | None | 이벤트에 해당하는 IP 주소(사용 가능한 경우). |
device_id | str | None | 이벤트에 해당하는 기기 ID(사용 가능한 경우). |
user_agent | str | None | 이벤트에 해당하는 사용자 에이전트 헤더(사용 가능한 경우). 이벤트를 실행하는 데 사용된 프로그램에 대한 세부 정보를 포함합니다. |
client_platform | str | None | 이벤트에 해당하는 클라이언트 플랫폼(사용 가능한 경우). iOS 또는 Android 모바일 플랫폼에 해당합니다. |
엔티티
이벤트에 의해 영향을 받을 수 있는 엔티티입니다. 엔티티 정보는 다음 구조를 따릅니다:
필드 이름 | 필드 유형 | 참고사항 |
type | AuditEntityType | 엔티티의 유형. |
uuid | str | 엔티티의 UUID. |
name | str | None | 엔티티의 이름(사용 가능한 경우) |
metadata | dict[str, Any] | None | 엔티티와 관련된 메타데이터(사용 가능한 경우) |
AuditEntityType | 메타데이터 | 설명 |
account | email_address: 계정의 이메일 주소 | 사용자 계정. |
invite | role: 초대 대상 역할 | 팀/조직 가입 초대 |
chat_project | is_private: 프로젝트의 가시성 | 채팅으로 구성된 프로젝트 |
chat_project_document | project_uuid: 이 문서와 관련된 프로젝트의 UUID | 채팅 프로젝트의 지식 베이스에 있는 문서 |
chat_conversation | project_uuid: 이 대화가 속한 프로젝트의 UUID(관련이 있는 경우) | Claude |