C#(.net)¶
视图预览¶
安装部署¶
DF默认支持所有采用opentracing协议的APM监控手段,例如<skywalking><jaeger><zipkin>等,此处官方推荐ddtrace接入方式,ddtrace为开源的APM监控方式,相较于其他方式,支持更多的自定义字段,也就意味着可以有足够多的标签与其他的组件进行关联,ddtrace具体接入方式详细如下:
前置条件¶
- 需要进行链路追踪的应用服务器<安装 Datakit>
- 下载ddtrace-.net-agent,可根据需求下载x86、arm64或者其他版本的agent。
- <ddtrace -.net -agent 框架兼容列表>
配置实施¶
.net所有的部署方式均是在应用启动的环境变量中添加 ddtrace-agent 相关启动参数。
开启datakit.conf中链路追踪inputs¶
(必须开启)
###########--------linux环境---------##########
cd /usr/local/datakit/conf.d/
cd /ddtrace
cp ddtrace.conf.sample ddtrace.conf
## 复制完文件后,vim进入编辑模式,放开imputs的注释
## 举例:ddtrace tags相关注释可根据需要进行开启操作,添加业务或其他相关的标签
#默认无需修改
vim ddtrace.conf
wq!
## 重启datakit
systemctl restart datakit
ddtrace相关环境变量(启动参数)释义:¶
可根据需要进行添加
- TRACE_AGENT_URL为数据上传IP加端口,需填为http://localhost:9529,不建议更改
- ENV为系统环境,可根据需求设置为pro或者test或其他内容
- SERVICE为设置df平台上所展现的应用名称,可设置为具体服务名称
- VERSION为版本号,可根据需要进行设置
- TRACE_SERVICE_MAPPING 使用配置重命名服务,以便在df平台上与其他业务系统调用的组件进行区分展示。接受要重命名的服务名称键的映射,以及要使用的名称,格式为[from-key]:[to-name]
注意:[from-key]内容为标准字段,例如mysql、redis、mongodb、oracle,请勿进行自定义更改 示例:TRACE_SERVICE_MAPPING=mysql:main-mysql-db TRACE_SERVICE_MAPPING=mongodb:offsite-mongodb-service
添加服务器环境变量¶
## 点击 此电脑右键——属性——高级系统设置——环境变量
## 新建系统变量——输入如下内容
DD_TRACE_AGENT_URL=http://localhost:9529 (必填)
DD_ENV= 举例 test (可选)
DD_SERVICE= 举例 myappname (必填)
DD_VERSION= 举例 1.0 (可选)
DD_TRACE_SERVICE_MAPPING= 举例 mysql:main-mysql-db (可选)
添加服务器环境变量¶
以管理员权限运行dotnet-agent安装包,点击下一步,直到安装成功。
在 PowerShell 执行如下命令,重启 iis¶
链路分析¶
场景视图¶
DF 平台已内置 应用性能监测模块,无需手动创建
监控规则¶
暂无
相关术语说明¶
最佳实践¶
故障排查¶
暂无