.NET¶

머신 전체에 .NET Tracer를 설치하려면 다음을 수행하세요.

1. .NET Tracer MSI 설치 프로그램을 다운로드합니다. 운영 체제(x64 또는 x86)에 맞는 아키텍처의 MSI 설치 프로그램을 선택합니다.
2. 관리자 권한으로 .NET Tracer MSI 설치 프로그램을 실행합니다. PowerShell에서 다음 명령을 실행하여 MSI 설치 프로그램을 스크립트로 실행할 수도 있습니다. Start-Process -Wait msiexec -ArgumentList '/qn /i datadog-apm.msi'.

머신 전체에 .NET Tracer를 설치하려면 다음을 수행하세요.

1. .NET Tracer MSI 설치 프로그램을 다운로드합니다. 운영 체제(x64 또는 x86)에 맞는 아키텍처의 MSI 설치 프로그램을 선택합니다.
2. 운영 체제에 맞는 아래 설치 패키지를 실행하고, 적절한 권한으로 .NET tracer 로그 디렉터리 /var/log/datadog/dotnet를 생성합니다.

   Debian or Ubuntu
   sudo dpkg -i ./datadog-dotnet-apm_<TRACER_VERSION>_amd64.deb && /opt/datadog/createLogPath.sh
   CentOS or Fedora
   sudo rpm -Uvh datadog-dotnet-apm<TRACER_VERSION>-1.x86_64.rpm && /opt/datadog/createLogPath.sh
   Alpine or other musl-based distributions
   sudo tar -C /opt/datadog -xzf datadog-dotnet-apm-<TRACER_VERSION>-musl.tar.gz && sh /opt/datadog/createLogPath.sh
   Other distributions
   sudo tar -C /opt/datadog -xzf datadog-dotnet-apm<TRACER_VERSION>-tar.gz && /opt/datadog/createLogPath.sh

셸이 없는 경량 또는 distroless Docker 이미지에 .NET tracer를 설치하려면 Dockerfile에서 다음 명령을 사용하세요.

• ADD를 사용해 tracer 파일을 컨테이너에 넣습니다.
• COPY --chown=$APP_UID를 사용하고 빈 디렉터리를 소스로 하여 로그 디렉터리를 생성합니다.

예를 들어 Dockerfile에는 다음과 같이 작성할 수 있습니다.

ADD datadog-dotnet-apm-<TRACER_VERSION>.tar.gz /opt/datadog/
COPY --chown=$APP_UID --from=<OTHER_STAGE> /empty/ /var/log/datadog/dotnet/

애플리케이션에 .NET Tracer 추가

1. NuGet package를 사용하여 애플리케이션에 Datadog.Trace.Bundle를 추가합니다.

Internet Information Services (IIS)：

1. .NET Tracer MSI 설치 프로그램이 필요한 모든 환경 변수를 추가합니다. 여기서는 추가 환경 변수를 구성해야 합니다.
2. IIS에서 호스팅되는 애플리케이션을 자동 감지하려면 관리자 권한으로 다음 명령을 실행하여 IIS를 완전히 중지한 뒤 다시 시작하세요.

   net stop /y was
   net start w3svc
   

IIS가 아닌 애플리케이션

1. 애플리케이션에 연결할 자동 감지를 위해 다음 필수 환경 변수를 설정합니다.

   CORECLR_ENABLE_PROFILING=1
   CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
   

2. 애플리케이션을 다시 시작합니다.

1. 애플리케이션에 자동 감지를 추가하기 위해 필요한 환경 변수를 설정합니다.

   CORECLR_ENABLE_PROFILING=1  
   CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}  
   CORECLR_PROFILER_PATH=/opt/datadog/Datadog.Trace.ClrProfiler.Native.so  
   DD_DOTNET_TRACER_HOME=/opt/datadog  
   

2. 애플리케이션을 다시 시작합니다

.NET 애플리케이션에 사용자 정의 probe를 추가합니다.

1. 애플리케이션 코드에서 Datadog.Trace.Tracer.Instance 속성을 통해 전역 tracer에 접근하여 새로운 span을 생성합니다.

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
   # 또한 WAS 종료 시 중지되던 다른 모든 서비스도 다시 시작됩니다.
   

   

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

rem Set environment variables
SET CORECLR_ENABLE_PROFILING=1
rem Unless v2.14.0+ and you installed the tracer with the MSI
SET CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}

rem Set additional Datadog environment variables
SET DD_LOGS_INJECTION=true
SET DD_RUNTIME_METRICS_ENABLED=true

rem Start application
dotnet.exe example.dll

애플리케이션을 시작하기 전에 bash에서 필요한 환경 변수를 설정합니다.

# Set environment variables
export CORECLR_ENABLE_PROFILING=1
export CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
export CORECLR_PROFILER_PATH=/opt/datadog/Datadog.Trace.ClrProfiler.Native.so
export DD_DOTNET_TRACER_HOME=/opt/datadog

# Set additional Datadog environment variables
export DD_LOGS_INJECTION=true
export DD_RUNTIME_METRICS_ENABLED=true

# Start your application
dotnet example.dll

Docker container에서 환경 변수를 설정합니다.

# Set environment variables
ENV CORECLR_ENABLE_PROFILING=1
ENV CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
ENV CORECLR_PROFILER_PATH=/opt/datadog/Datadog.Trace.ClrProfiler.Native.so
ENV DD_DOTNET_TRACER_HOME=/opt/datadog

# Set additional Datadog environment variables
ENV DD_LOGS_INJECTION=true
ENV DD_RUNTIME_METRICS_ENABLED=true

# Start your application
CMD ["dotnet", "example.dll"]

systemctl을 사용해 .NET 애플리케이션을 서비스로 실행할 때, 특정 서비스가 로드할 필요한 환경 변수를 추가할 수 있습니다.

1. 다음을 포함하는 environment.env 파일을 생성합니다.

   # Set environment variables
   CORECLR_ENABLE_PROFILING=1
   CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
   CORECLR_PROFILER_PATH=/opt/datadog/Datadog.Trace.ClrProfiler.Native.so
   DD_DOTNET_TRACER_HOME=/opt/datadog
   
   # Set additional Datadog environment variables
   DD_LOGS_INJECTION=true
   DD_RUNTIME_METRICS_ENABLED=true
   

2. 서비스 구성 파일에서 이를 서비스 블록의 EnvironmentFile로 참조합니다.

   EnvironmentFile=/path/to/environment.env
   ExecStart=<command used to start the application>
   

3. .NET 서비스를 다시 시작합니다.

systemctl을 사용해 .NET 애플리케이션을 서비스로 실행할 때, systemctl로 실행되는 모든 서비스에 로드할 환경 변수를 설정할 수도 있습니다.

1. systemctl-Set-environment를 실행하여 필요한 환경 변수를 설정합니다.

   systemctl set-environment CORECLR_ENABLE_PROFILING=1
   systemctl set-environment CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
   systemctl set-environment CORECLR_PROFILER_PATH=/opt/datadog/Datadog.Trace.ClrProfiler.Native.so
   systemctl set-environment DD_DOTNET_TRACER_HOME=/opt/datadog
   
   # Set additional Datadog environment variables
   systemctl set-environment DD_LOGS_INJECTION=true
   systemctl set-environment DD_RUNTIME_METRICS_ENABLED=true
   

2. systemctl show environment를 실행하여 환경 변수가 성공적으로 설정되었는지 확인합니다.

3. 애플리케이션 서비스를 다시 시작합니다.