방법: Windows 서비스 애플리케이션 디버깅

아티클
03/03/2024

참고 항목

이 문서는 .NET의 호스트된 서비스에는 적용되지 않습니다. Microsoft.Extensions.Hosting.BackgroundService 및 Worker Service 템플릿을 사용하는 Windows 서비스에 대한 최신 콘텐츠는 다음을 참조하세요.

서비스는 Visual Studio 내에서가 아니라 서비스 제어 관리자의 컨텍스트 내에서 실행해야 합니다. 따라서 서비스를 디버그하는 것은 다른 Visual Studio 애플리케이션 형식을 디버그하는 것처럼 단순하지 않습니다. 서비스를 디버그하려면 서비스를 시작한 다음 서비스가 실행되는 프로세스에 디버거를 연결해야 합니다. 그리고 나면 Visual Studio의 모든 표준 디버깅 기능을 사용하여 애플리케이션을 디버그할 수 있습니다.

주의

프로세스에 대해 알고 있으며 해당 프로세스에 디버거를 연결하는 경우 프로세스가 종료될 수도 있음을 이해한 상태에서 프로세스에 디버거를 연결해야 합니다. 예를 들어 WinLogon 프로세스에 연결한 후에 디버깅을 중지하면 시스템이 중단됩니다. 시스템은 WinLogon 없이는 작동할 수 없기 때문입니다.

실행 중인 서비스에만 디버거를 연결할 수 있습니다. 연결 프로세스에서는 현재 서비스 작동이 중단되지만 서비스 처리가 실제로 중지되거나 일시 중지되지는 않습니다. 즉, 디버깅을 시작할 때 실행 중인 서비스는 디버그할 때도 기술적으로 계속 시작됨 상태이지만 처리는 일시 중단됩니다.

프로세스에 연결한 후에는 중단점을 설정하여 코드를 디버그하는 데 사용할 수 있습니다. 프로세스에 연결하는 데 사용한 대화 상자를 종료하면 디버그 모드가 시작됩니다. 서비스 제어 관리자를 사용하여 서비스를 시작, 중지, 일시 중지 및 계속해 설정된 중단점을 적중할 수 있습니다. 나중에 디버깅이 정상적으로 완료되면 이 더미 서비스를 제거할 수 있습니다.

이 문서에서는 로컬 컴퓨터에서 실행되는 서비스를 디버그하는 방법에 대해 다루지만, 원격 컴퓨터에서 실행되는 Windows 서비스도 디버그할 수 있습니다. 원격 디버깅을 참조하세요.

참고 항목

서비스 제어 관리자는 모든 서비스 시작 시도에 대해 30초의 제한을 적용하므로 OnStart 메서드를 디버그하는 작업은 까다로울 수 있습니다. 자세한 내용은 Troubleshooting: Debugging Windows Services(문제 해결: Windows 서비스 디버그)를 참조하세요.

Warning

디버깅을 위한 의미 있는 정보를 가져오려면 Visual Studio 디버거가 디버그 중인 이진 파일에 대한 기호 파일을 찾아야 합니다. Visual Studio에서 빌드한 서비스를 디버그하는 경우 기호 파일(.pdb 파일)은 실행 파일이나 라이브러리와 같은 폴더에 있으며 디버거는 이러한 파일을 자동으로 로드합니다. 직접 빌드하지 않은 서비스를 디버그할 때는 먼저 서비스의 기호를 찾아 디버거가 해당 기호를 검색할 수 있는지 확인해야 합니다. Visual Studio 디버거에서 기호 파일(.pdb) 및 소스 파일 지정을 참조하세요. 시스템 프로세스를 디버그하거나 서비스에 시스템 호출을 위한 기호를 포함하려는 경우에는 Microsoft 기호 서버를 추가해야 합니다. 디버깅 기호를 참조하세요.

서비스를 디버깅하려면

디버그 구성에서 서비스를 빌드합니다.
서비스를 설치합니다. 자세한 내용은 How to: Install and Uninstall Services을 참조하세요.
서비스 제어 관리자, 서버 탐색기 또는 코드에서 서비스를 시작합니다. 자세한 내용은 How to: Start Services(방법: 서비스 시작)를 참조하세요.
시스템 프로세스에 연결할 수 있도록 관리 자격 증명을 사용하여 Visual Studio를 시작합니다.
(선택 사항) Visual Studio 메뉴 모음에서 도구, 옵션을 선택합니다. 옵션 대화 상자에서 디버깅, 기호를 차례로 선택하고 Microsoft 기호 서버 확인란을 선택한 다음, 확인 단추를 선택합니다.
메뉴 모음의 디버그 또는 도구 메뉴에서 프로세스에 연결을 선택합니다(키보드: Ctrl+Alt+P).

프로세스 대화 상자가 표시됩니다.
모든 사용자의 프로세스 표시 확인란을 선택합니다.
사용 가능한 프로세스 섹션에서 서비스의 프로세스를 선택한 다음, 연결을 선택합니다.

팁

프로세스의 이름은 서비스의 실행 파일 이름과 같습니다.

프로세스에 연결 대화 상자가 나타납니다.
적절한 옵션을 선택하고 확인 단추를 선택하여 대화 상자를 닫습니다.

참고 항목

이제 디버그 모드가 설정되었습니다.
코드에서 사용할 중단점을 설정합니다.
서비스 제어 관리자에 액세스하고 서비스를 조작하여 중단점을 적중하는 중지, 일시 중지 및 계속 명령을 보냅니다. 서비스 제어 관리자 실행에 대한 자세한 내용은 How to: Start Services(방법: 서비스 시작)를 참조하세요. 또한 Troubleshooting: Debugging Windows Services(문제 해결: Windows 서비스 디버그)를 참조하세요.

Windows 서비스 디버깅 팁

서비스의 프로세스에 연결하면 해당 서비스의 코드를 대부분 디버그할 수 있지만 모든 코드를 디버그할 수 있는 것은 아닙니다. 예를 들어 서비스가 이미 시작되었기 때문에 이러한 방식으로 서비스를 로드하는 데 사용되는 서비스의 OnStart 메서드 내 코드나 Main 메서드 내의 코드는 디버그할 수 없습니다. 이 제한을 해결하는 한 가지 방법은 디버그에만 사용되는 두 번째 임시 서비스를 서비스 애플리케이션에 만드는 것입니다. 두 서비스를 모두 설치하고서 이 더미 서비스를 시작하여 서비스 프로세스를 로드할 수는 없습니다. 임시 서비스에서 프로세스를 시작하고 나면 Visual Studio에서 디버그 메뉴를 사용하여 서비스 프로세스에 연결할 수 있습니다.

프로세스에 연결할 수 있을 때까지 Sleep 메서드에 대한 호출을 추가하여 작업을 지연시켜 봅니다.

프로그램을 일반 콘솔 애플리케이션으로 변경해 봅니다. 이렇게 하려면 Main 메서드를 시작하는 방법에 따라 Windows 서비스와 콘솔 애플리케이션 둘 다로 실행할 수 있도록 다음과 같이 다시 작성합니다.

방법: 콘솔 애플리케이션으로 Windows 서비스 실행

OnStart 및 OnStop 메서드를 실행하는 서비스에 메서드를 추가합니다.

internal void TestStartupAndStop(string[] args)  
{  
    this.OnStart(args);  
    Console.ReadLine();  
    this.OnStop();  
}

Main 메서드를 다음과 같이 다시 작성합니다.

static void Main(string[] args)  
{  
    if (Environment.UserInteractive)  
    {  
        MyNewService service1 = new MyNewService(args);  
        service1.TestStartupAndStop(args);  
    }  
    else  
    {  
        // Put the body of your old Main method here.  
    }  
}

프로젝트 속성의 애플리케이션 탭에서 출력 형식을 콘솔 애플리케이션으로 설정합니다.
디버깅 시작(F5)을 선택합니다.
프로그램을 Windows 서비스로 다시 실행하려면 해당 프로그램을 설치하고 Windows 서비스를 시작하는 일반적인 방법으로 시작합니다. 이러한 변경 내용을 되돌릴 필요는 없습니다.

시스템 시작 시에만 발생하는 문제를 디버그하려는 등의 일부 경우에는 Windows 디버거를 사용해야 합니다. WDK(Windows 드라이버 키트)를 다운로드하고 How to debug Windows Services(Windows 서비스를 디버그하는 방법)를 참조하세요.

다음을 통해 공유

방법: Windows 서비스 애플리케이션 디버깅

서비스를 디버깅하려면

Windows 서비스 디버깅 팁

방법: 콘솔 애플리케이션으로 Windows 서비스 실행

참고 항목

추가 리소스