Moonpool 세션 로그와 디버그 로그 찾고 관리하기

Moonpool은 네 종류의 출력을 보관합니다.

종류	위치	보관
세션 로그	설정 폴더의 cli-output\<id>\<session-start-ms>.log	이번 세션은 항상, 이전 세션은 아래 보관 규칙에 따라
moonpool.log	설정 폴더	디버그 정보를 파일에 기록이 켜져 있는 동안에만 기록됨
덤프	지정한 위치 또는 세션 로그 자체의 경로	삭제할 때까지
스크롤백	터미널 탭	10,000줄, Moonpool을 종료할 때까지

설정 폴더는 설정이 있는 위치에 나와 있습니다.

세션 로그

앱이 터미널에 출력하는 모든 내용은 로그 파일에도 기록됩니다.

<config folder>\cli-output\<id>\<session-start-ms>.log

• Moonpool 세션마다 앱당 파일 하나입니다. 숫자는 해당 Moonpool 프로세스가 시작된 시각입니다.

• 앱을 중지하고 다시 실행해도 같은 파일에 계속 이어서 기록됩니다. 새 실행이 시작되는 위치에는 흐린 구분선이 표시되며, 같은 표시가 터미널 탭에도 나타납니다.

  1767225600000.log

  Local:   http://localhost:5173/
  ---------- restarted 2026-10-05 09:14:02 ----------
  Local:   http://localhost:5173/

• id에서 영문자, 숫자, -, _ 이외의 문자는 폴더 이름에서 _로 바뀝니다. 따라서 .도 _가 됩니다. 영어 이외의 문자는 그대로 유지됩니다.

• 파일에는 색상 코드를 포함한 원시 터미널 출력이 들어 있습니다. 일반 텍스트가 필요하면 덤프를 사용하세요.

앱의 탭을 다시 열면 이번 세션의 로그가 재생되어 이전 출력을 볼 수 있습니다.

보관

보관 규칙은 이전 Moonpool 세션의 로그에만 적용됩니다. 앱을 실행할 때 해당 앱의 폴더에 대해서만, 오래된 것부터 처리합니다.

세션이 끝난 뒤에도 앱 출력 로그 보관(cliLogging)	이전 세션 로그에 일어나는 일
끔(기본값)	앱을 다음에 실행할 때 삭제됩니다.
켬	폴더의 전체 크기가 앱별 로그 보관 용량(logRetentionMb, 기본값 10MB)을 넘을 때까지 보관되고, 넘으면 가장 오래된 것부터 삭제됩니다.

현재 세션의 파일도 이 합계에 포함되지만 삭제되거나 잘리지는 않습니다. 따라서 매우 큰 현재 로그 하나가 이전 로그를 모두 밀어낼 수 있습니다.

1. 세션이 끝난 뒤에도 앱 출력 로그 보관은 cliLogging입니다. 그 아래의 앱별 로그 보관 용량은 logRetentionMb입니다.

moonpool.log

디버그 정보를 파일에 기록(debugLogging)을 켜면 Moonpool은 설정 폴더의 moonpool.log에 타임스탬프가 붙은 줄을 추가합니다. apps.json 로드, 실행(명령과 폴더 포함), 제어 명령, 오류가 기록됩니다. 문제를 재현하기 전에 켜 두세요.

열기와 복사

설정의 각 로그 그룹 아래에서 다음을 사용할 수 있습니다.

• CLI 로그 폴더 열기와 로그 열기는 파일 관리자에서 폴더를 엽니다.
• CLI 로그 폴더 경로 복사와 로그 파일 경로 복사는 경로를 클립보드에 복사합니다.

터미널 탭에서는 모두 복사가 전체 스크롤백을 텍스트로 복사합니다.

덤프

dump 동사로 스크립트에서 세션 로그를 가져올 수 있습니다.

& "$env:USERPROFILE\.moonpool\moonpool.exe" dump my-app C:\temp\my-app.log

출력 경로를 주면 색상 코드를 제거한 일반 텍스트 복사본을 씁니다. 주지 않으면 세션 로그 자체의 경로를 알려 줍니다. 에이전트는 moonpool_app_output으로 이미 정리된 같은 텍스트를 받습니다. 명령줄을 참고하세요.