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 主机上执行以下步骤:
使用
--metrics标志运行 Tunnel。例如,cloudflared tunnel --metrics 127.0.0.1:60123 run my-tunnel-
通过访问
http://localhost:60123/metrics验证指标服务器是否正在运行。这仅在您配置了本地主机 IP(127.0.0.1或0.0.0.0)时才有效。
您现在可以将指标导出到 Prometheus 和 Grafana,以进行数据可视化和查询。有关如何开始使用这些工具的说明,请参阅 Grafana 教程。
| 名称 | 描述 | 类型 | 标签 |
|---|---|---|---|
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 |
| 名称 | 描述 | 类型 | 标签 |
|---|---|---|---|
promhttp_metric_handler_requests_in_flight |
当前正在提供服务的抓取请求数。 | GAUGE | |
promhttp_metric_handler_requests_total |
按 HTTP 状态代码分类的抓取总数。 | COUNTER | code |
| 名称 | 描述 | 类型 | 标签 |
|---|---|---|---|
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 |