설치 가이드
ChatGPT Enterprise 워크스페이스의 컴플라이언스 로그를 수집하려면 세 단계를 거칩니다.
- ChatGPT 관리자 콘솔에서 관리자 키와 워크스페이스 ID를 확보
- 로그프레소에 접속 프로파일 등록
- 수집기 활성화
1. 관리자 키 발급
관리자 키는 워크스페이스 범위의 키여야 합니다. API 플랫폼(platform.openai.com)에서 발급하는 조직 관리자 키와는 다른 값이며, 서로 대체할 수 없습니다.
1-1. 관리자 콘솔 접속
브라우저에서 https://admin.openai.com 으로 이동해 로그인합니다. 워크스페이스 관리자 권한이 있는 계정이어야 합니다.
일반 사용자가 쓰는 chatgpt.com이나 개발자용 platform.openai.com과는 다른 주소입니다. 두 곳의 설정 화면에는 컴플라이언스 관리자 키가 없습니다.
1-2. 워크스페이스 ID 확인과 선택
로그인하면 개요 화면이 나옵니다. 아래쪽 표에서 제품이 ChatGPT 워크스페이스인 행의 ID를 복사해 둡니다.
ID를 복사했으면 왼쪽 위 선택기에서 로그를 수집할 워크스페이스로 전환합니다. 조직이 선택된 상태에서는 인증 정보 메뉴가 보이지 않습니다. 메뉴가 없다고 생각해 헤매기 쉬운 지점이니, 인증 정보가 안 보이면 워크스페이스를 선택했는지부터 확인하세요.
1-3. 인증 정보 메뉴
워크스페이스를 선택하면 메뉴에 인증 정보(Credentials) 가 나타납니다. 이 메뉴로 이동합니다.
1-4. 관리자 키 탭
인증 정보 화면에서 관리자 키(Admin keys) 탭으로 이동한 뒤 키를 생성합니다.
생성된 키는 그 자리에서 한 번만 전체가 표시됩니다. 화면을 벗어나면 다시 볼 수 없으므로 즉시 복사해 두세요.
2. 접속 프로파일 등록
로그프레소에서 설정 > 접속 프로파일로 이동해 ChatGPT Enterprise: Workspace 유형으로 추가합니다.
| 항목 | 설명 |
|---|---|
| 관리자 키 | 필수. 1-4에서 복사한 값. 저장 후에는 마스킹되어 표시됩니다 |
| 워크스페이스 ID | 필수. 1-2에서 복사한 값 |
| HTTP 프록시 | 선택. IP:포트 |
| 접속 타임아웃 | 선택. 초 단위, 기본값 30 |
| 읽기 타임아웃 | 선택. 초 단위, 기본값 300 |
워크스페이스가 여러 개면 프로파일을 여러 개 등록합니다. 수집기와 조회 화면은 모두 프로파일 단위로 동작하므로 워크스페이스별 데이터가 섞이지 않습니다.
프로파일 이름 규칙
프로파일 이름은 수집 테이블 이름의 뒷부분에 그대로 들어갑니다. 이름을 HQ로 지으면 테이블은 CHATGPT_CHAT_HQ, CHATGPT_AUDIT_HQ처럼 만들어집니다.
워크스페이스를 알아볼 수 있는 영문 약칭을 권장합니다. 테이블 이름에 쓸 수 있는 문자만 남기는 변환을 거치기 때문입니다.
- 영문은 대문자로 바뀌고, 영문·숫자·밑줄이 아닌 문자는 밑줄이 됩니다
- 24자를 넘으면 잘립니다
- 한글처럼 남는 문자가 하나도 없으면 프로파일 식별자 앞 8자리로 대체됩니다.
CHATGPT_CHAT_3F9A1C07처럼 사람이 읽을 수 없는 이름이 됩니다
이름을 나중에 바꿔도 이미 만들어진 테이블은 따라가지 않습니다. 처음 등록할 때 정하는 편이 좋습니다.
3. 수집기 활성화
ChatGPT Enterprise > 수집기 화면에서 워크스페이스를 고르면 수집 대상 10종이 나열됩니다. 활성화하면 테이블과 수집기가 함께 만들어집니다. 테이블을 미리 만들어 둘 필요는 없습니다.
| 수집 대상 | 테이블 이름 | 로그 스키마 |
|---|---|---|
| 대화 메시지 | CHATGPT_CHAT_{워크스페이스} | chatgpt-ent-chat |
| 감사 | CHATGPT_AUDIT_{워크스페이스} | chatgpt-ent-audit |
| 인증 | CHATGPT_AUTH_{워크스페이스} | chatgpt-ent-auth |
| 앱 인증 | CHATGPT_APP_AUTH_{워크스페이스} | chatgpt-ent-app-auth |
| 앱 호출 | CHATGPT_APP_{워크스페이스} | chatgpt-ent-app |
| Codex | CHATGPT_CODEX_{워크스페이스} | chatgpt-ent-codex |
| Codex 보안 | CHATGPT_CODEX_SECURITY_{워크스페이스} | chatgpt-ent-codex-security |
| 프레젠테이션 | CHATGPT_SLIDE_{워크스페이스} | chatgpt-ent-presentation |
| 스프레드시트 | CHATGPT_SHEET_{워크스페이스} | chatgpt-ent-spreadsheet |
| 커스텀 에이전트 | CHATGPT_CUSTOM_AGENT_{워크스페이스} | chatgpt-ent-custom-agents |
이름 뒤의 {워크스페이스}는 프로파일 이름에서 만들어집니다.
수집 주기와 최초 조회 범위
행마다 따로 지정합니다. 대화 메시지와 Codex 로그는 발생량이 크게 다르므로, 같은 주기를 강요하지 않습니다.
- 수집 주기: 60~3600초. 기본값 300초
- 최초 조회 일수: 1~30일. 기본값 30일
최초 조회 일수는 수집기를 처음 켤 때 얼마나 거슬러 올라갈지를 정합니다. API는 최근 30일치만 보관하고 나중에 소급 수집이 불가능하므로 기본값은 최대치입니다. 이후 수집은 마지막으로 읽은 시점부터 이어집니다.
4. 확인
수집기를 켠 뒤 화면에서 상태가 동작 중으로 바뀌고 수집 건수가 오르는지 확인합니다.
키나 워크스페이스 ID가 잘못되면 수집기가 실패 사유를 표시합니다.
| 증상 | 원인 |
|---|---|
| HTTP 401 | 관리자 키가 거부됨. 조직 관리자 키를 넣었을 가능성이 높습니다 |
| HTTP 404 | 워크스페이스 ID가 맞지 않음 |
| HTTP 429 | 요청이 몰림. 수집 주기를 늘리세요 |
수집이 시작되면 ChatGPT Enterprise > 로그 메뉴에서 조회할 수 있습니다. 화면 사용법은 사용 매뉴얼을 참고하세요.


