应用性能监控全链路版
应用性能监控全链路版
文档指南
请输入
- 文档首页
应用性能监控全链路版用户指南应用性能监控接入指南通过 OpenTelemetry 接入 .NET 应用
复制全文
下载 pdf通过 OpenTelemetry 接入 .NET 应用
文档反馈
问问助手.Net应用在不同场景下有不同的接入方式，本文介绍通过OpenTelemetry进行.Net应用的接入操作，接入后可以实现自动收集Trace信息、自动生成Metric指标、以及调用链检索、日志检索等功能。
OpenTelemetry是CNCF的一个可观测性项目，旨在提供可观测性领域的标准化方案，解决观测数据的数据模型、采集、处理、导出等的标准化问题，提供与三方vendor无关的服务。
如果您的应用已经接入了OpenTelemetry的SDK，APMPlus服务端可以接收OpenTelemetry上报的数据。接入APMPlus后，您将获得RED指标生成能力、Trace多维检索、单链路检索、拓扑生成等多项能力。
说明
使用限制
- OpenTelemetry Metrics转换为Prometheus Metrics时，存在一定限制：
- 与开源相同，不支持ExponentialHistogram。
- 不支持聚合方式为delta的数据。请不要修改SDK侧的默认聚合配置，保证SDK侧数据的聚合方式为cumulative。
- 工作区拥有独立的数据上报凭证，如需使用工作区进行数据管理和数据隔离，请确保 apmplus-opentelemetry-collector 组件已经升级至 v3.1.0 及以上版本。
数据上报
方式一：直接上报至 APMPlus 服务端
可观测数据直接上报至 APMPlus 服务端，支持用户通过 grpc、http/protobuf 等方式进行数据上报。
方式二：Otel Collector 转发【推荐】
APMPlusOpenTelemetryCollector是APMPlus基于OpenTelemetryCollector二次开发的数据采集器。您可以在集群中安装 Opentelemetry Collector 做数据转发，有两种安装方式：
- 通过 VKE 集群组件中心，白屏安装 apmplus-opentelemetry-collector 组件。此外，推荐同时安装 apmplus-server-agent 组件，可以实现主机、进程维度的指标数据采集。
-
- 通过服务接入页面提供的脚本手动安装。
数据接入
方式一：自动埋点
- 使用ASP.NET Core编写Web应用。
- 创建Demo应用。
- 将Properties/launchSettings.json文件中的内容替换成以下配置。
- 构建应用。
- 为应用配置自动埋点。
- Unix-shell
- 下载并执行OpenTelemetry .NET自动埋点安装脚本。
- 设置环境变量并运行OpenTelemetry .NET自动埋点脚本。
说明
- <service_name> 填写服务名，将展现在APMPlus的服务列表里。
- <protocol> 建议填写 grpc。
- <apmplus_endpoint> 按地域（上海、北京...）和接入网络类型（公网、私网）不同，填写地址不同，详情至 apmplus 服务接入页面获取具体的 endpoint。
- <app_key> 填写服务接入控制台提供的app_key。不同工作区对应的 app_key 各不相同，获取方法参见：如何获取应用性能监控的认证信息 AppKey？。
- 更多OpenTelemetry .NET自动埋点的环境变量配置，请参见OpenTelemetry .NET自动埋点环境变量。
- PowerShell
- 下载并执行OpenTelemetry .NET自动埋点安装脚本。
- 设置环境变量并运行OpenTelemetry .NET自动埋点脚本。
说明
- <service_name> 填写服务名，将展现在APMPlus的服务列表里。
- <protocol> 建议填写 grpc。
- <apmplus_endpoint> 按地域（上海、北京...）和接入网络类型（公网、私网）不同，填写地址不同，详情至 apmplus 服务接入页面获取具体的 endpoint。
- <app_key> 填写服务接入控制台提供的app_key。
- 更多OpenTelemetry .NET自动埋点的环境变量配置，请参见OpenTelemetry .NET自动埋点环境变量。
- 运行并访问应用。
- 运行应用。
- 使用以下命令访问应用，生成的调用链会自动上报至APMPlus。
方法二：半自动埋点
- 支持的版本：
- .NET ≥ 5.0
- .NET Core ≥ 2.0
- .NET Framework ≥ 4.6.1
- 创建ASP.NET Core应用（Web应用）。
请将<your-project-name>替换为实际的应用名。
- 下载观测.NET应用必备的OpenTelemetry依赖。
- 下载自动埋点依赖。
- 修改<your-project-name>/Program.cs文件中的代码。
- 在源文件开头导入所需包。
- 添加OpenTelemetry初始化代码。
- 使用gRPC协议上报。
- 请将以下代码中的<grpc_endpoint>和<token>替换成前提条件中获取的接入点信息和Token。
说明
- <service_name> 填写服务名，将展现在APMPlus的服务列表里。
- <apmplus_endpoint> 按地域（上海、北京...）和接入网络类型（公网、私网）不同，填写地址不同，详情至 apmplus 服务接入页面获取具体的 endpoint。
- <app_key> 填写服务接入控制台提供的app_key。
- 在终端执行以下命令运行项目。
返回示例：
在返回信息中获取URL，例如http://localhost:5107。
- 在浏览器中访问http://localhost:5107，返回以下页面则说明数据已上报至APMPlus。
最近更新时间：2026.06.09 14:58:55
这个页面对您有帮助吗？
有用
有用
无用
无用