文档首页/ 应用性能管理 APM/ 用户指南(2.0)/ 接入APM/ 增强型、OpenTelemetry以及SkyWalking方式接入APM实现性能指标监控/ SkyWalking方式接入APM实现指标监控/ .Net应用接入APM
更新时间:2026-10-20 GMT+08:00
.Net应用接入APM
.Net应用接入APM
- 登录APM控制台。
- 在左侧导航栏中选择“应用监控 > 应用列表”。
- 进入“接入应用”页面。
- 首次接入应用时,单击“点击接入应用”,进入“接入应用”页面。
- 已有探针接入时,在页面右上角,单击“接入应用”,进入“接入应用”页面。
- 选择“区域”和“应用”。若未有应用,可单击“创建应用”,弹出“创建应用”弹窗,具体操作请参见创建应用。
- “接入方式”选择SkyWalking。
- “服务端语言”选择.Net。
- 数据接入。
- 下载SkyWalking。添加库SkyAPM .NET Core Agent,命令如下:
dotnet add package SkyAPM.Agent.AspNetCore
- 接入sdk。
- 下载配置文件生成工具:SkyAPM.DotNet.CLI:
dotnet tool install -g SkyAPM.DotNet.CLI
- 使用工具生成skyapm.json文件。
dotnet skyapm config 应用名称.组件名称.环境名称 100.79.29.107:11800
- 修改skyapm.json中的Authentication
Authentication: "ZvL****Pqe"
- 在项目Properties下的launchSettings.json文件,添加环境变量:ASPNETCORE_HOSTINGSTARTUPASSEMBLIES 和 SKYWALKING__SERVICENAME
environmentVariables: { "SKYWALKING__SERVICENAME": "应用名称.组件名称.环境名称", "ASPNETCORE_HOSTINGSTARTUPASSEMBLIES": "SkyAPM.Agent.AspNetCore" }
表1 参数说明 参数
说明
是否必填
Authentication
鉴权信息,获取信息方式请参见查看应用信息中获取“APPKEY”的值。
必填
SKYWALKING__SERVICENAME
应用标识,三段式命名:应用名称.组件名称.环境名称。
- 应用名称,一个应用代表一个逻辑单元,是一个全局概念,各个region都可以看到相同的应用信息,比如一个租户下面比较独立的功能模块可以定义为一个应用。
- 组件名称,代表一个组件,需要使用英文字符开头。同一个应用下,组件名称不能重复。一个组件可以包含多个环境。不能重复,如果要重复,使用instanceName区分。
- 环境名称,代表一个应用在一个地方的部署。一个应用程序根据配置不同可以部署多个环境,比如测试环境,现网环境。每个环境都在一个region部署,具有唯一的region属性。该参数可以为空,代表默认环境。
必填
- 下载配置文件生成工具:SkyAPM.DotNet.CLI:
- 下载SkyWalking。添加库SkyAPM .NET Core Agent,命令如下: