OBI 导出的指标

了解 OBI 可以导出的 HTTP/gRPC 指标。

下表描述了以 OpenTelemetry 和 Prometheus 格式导出的指标。

系列名称 (OTel)名称 (Prometheus)类型单位描述
应用程序http.client.request.durationhttp_client_request_duration_secondsHistogram客户端发起的 HTTP 服务调用持续时间
应用程序http.client.request.body.sizehttp_client_request_body_size_bytesHistogram字节客户端发送的 HTTP 请求体大小
应用程序http.client.response.body.sizehttp_client_response_body_size_bytesHistogram字节客户端发送的 HTTP 响应体大小
应用程序http.server.request.durationhttp_server_request_duration_secondsHistogram服务端接收的 HTTP 服务调用持续时间
应用程序http.server.request.body.sizehttp_server_request_body_size_bytesHistogram字节服务端接收的 HTTP 请求体大小
应用程序http.server.response.body.sizehttp_server_response_body_size_bytesHistogram字节服务端接收的 HTTP 响应体大小
应用程序rpc.client.durationrpc_client_duration_secondsHistogram客户端发起的 gRPC 服务调用持续时间
应用程序rpc.server.durationrpc_server_duration_secondsHistogram服务端接收的 RPC 服务调用持续时间
应用程序sql.client.durationsql_client_duration_secondsHistogramSQL 客户端操作的持续时间(实验性)
应用程序redis.client.durationredis_client_duration_secondsHistogramRedis 客户端操作的持续时间(实验性)
应用程序messaging.publish.durationmessaging_publish_durationHistogram消息(Kafka)发布操作的持续时间(实验性)
应用程序messaging.process.durationmessaging_process_durationHistogram消息(Kafka)处理操作的持续时间(实验性)
网络obi.network.flow.bytesobi_network_flow_bytesCounter字节从源网络端点流向目标网络端点的字节数
网络obi.network.inter.zone.bytesobi_network_inter_zone_bytesCounter字节在您的集群中流经不同可用区之间的字节数(实验性,目前仅在 Kubernetes 中可用)

OBI 还可以导出 Span 指标Service graph 指标,您可以通过 features 配置选项启用它们。

OBI 指标的属性

为简洁起见,此列表中的指标和属性使用 OTel dot.notation。使用 Prometheus 导出器时,指标使用 underscore_notation

要配置显示哪些属性或隐藏哪些属性,请查看 配置文档 中的 attributes->select 部分。

指标名称默认值
应用程序(全部)http.request.method显示
应用程序(全部)http.response.status_code显示
应用程序(全部)http.route如果存在 routes 配置部分,则显示
应用程序(全部)k8s.daemonset.name如果启用了 Kubernetes 元数据,则显示
应用程序(全部)k8s.deployment.name如果启用了 Kubernetes 元数据,则显示
应用程序(全部)k8s.namespace.name如果启用了 Kubernetes 元数据,则显示
应用程序(全部)k8s.node.name如果启用了 Kubernetes 元数据,则显示
应用程序(全部)k8s.owner.name如果启用了 Kubernetes 元数据,则显示
应用程序(全部)k8s.pod.name如果启用了 Kubernetes 元数据,则显示
应用程序(全部)k8s.container.name如果启用了 Kubernetes 元数据,则显示
应用程序(全部)k8s.pod.start_time如果启用了 Kubernetes 元数据,则显示
应用程序(全部)k8s.pod.uid如果启用了 Kubernetes 元数据,则显示
应用程序(全部)k8s.replicaset.name如果启用了 Kubernetes 元数据,则显示
应用程序(全部)k8s.statefulset.name如果启用了 Kubernetes 元数据,则显示
应用程序(全部)k8s.cluster.name如果启用了 Kubernetes 元数据,则显示
应用程序(全部)service.name显示
应用程序(全部)service.namespace显示
应用程序(全部)target.instance显示
应用程序(全部)url.path隐藏
应用程序(客户端)server.address隐藏
应用程序(客户端)server.port隐藏
应用程序 rpc.*rpc.grpc.status_code显示
应用程序 rpc.*rpc.method显示
应用程序 rpc.*rpc.system显示
应用程序(服务端)client.address隐藏
obi.network.flow.bytesobi.ip隐藏
db.client.operation.durationdb.operation.name显示
db.client.operation.durationdb.collection.name隐藏
messaging.publish.durationmessaging.system显示
messaging.publish.durationmessaging.destination.name显示
messaging.process.durationmessaging.system显示
messaging.process.durationmessaging.destination.name显示
obi.network.flow.bytesclient.port隐藏
obi.network.flow.bytesdirection隐藏
obi.network.flow.bytesdst.address隐藏
obi.network.flow.bytesdst.cidr如果存在 cidrs 配置部分,则显示
obi.network.flow.bytesdst.name隐藏
obi.network.flow.bytesdst.port隐藏
obi.network.flow.bytesdst.zone(仅限 Kubernetes)隐藏
obi.network.flow.bytesiface隐藏
obi.network.flow.bytesk8s.cluster.name如果启用了 Kubernetes,则显示
obi.network.flow.bytesk8s.dst.name隐藏
obi.network.flow.bytesk8s.dst.namespace如果启用了 Kubernetes,则显示
obi.network.flow.bytesk8s.dst.node.ip隐藏
obi.network.flow.bytesk8s.dst.node.name隐藏
obi.network.flow.bytesk8s.dst.owner.type隐藏
obi.network.flow.bytesk8s.dst.type隐藏
obi.network.flow.bytesk8s.dst.owner.name如果启用了 Kubernetes,则显示
obi.network.flow.bytesk8s.src.name隐藏
obi.network.flow.bytesk8s.src.namespace如果启用了 Kubernetes,则显示
obi.network.flow.bytesk8s.src.node.ip隐藏
obi.network.flow.bytesk8s.src.owner.name如果启用了 Kubernetes,则显示
obi.network.flow.bytesk8s.src.owner.type隐藏
obi.network.flow.bytesk8s.src.type隐藏
obi.network.flow.bytesserver.port隐藏
obi.network.flow.bytessrc.address隐藏
obi.network.flow.bytessrc.cidr如果存在 cidrs 配置部分,则显示
obi.network.flow.bytessrc.name隐藏
obi.network.flow.bytessrc.port隐藏
obi.network.flow.bytessrc.zone(仅限 Kubernetes)隐藏
obi.network.flow.bytestransport隐藏
跟踪(SQL、Redis)db.query.text隐藏

内部指标

OBI 可以 配置为报告内部指标(Prometheus 格式)。

名称类型描述
obi_ebpf_tracer_flushesHistogram从 eBPF 跟踪器刷新到下一个管道阶段的跟踪组的长度
obi_metric_exports_totalCounter提交到远程 OTel 收集器的指标批次的长度
obi_metric_export_errors_totalCounterVec每次 OTel 指标导出失败的错误计数,按错误类型区分
obi_trace_exports_totalCounter提交到远程 OTel 收集器的跟踪批次的长度
obi_trace_export_errors_totalCounterVec每次 OTel 跟踪导出失败的错误计数,按错误类型区分
obi_prometheus_http_requests_totalCounterVec请求 Prometheus Scrape 端点的数量,按 HTTP 端口和路径进行分面
obi_instrumented_processesGaugeVecOBI 仪器化的进程,按进程名称区分
obi_internal_build_infoGaugeVecOBI 二进制文件的版本信息,包括构建时间和提交哈希

最后修改于 2025 年 8 月 11 日:迁移 beyla 文档以支持 OBI (#7399) (c6df1ca9)