.NET Framework 服务实现监控可观测性最佳实践

字数 2289阅读 452评论 0赞 0

## 环境信息

* 系统环境：Windows Server
* 开发语言：.NET Framework >= 4.6.1
* APM探针包：ddtrace

## 准备工作

### 安装 Datakit

主机部署： [https://docs.guance.com/datakit/datakit-install/](https://docs.guance.com/datakit/datakit-install/)

### 打开采集 APM 采集器

Windows 主机配置

# 到如下路径，把ddtrace.conf.sample 拷贝一份命名为ddtrace.conf即可
    C:\\Program Files\\datakit\\conf.d\\ddtrace
    
## 接入方案

### 修改本地环境变量

点击此电脑右键——属性——高级系统设置——环境变量，新建系统变量，输入如下内容：

DD_TRACE_AGENT_URL=http://localhost:9529    （必填）
    DD_SERVICE=myapp   # 举例 myappname          （必填）
    DD_ENV=test   # 举例 test                    （可选）
    DD_VERSION=1.0   #举例 1.0                   /（可选）
    DD_TRACE_SERVICE_MAPPING=  # 举例 mysql:main-mysql-db    （可选）
    DD_LOGS_INJECTION=true    # 开启注入ddtrace日志（可选）
    SET DD_RUNTIME_METRICS_ENABLED=true  # runtime 指标（可选）
    
* TRACE_AGENT_URL：数据上传 IP 加端口，需填为 [http://localhost:9529](http://localhost:9529/) ，需填写 DatKit 实际的端口
* ENV：系统环境，可根据需求设置为 pro 或者 test 或其他内容
* SERVICE：平台上所展现的应用名称，可设置为具体服务名称
* VERSION：版本号，可根据需要进行设置
* TRACE_SERVICE_MAPPING：使用配置重命名服务，以便在观测云平台上与其他业务系统调用的组件进行区分展示。接受要重命名的服务名称键的映射，以及要使用的名称，格式为 [from-key]:[to-name]
  * 注意：[from-key] 内容为标准字段，例如 mysql、redis、mongodb、oracle，请勿进行自定义更改
  * 示例：TRACE_SERVICE_MAPPING=mysql:main-mysql-db，TRACE_SERVICE_MAPPING=mongodb:offsite-mongodb-service
 
 如下图：注意这里的变量跟变量值，如上面配置等号左边是 key ，右边是 value 。
 
![](https://learning.guance.com/uploads/1_f2a69b8b66.png)

### 下载探针（建议 2.4.3 版本）

* x64 架构 : [https://github.com/DataDog/dd-trace-dotnet/releases/download/v2.4.3/datadog-dotnet-apm-2.4.3-x64.msi](https://github.com/DataDog/dd-trace-dotnet/releases/download/v2.4.3/datadog-dotnet-apm-2.4.3-x64.msi)
* x86 架构 : [https://github.com/DataDog/dd-trace-dotnet/releases/download/v2.4.3/datadog-dotnet-apm-2.4.3-x86.msi](https://github.com/DataDog/dd-trace-dotnet/releases/download/v2.4.3/datadog-dotnet-apm-2.4.3-x86.msi)

### 使用管理员权限运行探针

必须 管理员权限 运行 dotnet-agent 安装包，点击下一步，直到安装成功。

![](https://learning.guance.com/uploads/2_d2479952a5.png)

### 重启 IIS 服务，使得配置生效

在 PowerShell 执行如下命令，重启 iis

net stop /y was
    net start w3svc
    
### DataKit 机器上查看数据

输入：datakit monitor

![](https://learning.guance.com/uploads/3_3f1473b280.png)

## 实践效果

![](https://learning.guance.com/uploads/7_7d320e02db.jpg)

![](https://learning.guance.com/uploads/8_c3e969b4f9.jpg)

.net

著作权归作者所有

如果觉得我的文章对您有用，请点赞。您的支持将鼓励我继续创作！

添加新评论0 条评论

Ctrl+Enter 发表

匿名评论

.NET Framework 服务实现监控可观测性最佳实践

添加新评论0 条评论

文章目录展开目录

作者其他文章