更新时间: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。
操作步骤
- 登录APM控制台。
- 单击左侧
,选择“管理与监管 > 应用性能管理 APM”,进入APM服务页面。
- 在左侧导航栏中选择“应用监控 > 应用列表”。
- 单击“接入应用”,进入接入应用页面。
图1 接入应用
- 选择“区域”和“应用”。单击“创建应用”,弹出“创建应用”弹窗,可以具体操作参见创建应用。
图2 基础信息
- “接入方式”选择Skywalking或OpenTelemetry。
- “服务端语言”选择.Net。
图3 接入方式
- 根据应用类型选择接入对应的接入方式,按照步骤接入。同一个应用下,组件名称不能重复。
- OpenTelemetry
- 添加 OpenTelemetry 依赖。
dotnet add package OpenTelemetry dotnet add package OpenTelemetry.Exporter.OpenTelemetryProtocol dotnet add package OpenTelemetry.Extensions.Hosting
- 对接OpenTelemetry。
- 入口文件顶部加上如下代码。
using OpenTelemetry; using OpenTelemetry.Resources; using OpenTelemetry.Trace; using OpenTelemetry.Exporter;
- 在入口文件处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; }) );
- 入口文件顶部加上如下代码。
- 添加 OpenTelemetry 依赖。
- Skywalking
- 下载Skywalking。
- 接入sdk。
- 下载配置文件生成工具:SkyAPM.DotNet.CLI:
dotnet tool install -g SkyAPM.DotNet.CLI
- 使用工具生成skyapm.json文件。
dotnet skyapm config 应用名称.组件名称.环境名称 **.**.**.**:***
- 修改skyapm.json中的Authentication
Authentication: "ZvL****Pqe"
- 在项目Properties下的launchSettings.json文件,添加环境变量:ASPNETCORE_HOSTINGSTARTUPASSEMBLIES 和 SKYWALKING__SERVICENAME
environmentVariables: { "SKYWALKING__SERVICENAME": "应用名称.组件名称.环境名称", "ASPNETCORE_HOSTINGSTARTUPASSEMBLIES": "SkyAPM.Agent.AspNetCore" }
- 下载配置文件生成工具:SkyAPM.DotNet.CLI:
- OpenTelemetry
父主题: 开始监控.Net应用