トンネルメトリクスは、Cloudflare 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 です。
デフォルトのポートを確認するには、トンネル起動前後の トンネルログ を確認します。例:
2024-12-19T21:17:58Z INF Starting metrics server on 127.0.0.1:20241/metricsカスタムの IP アドレスとポートでメトリクスを公開するには、cloudflared ホストで次の手順を実行します。
-
トンネルを実行 し、
--metricsフラグを付けます。例:cloudflared tunnel --metrics 127.0.0.1:60123 run my-tunnel -
http://localhost:60123/metricsにアクセスし、メトリクスサーバーが動作していることを確認します。これは、localhost の 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 |
各トンネル経由でプロキシしているリクエストの同時数です。 | GAUGE | |
cloudflared_tunnel_ha_connections |
アクティブな HA 接続の数です。 | GAUGE | |
cloudflared_tunnel_request_errors |
オリジンへのプロキシ中に発生したエラー回数です。 | COUNTER | |
cloudflared_tunnel_server_locations |
各トンネルの接続先です。1 は現在のロケーション、0 は以前のロケーションを表します。 |
GAUGE | connection_id、edge_location |
cloudflared_tunnel_timer_retries |
未確認のハートビート数です。 | GAUGE | |
cloudflared_tunnel_total_requests |
すべてのトンネル経由でプロキシしたリクエスト数です。 | COUNTER | |
cloudflared_tunnel_tunnel_authenticate_success |
トンネル認証が成功した回数です。 | COUNTER | |
cloudflared_tunnel_tunnel_register_success |
トンネル登録が成功した回数です。 | COUNTER | rpcName |
cloudflared_udp_active_sessions |
いずれかのオリジンへプロキシ中の UDP セッションの同時数です。 | GAUGE | |
cloudflared_udp_total_sessions |
いずれかのオリジンへプロキシした UDP セッションの合計数です。 | COUNTER | |
coredns_panics_total |
パニックの回数です。 | 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 メトリクスでは、client は接続を開始した側を指します。 | 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 |
OS へ解放したヒープバイト数です。 | GAUGE | |
go_memstats_heap_sys_bytes |
システムから取得したヒープバイト数です。 | GAUGE | |
go_memstats_last_gc_time_seconds |
前回のガベージコレクションの Unix 時刻（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 |