{"meta":{"title":"디버그 로깅 활성화","intro":"워크플로 로그가 워크플로, 작업 또는 단계가 예상대로 작동하지 않는 이유를 진단하기에 충분한 세부 정보를 제공하지 않는 경우 추가 디버그 로깅을 사용하도록 설정할 수 있습니다.","product":"GitHub Actions","breadcrumbs":[{"href":"/ko/actions","title":"GitHub Actions"},{"href":"/ko/actions/how-tos","title":"사용법"},{"href":"/ko/actions/how-tos/monitor-workflows","title":"워크플로 모니터링"},{"href":"/ko/actions/how-tos/monitor-workflows/enable-debug-logging","title":"디버그 로깅 활성화"}],"documentType":"article"},"body":"# 디버그 로깅 활성화\n\n워크플로 로그가 워크플로, 작업 또는 단계가 예상대로 작동하지 않는 이유를 진단하기에 충분한 세부 정보를 제공하지 않는 경우 추가 디버그 로깅을 사용하도록 설정할 수 있습니다.\n\n워크플로가 포함된 리포지토리에서 비밀 또는 변수를 설정하면 추가 로그를 사용할 수 있으므로 동일한 권한 요구 사항이 적용됩니다.\n\n* 조직 리포지토리에 대한 GitHub에 비밀 또는 변수를 만들려면 `write` 액세스 권한이 있어야 합니다. 개인 계정 리포지토리의 경우 리포지토리 공동 작업자여야 합니다.\n* 개인 계정 리포지토리에서 환경에 대한 비밀 또는 변수를 만들려면 리포지토리 소유자여야 합니다. 조직 리포지토리에서 환경에 대한 비밀 또는 변수를 만들려면 `admin` 액세스 권한이 있어야 합니다. 환경에 대한 자세한 내용은 [배포 환경 관리](/ko/actions/deployment/targeting-different-environments/managing-environments-for-deployment)을(를) 참조하세요.\n* 조직 소유자는 조직 수준에서 비밀 또는 변수를 만들 수 있습니다.\n\n비밀 및 변수 설정에 대한 자세한 내용은 [GitHub Actions에서 비밀 사용](/ko/actions/security-guides/using-secrets-in-github-actions) 및 [변수에 정보 저장](/ko/actions/learn-github-actions/variables)을(를) 참조하세요.\n\n또한 워크플로를 실행할 수 있는 액세스 권한이 있는 사용자는 누구나 실행기 진단 로깅을 사용하도록 설정하고 워크플로를 다시 실행하기 위한 디버그 로깅을 단계별로 실행할 수 있습니다. 자세한 내용은 [워크플로 및 작업 다시 실행](/ko/actions/managing-workflow-runs/re-running-workflows-and-jobs)을(를) 참조하세요.\n\n## 실행기 진단 로깅 사용\n\n실행기 진단 로깅은 실행기의 작업 실행 현황에 대한 정보가 포함된 추가 로그 파일을 제공합니다. 다음 두 개의 로그 파일이 로그 보관 파일에 추가됩니다.\n\n* 실행기 프로세스 로그 - 작업을 실행할 실행기를 조정하고 설정하는 방법에 대한 정보가 포함됩니다.\n* 작업자 프로세스 로그 - 작업 실행을 로깅합니다.\n\n1. 실행기 진단 로깅을 사용하도록 설정하려면 워크플로가 포함된 리포지토리에서 다음 비밀 또는 변수를 설정합니다(`ACTIONS_RUNNER_DEBUG`를 `true`로 설정함). 비밀과 변수가 모두 설정된 경우 비밀 값이 변수보다 우선합니다.\n2. 실행기 진단 로그를 다운로드하려면 워크플로 실행의 로그 보관 파일을 다운로드합니다. 실행기 진단 로그는 `runner-diagnostic-logs` 폴더에 포함됩니다. 로그 다운로드 방법에 대한 자세한 내용은 [워크플로 실행 로그 사용](/ko/actions/monitoring-and-troubleshooting-workflows/using-workflow-run-logs#downloading-logs)을(를) 참조하세요.\n\n## 단계 디버그 로깅 활성화\n\n단계별 디버깅 로깅은 작업 실행 중 및 실행 후 작업 로그의 자세한 정보를 증가시킵니다.\n\n1. 단계 디버그 로깅을 사용하도록 설정하려면 워크플로가 포함된 리포지토리에서 다음 비밀 또는 변수를 설정합니다(`ACTIONS_STEP_DEBUG`를 `true`로 설정함). 비밀과 변수가 모두 설정된 경우 비밀 값이 변수보다 우선합니다.\n2. 비밀 또는 변수를 설정하면 더 많은 디버그 이벤트가 단계 로그에 표시됩니다. 자세한 내용은 [워크플로 실행 로그 사용](/ko/actions/monitoring-and-troubleshooting-workflows/using-workflow-run-logs#viewing-logs-to-diagnose-failures)을(를) 참조하세요.\n\n   ```\n          `runner.debug` 컨텍스트를 사용하여 디버그 로깅이 활성화되어 있는 경우에만 조건부로 단계를 실행할 수 있습니다. 자세한 내용은 [AUTOTITLE](/actions/reference/workflows-and-actions/contexts#runner-context)을(를) 참조하세요.\n   ```"}