跳转到内容
搜索文档

指标

最后更新 查看 MarkdownAgent 设置

Tunnel 指标可以显示 Cloudflare Tunnel 随着时间推移的吞吐量和资源使用情况。当您运行 Tunnel 时,cloudflared 会启动一个 Prometheus 指标终结点 —— 即一个以 Prometheus ↗ 格式公开指标的 HTTP 服务器。您可以在远程机器上使用 Prometheus 工具包从 cloudflared 服务器抓取指标数据。

默认指标服务器地址

在非容器化环境中,cloudflared 将指标服务器启动在 127.0.0.1:<PORT>/metrics 上,其中 <PORT> 是 20241 到 20245 范围内第一个可用的端口。如果所有端口都不可用,cloudflared 会绑定到一个随机端口。在容器化环境(Docker、Kubernetes)中,默认地址为 0.0.0.0:<PORT>/metrics。

要确定默认端口,请在 Tunnel 启动时左右检查您的 Tunnel 日志。例如:

2024-12-19T21:17:58Z INF Starting metrics server on 127.0.0.1:20241/metrics

配置指标服务器地址

要在自定义 IP 地址和端口上提供指标服务,请在 cloudflared 主机上执行以下步骤:

  1. 使用 --metrics 标志运行 Tunnel。例如,

    cloudflared tunnel --metrics 127.0.0.1:60123 run my-tunnel
  2. 通过访问 http://localhost:60123/metrics 验证指标服务器是否正在运行。这仅在您配置了本地主机 IP(127.0.0.1 或 0.0.0.0)时才有效。

您现在可以将指标导出到 Prometheus 和 Grafana,以进行数据可视化和查询。有关如何开始使用这些工具的说明,请参阅 Grafana 教程。

可用指标

cloudflared 指标

名称 描述 类型 标签
build_info 构建和版本信息。 GAUGE goversion, revision, type, version
cloudflared_config_local_config_pushes 推送到 Cloudflare 的本地配置次数。 COUNTER
cloudflared_config_local_config_pushes_errors 在推送本地配置期间发生的错误次数。 COUNTER
cloudflared_orchestration_config_version 配置版本。 GAUGE
cloudflared_tcp_active_sessions 正在代理到任何源站的并发 TCP 会话数。 GAUGE
cloudflared_tcp_total_sessions 已代理到任何源站的 TCP 会话总数。 COUNTER
cloudflared_tunnel_active_streams 活动数据流的总数。 GAUGE
cloudflared_tunnel_concurrent_requests_per_tunnel 通过每个 Tunnel 代理的并发请求数。 GAUGE
cloudflared_tunnel_ha_connections 活动的高可用(HA)连接数。 GAUGE
cloudflared_tunnel_request_errors 代理到源站时的错误数。 COUNTER
cloudflared_tunnel_server_locations 每个 Tunnel 连接到的位置。1 表示当前位置,0 表示之前的位置。 GAUGE connection_id, edge_location
cloudflared_tunnel_timer_retries 未确认的心跳计数。 GAUGE
cloudflared_tunnel_total_requests 通过所有 Tunnel 代理的请求数。 COUNTER
cloudflared_tunnel_tunnel_authenticate_success 成功进行 Tunnel 身份验证的事件数。 COUNTER
cloudflared_tunnel_tunnel_register_success 成功的 Tunnel 注册次数。 COUNTER rpcName
cloudflared_udp_active_sessions 正在代理到任何源站的并发 UDP 会话数。 GAUGE
cloudflared_udp_total_sessions 已代理到任何源站的 UDP 会话总数。 COUNTER
coredns_panics_total Panic 次数。 COUNTER
quic_client_closed_connections 已关闭的连接数。 COUNTER
quic_client_latest_rtt 在连接上测量到的最新往返时间(RTT)。 GAUGE conn_index
quic_client_lost_packets 从连接中丢失的封包数。 COUNTER conn_index, reason
quic_client_min_rtt 在连接上测量到的最低 RTT(以毫秒为单位)。 GAUGE conn_index
quic_client_packet_too_big_dropped 从源站接收到的、因过大而无法发送到 Cloudflare 并因此被丢弃的封包数。 COUNTER
quic_client_smoothed_rtt 为连接计算的平滑 RTT(以毫秒为单位)。 GAUGE conn_index
quic_client_total_connections 发起的连接数。对于所有 QUIC 指标,客户端指发起连接的一方。 COUNTER

Prometheus 指标

名称 描述 类型 标签
promhttp_metric_handler_requests_in_flight 当前正在提供服务的抓取请求数。 GAUGE
promhttp_metric_handler_requests_total 按 HTTP 状态代码分类的抓取总数。 COUNTER code

Go 运行时指标

名称 描述 类型 标签
go_gc_duration_seconds 垃圾回收周期的暂停持续时间摘要。 SUMMARY
go_goroutines 当前存在的 goroutine 数量。 GAUGE
go_info 有关 Go 环境的信息。 GAUGE version
go_memstats_alloc_bytes 已分配且仍在使用中的字节数。 GAUGE
go_memstats_alloc_bytes_total 分配的字节总数,即使已被释放。 COUNTER
go_memstats_buck_hash_sys_bytes 剖析存储桶哈希表所使用的字节数。 GAUGE
go_memstats_frees_total 释放的总次数。 COUNTER
go_memstats_gc_sys_bytes 用于垃圾回收系统元数据的字节数。 GAUGE
go_memstats_heap_alloc_bytes 已分配且仍在使用中的堆字节数。 GAUGE
go_memstats_heap_idle_bytes 等待被使用的堆字节数。 GAUGE
go_memstats_heap_inuse_bytes 正在使用中的堆字节数。 GAUGE
go_memstats_heap_objects 已分配的对象数。 GAUGE
go_memstats_heap_released_bytes 释放给操作系统的堆字节数。 GAUGE
go_memstats_heap_sys_bytes 从系统获取的堆字节数。 GAUGE
go_memstats_last_gc_time_seconds 自 1970 年以来最后一次垃圾回收的秒数。 GAUGE
go_memstats_lookups_total 指针查找的总次数。 COUNTER
go_memstats_mallocs_total 内存分配(malloc)的总次数。 COUNTER
go_memstats_mcache_inuse_bytes mcache 结构正在使用的字节数。 GAUGE
go_memstats_mcache_sys_bytes 从系统获取的用于 mcache 结构的字节数。 GAUGE
go_memstats_mspan_inuse_bytes mspan 结构正在使用的字节数。 GAUGE
go_memstats_mspan_sys_bytes 从系统获取的用于 mspan 结构的字节数。 GAUGE
go_memstats_next_gc_bytes 下一次垃圾回收发生时的堆字节数。 GAUGE
go_memstats_other_sys_bytes 用于其他系统分配的字节数。 GAUGE
go_memstats_stack_inuse_bytes 栈分配器正在使用的字节数。 GAUGE

这篇文档对您有帮助吗?