OpenTelemetry 项目目前由以下几个主要部分构成:
OpenTelemetry 让你无需使用特定供应商的 SDK 和工具就能生成和导出遥测数据。
本节说明了针对所有实现的跨语言要求和期望。除了术语定义之外,规范还定义了以下内容:
更多信息,请参见规范。
OpenTelemetry Collector 是一个与供应商无关的代理,可以接收、处理和导出遥测数据。 它支持以多种格式接收遥测数据(例如 OTLP、Jaeger、Prometheus 以及许多商业/专有工具)并将数据发送到一个或多个后端。 它还支持在导出之前处理和过滤遥测数据。
更多信息,请参见 Collector。
OpenTelemetry 还提供语言 SDK,允许你使用所选语言的 OpenTelemetry API 生成遥测数据,并将这些数据导出到首选后端。 这些 SDK 还允许你结合常见库和框架的插桩库,以便你可以将其用于应用程序中的手动插桩。
更多信息,请参见插桩操作。
OpenTelemetry 支持通过大量组件来为所支持的语言根据流行的库和框架生成相关遥测数据。 例如,来自 HTTP 库的入站和出站 HTTP 请求将生成有关这些请求的数据。
让流行的库能够开箱即用地进行观测而无需拉入独立的组件中是一个长期目标。
更多信息,请参见插桩库。
Send telemetry to the OpenTelemetry Collector to make sure it’s exported correctly. Using the Collector in production environments is a best practice. To visualize your telemetry, export it to a backend such as Jaeger, Zipkin, Prometheus, or a vendor-specific backend.
The registry contains the list of language specific exporters.
Among exporters, OpenTelemetry Protocol (OTLP) exporters are designed with the OpenTelemetry data model in mind, emitting OTel data without any loss of information. Furthermore, many tools that operate on telemetry data support OTLP (such as Prometheus, Jaeger, and most vendors), providing you with a high degree of flexibility when you need it. To learn more about OTLP, see OTLP Specification.
如果适用,OpenTelemetry 的特定语言实现将提供一种无需修改源代码即可对应用程序进行插桩的方法。 虽然底层机制取决于使用的语言,但至少会将 OpenTelemetry API 和 SDK 能力添加到你的应用程序中。 此外,它们还可能添加一组插桩库和导出器依赖项。
更多信息,请参见零代码插桩。
资源以资源属性表示生成遥测数据的实体。 例如,在 Kubernetes 上运行的容器中生成遥测数据的进程具有 Pod 名称、命名空间和可能的 Deployment 名称。 这三个属性都可以包含在资源中。
OpenTelemetry 的特定语言实现提供了从环境变量 OTEL_RESOURCE_ATTRIBUTES
和许多常见实体(如进程运行时、服务、主机或操作系统)中检测资源的功能。
更多信息,请参见资源。
传播是一种用于跨服务和进程边界传递信息的机制。 虽然不限于跟踪,但它是允许跟踪在跨越进程和网络边界的服务中建立系统因果关系的信息。
对于绝大多数场景,上下文传播是通过插桩库为你完成的。
但如果需要,你可以自己使用 Propagators
来序列化和反序列化跨领域的关注点,
例如 span 的上下文和 baggage。
采样是限制系统生成跟踪数量的过程。 特定语言的实现提供了几种头部采样器。
更多信息,请参见采样。
OpenTelemetry Operator 是 Kubernetes Operator 的一种实现。 Operator 管理 OpenTelemetry Collector 以及使用 OpenTelemetry 对工作负载进行自动插桩。
更多信息,请参见 K8s Operator。
OpenTelemetry 支持多种由不同云服务商提供的函数即服务的监控方法。 OpenTelemetry 社区目前提供预构建的 Lambda 层,能够自动对你的应用进行插桩, 另外在手动或自动对应用进行插桩时可以使用的独立 Collector Lambda 层选项。
更多信息,请参见函数即服务。
Was this page helpful?
Thank you. Your feedback is appreciated!
Please let us know how we can improve this page. Your feedback is appreciated!