ChatGPT Enterprise

다운로드 0
업데이트 2026. 9. 25.

설치 가이드

ChatGPT Enterprise 워크스페이스의 컴플라이언스 로그를 수집하려면 세 단계를 거칩니다.

  1. ChatGPT 관리자 콘솔에서 관리자 키와 워크스페이스 ID를 확보
  2. 로그프레소에 접속 프로파일 등록
  3. 수집기 활성화

1. 관리자 키 발급

관리자 키는 워크스페이스 범위의 키여야 합니다. API 플랫폼(platform.openai.com)에서 발급하는 조직 관리자 키와는 다른 값이며, 서로 대체할 수 없습니다.

1-1. 관리자 콘솔 접속

브라우저에서 https://admin.openai.com 으로 이동해 로그인합니다. 워크스페이스 관리자 권한이 있는 계정이어야 합니다.

일반 사용자가 쓰는 chatgpt.com이나 개발자용 platform.openai.com과는 다른 주소입니다. 두 곳의 설정 화면에는 컴플라이언스 관리자 키가 없습니다.

1-2. 워크스페이스 ID 확인과 선택

로그인하면 개요 화면이 나옵니다. 아래쪽 표에서 제품이 ChatGPT 워크스페이스인 행의 ID를 복사해 둡니다.

Open AI 관리자 콘솔 접속

ID를 복사했으면 왼쪽 위 선택기에서 로그를 수집할 워크스페이스로 전환합니다. 조직이 선택된 상태에서는 인증 정보 메뉴가 보이지 않습니다. 메뉴가 없다고 생각해 헤매기 쉬운 지점이니, 인증 정보가 안 보이면 워크스페이스를 선택했는지부터 확인하세요.

1-3. 인증 정보 메뉴

워크스페이스를 선택하면 메뉴에 인증 정보(Credentials) 가 나타납니다. 이 메뉴로 이동합니다.

1-4. 관리자 키 탭

인증 정보 화면에서 관리자 키(Admin keys) 탭으로 이동한 뒤 키를 생성합니다.

Open AI 워크스페이스 관리자 키 생성

생성된 키는 그 자리에서 한 번만 전체가 표시됩니다. 화면을 벗어나면 다시 볼 수 없으므로 즉시 복사해 두세요.

Open AI 워크스페이스 관리자 키 확인

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
CodexCHATGPT_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 > 로그 메뉴에서 조회할 수 있습니다. 화면 사용법은 사용 매뉴얼을 참고하세요.