.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跟踪程序日志的目录/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

为应用添加 .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 应用添加自定义探针：

1. 在应用程序代码中，通过Datadog.Trace.Tracer.Instance属性访问全局跟踪器以创建新的 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引用：

   [Service]
   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. 重启应用服务。