快速接入Agent

操作步骤

1. 登录APM控制台。
2. 单击左侧，选择“管理与监管 > 应用性能管理 APM”，进入APM服务页面。
3. 在左侧导航栏中选择“应用监控 > 应用列表”。
4. 单击“接入应用”，进入接入应用页面。
   图1 接入应用
   

5. 选择“区域”和“应用”。单击“创建应用”，弹出“创建应用”弹窗，可以具体操作参见创建应用。
   图2 基础信息
   

6. “接入方式”选择Skywalking或OpenTelemetry。
7. “服务端语言”选择.Net。
   图3 接入方式
   

8. 根据应用类型选择接入对应的接入方式，按照步骤接入。同一个应用下，组件名称不能重复。
   • OpenTelemetry
     1. 添加 OpenTelemetry 依赖。

        dotnet add package OpenTelemetry
        dotnet add package OpenTelemetry.Exporter.OpenTelemetryProtocol
        dotnet add package OpenTelemetry.Extensions.Hosting

     2. 对接OpenTelemetry。
        1. 入口文件顶部加上如下代码。

           using OpenTelemetry;
           using OpenTelemetry.Resources;
           using OpenTelemetry.Trace;
           using OpenTelemetry.Exporter;

        2. 在入口文件处WebApplication.CreateBuilder()之后，builder.Build()之前加入下面的内容。

           builder.Services.AddOpenTelemetry()
             .ConfigureResource(resource => resource
                 .AddService(应用名称.组件名称.环境名称)
                 .AddAttributes(new Dictionary<string, object> {
                     ["host.name"] = System.Net.Dns.GetHostName()
                 })
             )
             .WithTracing(tracing => tracing
                 .AddAspNetCoreInstrumentation()
                 .AddOtlpExporter(opt => {
                     opt.Endpoint = new Uri(**.**.**.**:***);
                     opt.Headers = "Authentication=" + 8e***04x;
                     opt.Protocol = OtlpExportProtocol.Grpc;
                 })
             );

   • Skywalking
     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 应用名称.组件名称.环境名称 **.**.**.**:***

        3. 修改skyapm.json中的Authentication

           Authentication: "ZvL****Pqe"

        4. 在项目Properties下的launchSettings.json文件，添加环境变量：ASPNETCORE_HOSTINGSTARTUPASSEMBLIES 和 SKYWALKING__SERVICENAME

           environmentVariables: {
                 "SKYWALKING__SERVICENAME": "应用名称.组件名称.环境名称",
                 "ASPNETCORE_HOSTINGSTARTUPASSEMBLIES": "SkyAPM.Agent.AspNetCore"
                 }