.NET Framework 애플리케이션 트레이싱

이 번역은 최신 버전이 아닙니다. 최신 영문 버전을 보려면 여기를 클릭하세요.

호환성 요구 사항

지원되는 .NET Framework 런타임

.NET Tracer는 .NET Framework >= 4.6.1에서의 계측을 지원합니다.

Datadog의 .NET Framework 라이브러리 및 프로세서 아키텍처 지원(레거시 버전 및 유지 관리 버전 포함) 전체 목록은 호환성 요구 사항을 참조하세요.

설치 및 시작하기

AWS Lambda 또는 Azure Functions와 같은 Serverless 환경에서 Datadog APM을 설정하려면 Serverless를 참조하세요.
참고: Datadog의 자동 계측은 .NET CLR 프로파일링 API를 사용합니다. 이 API는 하나의 구독자만 허용합니다(예: Datadog APM). 최대한의 가시성을 확보하려면 애플리케이션 환경에서 하나의 APM 솔루션만 실행해야 합니다.

설치

시작하기 전에 먼저 Agent를 설치하고 구성했는지 확인하세요.

  1. SDK를 설치합니다.
  2. 서비스에 SDK를 활성화합니다.
  3. 실시간 데이터를 조회합니다.

SDK 설치

Datadog Agent를 설치하고 구성했으면, 다음 단계로 애플리케이션을 계측할 SDK를 애플리케이션에 직접 추가합니다. 자세한 정보는 호환성 정보를 참조하세요.

Datadog .NET Tracer를 시스템 전체에 설치하여 해당 시스템의 모든 서비스가 계측되게 하거나, 애플리케이션별로 설치하여 개발자가 애플리케이션의 종속성을 통해 계측을 관리하도록 합니다. 시스템 전체 설치 방법을 보려면 Windows 탭을 클릭하세요. 애플리케이션별 설치 지침을 보려면 NuGet 탭을 클릭하세요.

    .NET Tracer를 시스템 전체에 설치하려면 다음 단계를 수행합니다.

    1. .NET Tracer MSI 설치 프로그램을 다운로드합니다. 64비트 Windows를 실행 중인 경우 x64 MSI 설치 프로그램을 사용하세요. 이는 64비트 및 32비트 애플리케이션 모두를 계측할 수 있습니다. 32비트 Windows를 실행 중인 경우에만 x86 설치 프로그램을 선택하세요. v3.0.0부터는 32비트 운영 체제를 지원하지 않으므로 x64 설치 프로그램만 제공됩니다.

    2. .NET Tracer MSI 설치 프로그램을 관리자 권한으로 실행합니다.

    PowerShell에서 다음 명령을 실행하여 MSI 설치를 스크립트 방식으로 수행할 수도 있습니다. Start-Process -Wait msiexec -ArgumentList '/qn /i datadog-apm.msi'

    참고: 이 설치 방식은 IIS에서 실행되는 애플리케이션을 계측하지 않습니다. IIS에서 실행되는 애플리케이션의 경우, Windows 시스템 전체 설치 절차를 따르세요.

    애플리케이션별로 .NET Tracer를 설치하는 방법:

    1. 애플리케이션에 Datadog.Trace.Bundle NuGet 패키지를 추가합니다.

    서비스에 SDK 활성화

    서비스에 .NET Tracer를 활성화하려면 필요한 환경 변수를 설정한 후 애플리케이션을 다시 시작하세요.

    환경 변수를 설정하는 다양한 방법에 대한 정보는 프로세스 환경 변수 구성을 참조하세요.

      Internet Information Services(IIS)

      1. .NET Tracer MSI 설치 프로그램은 모든 필요한 환경 변수를 추가합니다. 별도로 구성해야 하는 환경 변수는 없습니다.

      2. IIS에서 호스팅되는 애플리케이션을 자동으로 계측하려면, 다음 명령을 관리자 권한으로 실행하여 IIS를 완전히 중지하고 시작합니다.

        net stop /y was
net start w3svc
# Also, start any other services that were stopped when WAS was shut down.
        참고: SDK를 활성화하려면 항상 위의 명령을 사용하여 IIS를 완전히 중지하고 재시작하세요. IIS Manager GUI 애플리케이션 또는 iisreset.exe사용은 피하세요.

      IIS 외부의 서비스

      참고: .NET 런타임은 이러한 환경 변수가 설정된 상태에서 시작되는 모든 .NET 프로세스에 .NET 라이브러리를 로드하려고 시도합니다. 계측이 필요한 애플리케이션에만 적용되도록 범위를 제한해야 합니다. 이 환경 변수를 전역적으로 설정하지 마세요. 이렇게 하면 호스트의 모든 .NET 프로세스가 계측됩니다.

      1. 애플리케이션에 자동 계측을 연결하려면 다음 필수 환경 변수를 설정합니다.

        COR_ENABLE_PROFILING=1

      2. 독립 실행형 애플리케이션 및 Windows 서비스의 경우, 애플리케이션을 수동으로 다시 시작합니다.

      패키지 README의 지침을 따르세요. 이 README는 dd-trace-dotnet 리포지토리에서도 확인할 수 있습니다. Docker 예제도 리포지토리에서 확인할 수 있습니다.

      실시간 데이터 조회

      서비스에 대해 .NET Tracer를 활성화한 후:

      1. 서비스를 다시 시작합니다.

      2. 애플리케이션 로드를 생성합니다.

      3. Datadog에서 APM > APM Traces로 이동합니다.

      구성

      필요한 경우 Unified Service Tagging을 설정하는 등 SDK가 애플리케이션 성능 텔레메트리 데이터를 전송하도록 구성합니다. 자세한 내용은 라이브러리 구성을 참조하세요.

      사용자 지정 계측

      사용자 지정 계측은 자동 계측에 따라 달라지며 사용 방법에 따라 추가 단계가 필요합니다.

        참고: v3.0.0부터 사용자 지정 계측은 자동 계측을 함께 사용해야 합니다. 자동 계측 패키지(MSI)와 사용자 지정 계측 패키지(NuGet)의 버전은 가능한 한 동일하게 유지하고 서로 다른 주 버전을 혼용하지 않는 것이 좋습니다.

        .NET 애플리케이션에서 사용자 지정 계측을 사용하려면:

        1. 자동 계측을 사용하여 애플리케이션을 계측합니다.
        2. 애플리케이션에 Datadog.Trace NuGet 패키지를 추가합니다.
        3. 애플리케이션 코드에서 Datadog.Trace.Tracer.Instance 속성을 통해 전역 트레이서에 액세스하고 새 스팬을 생성합니다.

        .NET 애플리케이션에서 사용자 지정 계측을 사용하려면:

        1. 애플리케이션 코드에서 Datadog.Trace.Tracer.Instance 속성을 통해 전역 트레이서에 액세스하고 새 스팬을 생성합니다.

        사용자 지정 계측에 스팬과 태그를 추가하는 방법에 대한 자세한 정보는 .NET 사용자 지정 계측 설명서를 참조하세요.

        프로세스 환경 변수 구성

        자동 계측을 서비스에 연결하려면 애플리케이션을 시작하기 전에 필수 환경 변수를 설정합니다. 서비스에 SDK 활성화 섹션을 참조하여 .NET Tracer 설치 방법에 따라 설정해야 할 환경 변수를 확인하고, 아래 예제를 따라 계측된 서비스의 환경에 따라 환경 변수를 올바르게 설정하세요.

        참고: .NET 런타임은 이러한 환경 변수가 설정된 상태에서 시작되는 모든 .NET 프로세스에 .NET 라이브러리를 로드하려고 시도합니다. 계측이 필요한 애플리케이션에만 적용되도록 범위를 제한해야 합니다. 이 환경 변수를 전역적으로 설정하지 마세요. 이렇게 하면 호스트의 모든 .NET 프로세스가 계측됩니다.

        Windows 서비스

          레지스트리 편집기에서 HKLM\System\CurrentControlSet\Services\<SERVICE NAME> 키 아래에 Environment라는 이름의 다중 문자열 값을 생성한 다음, 값 데이터에 다음 내용을 설정합니다.

          COR_ENABLE_PROFILING=1
          Windows 서비스에 대한 환경 변수를 생성하기 위해 레지스트리 편집기 사용
          Set-ItemProperty HKLM:SYSTEM\CurrentControlSet\Services\<SERVICE NAME> -Name Environment -Value 'COR_ENABLE_PROFILING=1'

          IIS

          MSI를 설치한 후에는 IIS 사이트를 자동으로 계측하기 위해 추가 구성이 필요하지 않습니다. 모든 IIS 사이트에서 상속되는 추가 환경 변수를 설정하려면 다음 단계를 수행하세요.

          1. 레지스트리 편집기를 열고 HKLM\System\CurrentControlSet\Services\WAS 키에 있는 Environment라는 다중 문자열 값을 찾아 환경 변수를 한 줄씩 추가합니다. 예를 들어, 로그 주입 및 런타임 메트릭을 추가하려면 값 데이터에 다음 줄을 추가합니다.
            DD_LOGS_INJECTION=true
DD_RUNTIME_METRICS_ENABLED=true
          2. 다음 명령을 실행하여 IIS를 재시작합니다.
            net stop /y was
net start w3svc
# Also, start any other services that were stopped when WAS was shut down.
          모든 IIS 사이트에 대한 환경 변수를 생성하기 위해 레지스트리 편집기 사용

          콘솔 애플리케이션

          콘솔 애플리케이션을 자동으로 계측하려면, 애플리케이션을 시작하기 전에 배치 파일에서 환경 변수를 설정하세요.

          rem Set required environment variables
SET COR_ENABLE_PROFILING=1

rem (Optionally) Set additional Datadog environment variables, for example:
SET DD_LOGS_INJECTION=true
SET DD_RUNTIME_METRICS_ENABLED=true

rem Start application
dotnet.exe example.dll

          추가 자료

          추가 유용한 문서, 링크 및 기사:

          .NET 애플리케이션 로그를 트레이스에 연결하기설명서 more more 런타임 메트릭설명서 more more Microsoft Azure App Service 확장설명서 more more 서비스, 리소스, 트레이스 둘러보기설명서 more more Datadog APM 및 분산 트레이싱을 사용한 .NET 모니터링블로그 more more 컨테이너화된 ASP.NET Core 애플리케이션 모니터링블로그 more more AWS Fargate에서 컨테이너화된 ASP.NET Core 애플리케이션 모니터링블로그 more more Datadog Continuous Profiler로 .NET 애플리케이션 성능 최적화하기블로그 more more 사용자 지정 계측 예시소스 코드 more more 소스 코드소스 코드 more more