# .Net应用接入APM
#### .Net应用接入APM
1. 登录[APM控制台](https://console.huaweicloud.com/apm2/)。
2. 在左侧导航栏中选择"应用监控 \> 应用列表"。
3. 进入"接入应用"页面。 
   - 首次接入应用时，单击"点击接入应用"，进入"接入应用"页面。
   
   - 已有探针接入时，在页面右上角，单击"接入应用"，进入"接入应用"页面。
   
   
   
   
4. 选择"区域"和"应用"。若未有应用，可单击"创建应用"，弹出"创建应用"弹窗，具体操作请参见[创建应用](https://support.huaweicloud.com/usermanual-apm2/apm_07_0050.html#apm_07_0050__section1684713176449)。
5. "接入方式"选择SkyWalking。
6. "服务端语言"选择.Net。
7. 数据接入。 
   1. 下载SkyWalking。添加库SkyAPM .NET Core Agent，命令如下：
      ```
      dotnet add package SkyAPM.Agent.AspNetCore
      ```
      
   
   2. 接入sdk。
      1. 下载配置文件生成工具：SkyAPM.DotNet.CLI：
         ```
         dotnet tool install -g SkyAPM.DotNet.CLI
         ```
         
      
      2. 使用工具生成skyapm.json文件。
         ```
         dotnet skyapm config 应用名称.组件名称.环境名称 100.79.29.107:11800
         ```
         
      
      3. 修改skyapm.json中的Authentication
         ```
         Authentication: "ZvL****Pqe"
         ```
         
      
      4. 在项目Properties下的launchSettings.json文件，添加环境变量：ASPNETCORE_HOSTINGSTARTUPASSEMBLIES 和 SKYWALKING__SERVICENAME
         ```
         environmentVariables: {
               "SKYWALKING__SERVICENAME": "应用名称.组件名称.环境名称",
               "ASPNETCORE_HOSTINGSTARTUPASSEMBLIES": "SkyAPM.Agent.AspNetCore"
               }
         ```
         
      
      
      表1参数说明 
      | 参数     | 说明                                                                                                  | 是否必填 |
      |:---|:---|:---|
      | 应用名称   | 应用显示的名称。一个应用代表一个逻辑单元，是一个全局概念，各个region都可以看到相同的应用信息，比如一个租户下面比较独立的功能模块可以定义为一个应用。                       | 必填   |
      | 组件名称   | 组件名称，代表一个组件，需要使用英文字符开头。同一个应用下，组件名称不能重复。一个组件可以包含多个环境。不能重复，如果要重复，使用instanceName区分。                    | 必填   |
      | 环境名称   | 环境名称，代表一个应用在一个地方的部署。一个应用程序根据配置不同可以部署多个环境，比如测试环境，现网环境。每个环境都在一个region部署，具有唯一的region属性。该参数可以为空，代表默认环境。 | 选填   |
      | 环境标签   | 环境标签，主要用于环境过滤，多个环境打上相同的环境标签，在web页面上可以通过标签将这些环境过滤出来。该参数可以为空。                                         | 选填   |
      | 应用英文名称 | 应用英文名称，为全局概念。如果填写，则必须提前创建该应用。如果为空，则代表默认应用（开通APM时系统会自动创建一个默认应用）。                                     | 选填   |
      | 子应用    | 子应用，为全局概念，在应用下面子文件夹。该参数可以为空，为空代表资源挂载在根应用下面，子应用最多支持三层。比如 a/b/c，a、b、c各代表一层。                           | 选填   |
      | 用户应用   | 用户所属的应用名称。                                                                                          | 必填   |