OpenAI 연동 및 대시보드

OpenAI API Platform의 비용·토큰 사용량과 ChatGPT Workspace의 메시지·Codex 활동을 한 화면에서 확인하는 통합 대시보드 사용법입니다. 연동 방법부터 각 탭의 해석까지 안내합니다.

OpenAI 연동 및 대시보드

조직의 OpenAI 사용 현황을 한 화면에서 분석합니다. API Platform (Admin) 과 ChatGPT Workspace (Compliance) 두 영역의 키를 각각 등록하여 비용·토큰·ChatGPT 활동을 함께 볼 수 있습니다. 매일 오전 5시 (KST) 자동 동기화되며, 각 탭에서 필요 시 수동 새로고침도 가능합니다.

1. 연동하기

단계 1: 연동 설정 화면 열기

사이드바에서 설정 > 연동 관리로 이동합니다.
AI 도구 섹션의 OpenAI 카드를 클릭합니다.
화면 우측 상단의 연동 가이드 보기 버튼을 누르면 OpenAI 키 발급 절차를 정리한 외부 가이드 문서가 새 탭으로 열립니다.

연동 화면은 위쪽 API Platform (Admin) 카드와 아래쪽 ChatGPT Workspace (Compliance) 카드 두 장으로 구성됩니다. 각 카드를 따로 연동합니다.

단계 2: Admin API Key 입력 (API Platform)

상단 API Platform (Admin) 카드를 봅니다.
안내: “OpenAI Platform → Admin keys에서 발급받은 키를 입력해주세요.”
Admin API Key 입력 (placeholder: sk-admin-...).
연동하기 버튼을 클릭합니다.

단계 3: Workspace ID + Compliance API Key 입력 (ChatGPT Workspace, 선택)

아래쪽 ChatGPT Workspace (Compliance) 카드를 봅니다.
안내: “ChatGPT Enterprise/Edu → Settings → Compliance → API Key에서 발급받은 키를 입력해주세요.”
Workspace ID 를 먼저 입력합니다 (placeholder: “chatgpt.com/admin 에서 확인 가능한 Workspace ID”). chatgpt.com/admin 화면에서 조회합니다.
Compliance API Key 를 입력합니다.
연동하기 버튼을 클릭합니다.

연동 완료 후

연동이 끝난 카드에는 대시보드 보기 버튼이 생깁니다. 누르면 해당 영역 탭이 열린 OpenAI 대시보드로 바로 이동합니다 (Admin 카드 → API Platform 탭, ChatGPT Workspace 카드 → ChatGPT Workspace 탭). 버튼 우측 드롭다운의 연동 해제 로 그 영역만 따로 해제할 수 있습니다.

2. 대시보드 접근

사이드바의 AI > OpenAI 메뉴를 클릭합니다.
또는 AI 메인 페이지 (/ai) 에서 OpenAI 카드의 열기 버튼을 누릅니다.
헤더 제목 OpenAI 와 설명 “API 플랫폼과 ChatGPT Workspace의 비용, 사용량을 관리합니다.” 가 표시되면 화면이 정상 동작 중입니다.

헤더 우측 버튼:

연동 설정 — 설정 > 연동 관리 페이지로 이동합니다.

3. 탭 구성

OpenAI 대시보드는 두 개의 메인 탭으로 구성됩니다. 탭은 ChatGPT Workspace 가 먼저, API Platform 이 다음 순서로 나란히 표시됩니다.

탭	활성화 조건	내용
ChatGPT Workspace	Compliance API Key 연동 시	활성 사용자 / 총 메시지 / 총 토큰 + 일별 메시지 추이 + ChatGPT·Codex·활동
API Platform	Admin API Key 연동 시	총 멤버 / 이번 달 비용 / 총 토큰 + 프로젝트별 비용 + 모델별 토큰 + 멤버 목록

기간은 오늘 기준 최근 30일로 고정되어 있습니다 (별도 날짜 필터는 없습니다).

4. API Platform 탭

KPI 카드 (3장)

카드	의미
총 멤버	연동된 OpenAI 조직의 총 멤버 수. 대기 중인 초대가 있으면 서브텍스트로 표시
이번 달 비용	최근 30일 누적 API 비용 (USD). 서브텍스트로 프로젝트 수
총 토큰	30일 누적 입력·출력 토큰 합계 (K/M/B 단위). 서브텍스트로 “캐시 효율 N%”

차트

프로젝트별 비용 (수평 바차트) — 각 프로젝트의 30일 누적 비용을 $금액 / % 로 표시합니다. 비용이 큰 순서대로 정렬됩니다.
모델별 토큰 사용량 (테이블) — 모델별 입력 / 캐시 / 출력 토큰과 요청 수, 합계를 비교합니다. 합계 기준 내림차순으로 정렬됩니다.

멤버 목록 테이블

이름, 이메일, 역할, 추가일
역할 값은 OpenAI 조직에서 내려오는 그대로 표시됩니다
발송했지만 아직 수락되지 않은 대기 중인 초대가 있으면 별도 목록으로 함께 표시됩니다

5. ChatGPT Workspace 탭

KPI 카드 (3장)

카드	의미
활성 사용자	최근 30일 ChatGPT 를 사용한 고유 사용자 수
총 메시지	30일 누적 ChatGPT 메시지 수
총 토큰	30일 누적 ChatGPT 토큰 사용량 (K/M/B 단위)

세 카드 모두 지난주 대비 증감을 함께 보여줍니다. 서브텍스트에는 절대 변화량 ”(+N) 지난주 대비” 가, 카드 모서리에는 증감률 (+N% / -N%) 과 방향이 표시됩니다.

일별 메시지 추이 (영역 차트)

날짜별 ChatGPT 메시지 수를 영역 차트로 보여줍니다. 데이터가 2일 이상 쌓이면 표시되며, 한 지점에 마우스를 올리면 그 날의 사용자 수 / 메시지 수 / 토큰 수가 함께 뜹니다.

3개 그리드 (각각 별도 테이블)

그리드	내용
ChatGPT 사용량	사용자별 메시지 수 / 토큰 / 사용 도구 / 주요 모델 / 날짜 (메시지 수 내림차순)
Codex	사용자별 모델 / 입력·출력 토큰 / 사용 도구 / 날짜 (날짜 내림차순)
활동	관리자 감사·사용자 인증 이벤트를 합쳐 사용자 / 액션 / 대상 / 유형 / 시간 (최신순)

각 그리드 제목 옆에는 행 개수를 나타내는 뱃지가 붙고, 검색·필터·정렬·열 보기 도구를 모두 쓸 수 있습니다.

6. 동기화 방식

자동 동기화 — 매일 오전 5시 (KST) 배치로 실행됩니다.
조직·멤버·프로젝트 — 연동 직후 첫 동기화 시 수집됩니다.
비용·토큰 사용량 — API 사용 후 최대 1일 이내에 프로젝트별 비용·모델별 토큰이 동기화됩니다.
ChatGPT 활동·Codex·인증 이벤트 — Compliance 연동 후 동기화됩니다.

수동 새로고침 (탭별)

수동으로 즉시 동기화가 필요하면 각 탭 상단의 새로고침 버튼을 사용하세요. API Platform 탭과 ChatGPT Workspace 탭의 새로고침은 서로 독립적으로 동작합니다.

7. 자주 묻는 질문

Q: ChatGPT Workspace 연동 버튼이 비활성화되어 있습니다.

ChatGPT Workspace 연동은 Workspace ID 와 Compliance API Key 두 값이 모두 입력되어야 연동하기 버튼이 켜집니다. Workspace ID 는 chatgpt.com/admin 에서 확인하고, Compliance API Key 는 ChatGPT Enterprise/Edu → Settings → Compliance → API Key 에서 발급해 둘 다 입력하세요.

Q: Admin Key 만 등록했는데 ChatGPT 사용량이 보이지 않습니다.

ChatGPT 사용량은 Compliance API Key (와 Workspace ID) 가 별도로 필요합니다. ChatGPT Workspace 카드를 따로 연동해주세요. 연동되지 않은 ChatGPT Workspace 탭에는 “Compliance API 연동이 필요합니다” 안내만 표시됩니다.

Q: 비용이 0 으로 나옵니다.

연동 직후에는 API 사용 후 최대 1일 이내에 비용이 동기화됩니다. 자동 동기화는 매일 오전 5시 (KST) 에 돕니다. 시간이 지난 후에도 0 이라면 해당 기간에 실제 API 호출이 없었거나, Admin Key 권한 부족일 수 있습니다. API Platform 탭의 새로고침 으로 한 번 더 시도해보세요.

Q: 새로고침 버튼이 회색이고 시간이 표시됩니다.

수동 새로고침은 5분에 한 번만 가능합니다. 한 번 누르면 5분 동안 버튼이 비활성화되고 남은 시간 (m:ss) 이 표시됩니다. 카운트다운이 끝나면 다시 누를 수 있습니다.

Q: Anthropic 대시보드와 다른 점은?

OpenAI 는 두 종류 키 (Admin / Compliance) 가 분리되어 있고, 탭 구조도 영역별로 나뉩니다. ChatGPT Workspace 는 Workspace ID 까지 함께 입력해야 합니다. Anthropic 은 단일 Admin Key 로 모든 데이터 (비용·사용량·Claude Code 생산성) 를 동기화합니다.

Q: 키를 교체하고 싶습니다.

연동 관리 페이지에서 연동된 카드의 대시보드 보기 우측 드롭다운 연동 해제 로 해제한 뒤 새 키로 다시 연동하세요. Admin 과 ChatGPT Workspace 는 각각 독립적으로 해제·재연동할 수 있습니다.

Q: 이 외의 문제

채널톡으로 문의해 주세요.