可观测性能力升级，Apache APISIX 集成 OpenTelemetry

API7.ai 技术团队

关注

最新推荐文章于 2026-08-13 09:33:15 发布 · 2.7k 阅读

原创

本文为博客 VIP 文章，开通 VIP 后可阅读全文

开通 VIP

本文为您介绍 Apache APISIX opentelemetry 插件概念以及如何如何开启和部署 opentelemetry 插件。

背景信息

Apache APISIX 是一个动态、实时、高性能的 API 网关，提供负载均衡、动态上游、灰度发布、服务熔断、身份认证、可观测性等丰富的流量管理功能。作为 API 网关，Apache APISIX 不仅拥有众多实用的插件，而且支持插件动态变更和热插拔。

OpenTelemetry 是一个开源的遥测数据采集和处理系统，它不仅提供了各种 SDK 用于应用端遥测数据的收集和上报，以及数据收集端用于数据接收、加工和导出，还支持通过配置导出到任意一个或者多个已经适配 OpenTelemetry Exporter 的后端，比如 Jaeger、Zipkin、OpenCensus 等。您可以在 opentelemetry collector contrib 库中查看已经适配 OpenTelemetry Collector 的插件列表。

error/OpenTelemetry

插件介绍

Apache APISIX opentelemetry 插件是基于 OpenTelemetry 原生标准（OTLP/HTTP）实现的 Tracing 数据采集，并通过 HTTP 协议发送至 OpenTelemetry Collector。该功能将在 Apache APISIX 2.13.0 版本中上线支持。

由于 OpenTelemetry 的 Agent/SDK 与后端实现无关，当应用集成了 OpenTelemetry 的 Agent/SDK 之后，用户能够在应用侧无感知的情况下轻松地、自由地变更可观测性后端服务，比如从 Zipkin 切换成 Jaeger。

opentelemetry 插件在 Apache APISIX 中集成了 OpenTelemetry Agent/SDK，可以实现采集被追踪的请求生成 trace 后转发到 OpenTelemetry Collector。

opentelemetry 插件位于上图中的 Agent 侧，但目前仅支持 trace 协议，还不支持 OpenTelemetry 的 logs 和 metrics 协议。

如何使用

启用插件

您需要在 conf/config.yaml 配置文件中启用 opentelemetry 插件并修改 collector 配置。

假设您已经完成 OpenTelemetry Collector 的部署，并且启用了 OTLP HTTP Receiver。

如果您未完成部署，可参考下一节的场景示例部分，完成 OpenTelemetry Collector 的部署。

其中 OTLP HTTP Receiver 的默认端口为4318，collector 的地址为 OpenTelemetry Collector 的 HTTP Receiver 地址，相关字段可参考 Apache APISIX 官方文档。

plugins
... # 已经启用的其它插件
- opentelemetry
plugin_attr:
...
openteleme

最低0.47元/天解锁文章

标签

#kafka #apache #zookeeper

企业级微服务配置治理：基于Registry、路由与可观测性的MCP规模化实践微服务配置管理是分布式系统架构中的核心基础组件，其核心在于实现配置的集中化、动态化与安全分发。随着企业微服务规模的增长，配置源数量激增、环境隔离复杂、安全管控与变更风险等问题凸显，传统的直接连接模式难以应对，亟需体系化的治理方案。其技术价值在于通过解耦服务发现、精细化流量调度与全链路可观测，构建高可用、易扩展的配置治理基座，从而保障大规模生产环境下服务的稳定运行与快速迭代。典型的应用场景包括多团队协作、多环境（开发、测试、生产）与全球多地域部署的复杂微服务架构。本文聚焦于微服务配置协议（MCP）在企业级场景阅读详情