사용 매뉴얼
ChatGPT Enterprise 워크스페이스의 컴플라이언스 로그를 조회합니다. 구성원이 ChatGPT와 주고받은 대화, 관리자가 수행한 작업, 로그인 내역, 외부 앱·커넥터 호출, Codex 사용 내역을 하나의 화면에서 확인할 수 있습니다.
설치와 초기 설정은 설치 가이드를 참고하세요.
대화
구성원이 ChatGPT와 주고받은 대화를 대화 단위로 모아 보여줍니다. 목록에서 대화를 고르면 오른쪽 패널에 전문이 시간순으로 재구성됩니다. 사용자 메시지와 모델 응답이 구분되어 표시되고, 모델 이름과 클라이언트 종류를 함께 확인할 수 있습니다.
한 대화는 여러 로그 파일에 나뉘어 들어오므로 수집 순서가 대화 순서와 다릅니다. 패널은 메시지 시각으로 다시 정렬해 보여줍니다.
첨부 파일은 식별자만 남습니다. Compliance API가 파일 본문을 제공하지 않기 때문입니다.
로그
앱 인증, 앱, 감사, 인증, Codex, Codex 보안 6종을 같은 방식으로 조회합니다.
- 기간과 계정으로 범위를 좁힙니다. 계정은 여러 개를 고를 수 있습니다
- 셀을 클릭하면 그 값이 검색 조건으로 추가됩니다. 조건은 칩으로 표시되며 개별 해제할 수 있습니다
- 행을 클릭하면 오른쪽 패널에 전체 필드가 로그 스키마 순서대로 표시됩니다
- 기간, 조건, 페이지 상태는 주소에 남으므로 화면을 공유하거나 뒤로 가기를 눌러도 유지됩니다
목록에서 본문은 끝부분 100자만 보여줍니다. 지시문이 긴 메시지의 뒤쪽에 오는 경우가 많고, 행을 열면 전체를 다시 읽어 오기 때문입니다.
수집 상태 확인
ChatGPT Enterprise > 수집기 화면에서 수집 대상별 상태, 수집 건수, 최근 수집 시각을 확인합니다.
수집기를 삭제할 때는 테이블을 함께 지울지 물어봅니다. 테이블을 남기고 삭제한 뒤 다시 활성화하면 같은 테이블에 이어서 쌓입니다.
쿼리 명령어
수집기를 걸지 않아도 API에서 바로 읽어 올 수 있습니다. 수집 이전 기간을 확인하거나, 수집 대상이 아닌 유형을 한 번만 살펴볼 때 씁니다.
| 명령어 | 조회 대상 |
|---|---|
chatgpt-ent-chat-logs | 프롬프트와 모델 응답 |
chatgpt-ent-audit-logs | 관리 작업 |
chatgpt-ent-auth-logs | 로그인 활동 |
chatgpt-ent-app-auth-logs | 앱과 커넥터 연결 및 해제 |
chatgpt-ent-app-logs | 앱과 커넥터 호출 |
chatgpt-ent-codex-logs | Codex 사용 내역 |
chatgpt-ent-codex-security-logs | Codex 보안 검사 결과 |
chatgpt-ent-presentation-logs | 프레젠테이션 활동 |
chatgpt-ent-spreadsheet-logs | 스프레드시트 활동 |
chatgpt-ent-custom-agents-logs | 커스텀 에이전트 활동 |
chatgpt-ent-log-files | 컴플라이언스 로그 파일 목록 |
공통 옵션은 profile, duration, from, to이고, 로그 조회 명령어는 user를 추가로 받습니다. 대화와 앱 호출은 conversation-id로도 좁힐 수 있습니다.
기간을 지정하지 않으면 최근 24시간을 조회합니다. API가 시작 시각을 반드시 요구하기 때문입니다.
파일을 실제로 내려받기 전에 분량을 가늠하려면 목록부터 확인합니다.
제약 사항
- 보존 기간: API는 최근 30일치만 제공합니다. 그 이전 기록은 어떤 방법으로도 가져올 수 없습니다
- 수집 지연: 로그 파일은 일정 시간 단위로 닫힌 뒤 목록에 나타나므로, 방금 발생한 이벤트가 즉시 보이지는 않습니다
- 파일 경계: 파일 이름은 파일이 닫힌 시각을 따르며, 파일 안의 첫 레코드는 그보다 이전일 수 있습니다. 조회 시 기간은 이벤트 시각으로 다시 걸러집니다
- 본문 인코딩: 수집 시점에 HTML 엔터티를 원문으로 되돌립니다. 탭이 포함된 값은 고정폭으로 표시됩니다
- 권한: 수집기 생성과 삭제는 관리자만 할 수 있습니다. 조회는 호출자 권한으로 실행되므로 테이블 접근 권한이 그대로 적용됩니다