跳转到内容
搜索文档

指标

最后更新 查看 MarkdownAgent 设置

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

默认指标服务器地址

在非容器化环境中,cloudflared 将指标服务器启动在 127.0.0.1:<PORT>/metrics 上,其中 <PORT>2024120245 范围内第一个可用的端口。如果所有端口都不可用,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.10.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

这篇文档对您有帮助吗?