更新时间:2025-09-28 GMT+08:00
分享

快速接入Agent

  • 部署APM Agent时,必须确保接入APM的机器与APM服务网络连通,Agent才能正常工作。可使用“curl -kv”命令测试目标机器与APM服务器网络是否连通。例如,以检查华北-北京四区域,且接入方式为“Skywalking”的连通性为例,请登录应用所部署的机器,并输入命令curl -kv 100.125.2.112:11800,其他区域或源代码的地址请参考探针接入地址
  • 本语言支持Skywalking和OpenTelemetry。

操作步骤

  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"
                } 

相关文档