.NET 零代码接入¶

Beacon .NET 提供原生安装包和跨平台 beacon-dotnet 命令。以下示例适用于 x64 Debian 或 Ubuntu；其他系统与架构请在发布页面选择对应安装包。

接入前，请先完成公共配置，开启 DataKit OpenTelemetry 采集器。以下命令以 Linux/macOS Shell 为例，假设应用与 DataKit 部署在同一主机；跨主机或容器部署时，请替换 127.0.0.1 并调整监听地址。

安装¶

从上方发布页面下载适用于 Linux x64 的 .deb 安装包，并保存为当前目录下的 beacon-dotnet.deb，然后执行：

sudo apt install ./beacon-dotnet.deb
beacon-dotnet status

启动¶

export OTEL_SERVICE_NAME=my-dotnet-service
export OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4317
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
beacon-dotnet run dotnet MyApp.dll

run 只对其子进程启用探针。Beacon .NET 当前未提供受支持的用户级持续 Profile 配置，因此无需设置 Profile 环境变量。

调试与诊断¶

先检查安装状态，再指定可写目录保存探针的调试日志：

beacon-dotnet status
mkdir -p beacon-dotnet-logs
OTEL_LOG_LEVEL=debug OTEL_DOTNET_AUTO_LOGGER=file \
  OTEL_DOTNET_AUTO_LOG_DIRECTORY="$PWD/beacon-dotnet-logs" \
  beacon-dotnet run dotnet MyApp.dll

OTEL_DOTNET_AUTO_LOG_DIRECTORY 必须对实际应用进程的运行身份可写。需要在终端查看诊断日志时，可将 OTEL_DOTNET_AUTO_LOGGER 改为 console。

排障后恢复原启动命令；若在服务配置中设置了这些调试变量，请移除并重启应用。

验证接入¶

访问应用接口，产生经过受支持框架或依赖库的请求，再进入观测云「应用性能监测 > 链路」，按上文服务名筛选。完整检查步骤参见公共配置，无数据时参见故障排查。