AI 초보자 QnA
질문
OpenAI API 오류를 자세히 보려면 SDK 로그를 어떻게 켜나요?
답변
공식 Python SDK에서는 프로그램을 시작하기 전에 환경 변수
OPENAI_LOG
를
info
또는
debug
로 지정합니다. debug는 더 자세한 기록이 필요할 때 씁니다.
이 글은 API를 호출하는 Python 프로그램의 진단 로그를 켜는 방법입니다. ChatGPT 대화 기록이나 모델의 내부 사고 과정을 보는 기능은 아닙니다. 고객 자료가 없는 시험 환경에서 잠깐 켜고 필요한 단서만 남기세요.
짧게 답하면
SDK 확인 → info로 실행 → 필요할 때만 debug → 기록 검토 후 수준 낮추기 순서로 시작하세요. 로그가 많아졌다는 사실과 오류가 해결됐다는 판단은 따로 합니다.
OPENAI_LOG
Python SDK의 openai 로거 수준을 정하는 환경 변수입니다. 생성 요청 본문의 항목이 아닙니다.
info·debug
info로 먼저 살펴보고, 더 상세한 SDK 기록이 필요하면 debug로 바꿉니다.
전송 계층 로그
HTTP 전송 로거는 Python logging으로 별도 설정합니다. SDK 수준과 구분하세요.
처음 쓰는 사람 기준으로 설명하면
예를 들어 짧은 문장을 요약하는 앱이 실패하는데 화면에는 오류 한 줄만 나온다고 해 보세요. 같은 시험 입력으로 SDK 로그를 켜면 원인을 조사할 단서를 더 살필 수 있습니다. 먼저 실제 오류 종류와 발생 시각부터 확인하는 편이 좋습니다.
OpenAI Python API library의 Logging 절은 표준
logging
모듈을 사용하며
OPENAI_LOG=info
로 기록을 켠다고 안내합니다. 더 자세히 보려면
debug
를 사용합니다. 이 변수는
openai
로거에 적용되며 HTTP 전송 로거는 별도로 설정합니다.
Error codes 가이드는 연결 문제인
APIConnectionError
, 시간 초과인
APITimeoutError
, 인증 문제인
AuthenticationError
를 구분합니다. 로그 수준을 높이는 것만으로 키·권한·입력 오류가 고쳐지지는 않습니다. API Overview는 지원 문의를 위해 요청 ID를 남기도록 권합니다.
한 줄 정리: OPENAI_LOG는 SDK의 진단 기록 설정입니다. 답변의 상세도나 API 재시도 횟수, 네트워크 전체의 기록 수준을 한꺼번에 바꾸는 값은 아닙니다.
바로 따라 해보기
1단계. 시험용 프로그램과 입력을 준비합니다.
공식 openai Python 패키지를 쓰는지와 설치 버전을 확인하세요. 기존 앱에서 개인정보 없는 짧은 문장만 입력하고 메일 발송·파일 삭제 같은 후속 작업은 제외합니다. 키는 코드에 적지 말고 안전한 서버 환경에서 불러옵니다.
2단계. 시작 전에 로그 수준을 지정합니다.
macOS·Linux 셸 예시는
export OPENAI_LOG=info
입니다. 같은 터미널에서 기존 Python 앱을 새로 실행하세요. 더 자세한 기록이 필요하면
export OPENAI_LOG=debug
로 바꾼 뒤 재실행합니다. 질문 문장이나
responses.create
의 인수에 넣지 않습니다.
3단계. 기록을 검토하고 상세 출력을 줄입니다.
실행 시각·오류 유형·상태 코드와 가능한 요청 ID를 대조하세요. 조사 후
export OPENAI_LOG=warning
으로 바꾸고 앱을 재시작하면 SDK는 경고 이상만 표시합니다. 기존 로그 파일은 그대로 남으므로 공유 전 내용과 보관 범위를 따로 확인합니다.
주의할 점
현재 Python 문서는 warning·error·critical을 해당 수준 이상만 보이는 값으로 안내합니다. warning으로 바꿨다고 모든 로그가 꺼진 것은 아닙니다. 앱 자체나 HTTP 전송 로거의 설정도 따로 살피고, 필요한 오류 처리까지 없애지는 마세요.
상세 로그를 고객 자료가 흐르는 운영 환경에서 계속 켜 둡니다. 요청·응답 내용이나 민감 정보가 섞일 수 있으므로 기록을 자동으로 안전한 자료라고 믿지 마세요.
원본 로그를 그대로 공개 게시판에 붙입니다. 인증 헤더·키·개인정보를 먼저 제거하고 문제 재현에 필요한 최소 부분만 공유하세요.
OPENAI_LOG를 바꾸면 모든 HTTP 로그가 함께 바뀌거나 이미 저장한 로그도 지워진다고 생각합니다. 로거별 설정과 기존 기록의 보관·삭제를 따로 확인하세요.
웹사이트와 앱 중 무엇부터 쓰면 좋을까요?
설정 뜻은 공식 웹 문서에서
Python API library의 Logging을 먼저 읽고 Error codes에서 오류 유형을 대조하세요. 다른 언어 SDK의 로그 옵션을 Python 환경 변수와 그대로 섞지 않습니다.
기록 확인은 API 개발 환경에서
ChatGPT 웹·모바일 앱 설정이 아니라 API를 호출하는 서버나 개발 터미널에서 확인합니다. 로그가 안 보이면 실행 프로세스의 환경과 앱의 logging 설정을 먼저 점검하고 같은 요청을 무작정 반복하지 마세요.
같이 보면 좋은 질문
확인한 공식 자료
OpenAI 공식 Python 문서 — OpenAI Python API library — OPENAI_LOG의 수준과 openai 로거 적용 범위, HTTP 전송 로거의 별도 설정을 확인했습니다.
OpenAI 공식 가이드 — Error codes — 연결·시간 초과·인증 오류의 구분과 민감 정보를 제외한 문의 기준을 확인했습니다.
OpenAI API 참조 — API Overview — 요청 ID의 진단 용도와 운영 환경의 요청 ID 기록 권고를 확인했습니다.
감자나라 AI 강의보기 5,000 
