runpod-log는 RunPod GPU Pod의 로그를 터미널에서 바로 확인할 수 있게 해주는 CLI 도구입니다.

왜 만들었나

공식 RunPod CLI에는 로그 조회 기능이 없습니다. 웹 콘솔에서만 볼 수 있는데, Pod을 여러 개 돌리거나 자동화 스크립트를 짤 때 불편합니다. 그래서 비공식 API를 활용해서 터미널에서 바로 로그를 볼 수 있게 만들었습니다.

주요 기능

  • 로그 조회: 컨테이너 로그와 시스템 로그를 한 번에 가져옴
  • 실시간 모니터링: tail 명령으로 로그를 파일에 실시간 스트리밍
  • 자동 인증: Playwright 기반 브라우저 인증, 토큰 자동 갱신

사용법

# 설치
pip install runpod-log

# 로그인 (브라우저가 열림)
runpod-log login

# 로그 한 번 조회
runpod-log logs <pod-id>

# 실시간 모니터링
runpod-log tail <pod-id> ./logs.txt

# 로그아웃
runpod-log logout

어떻게 동작하나

  1. 인증: 브라우저를 열어 RunPod에 로그인하면, hapi.runpod.net으로 가는 요청에서 JWT 토큰을 캡처
  2. 토큰 갱신: 토큰이 만료되면(~60초) 헤드리스 브라우저로 자동 갱신
  3. 로그 조회: https://hapi.runpod.net/v1/pod/{pod_id}/logs API 호출

세션 정보는 로컬에 저장되어 매번 로그인할 필요 없습니다.

관심 있으시다면

AI 에이전트와 연동하거나, 여러 Pod을 모니터링하는 자동화 스크립트에 유용합니다.

👉 github.com/ho4040/runpod-log