ULB エージェントメトリック | 評価指標と KPI | Unified Load Balancer 構成およびアドミニストレーションガイド、リリース 2026.02

ULB E メールメトリックについて説明し、主要なパラメータ、要件、および参考情報についてまとめています。

ULB エージェントメトリックは次のとおりです。


名前	データタイプ	メトリックタイプ	説明
egressmanagementpolicy_customresource _add_event_total	INT64	カウンタ	受信したエグレス管理ポリシーのカスタムリソース追加イベントの総数。
egressmanagementpolicy_customresource _modify_event_total	INT64	カウンタ	受信したエグレス管理ポリシーのカスタムリソース変更イベントの総数。
egressmanagementpolicy_customresource _delete_event_total	INT64	カウンタ	受信したエグレス管理ポリシーのカスタムリソース削除イベントの総数。
pod_add_event_total	INT64	カウンタ	受信した Pod 追加イベントの総数
pod_add_event_ignore_total	INT64	カウンタ	無視された Pod 追加イベントの総数。
pod_modify_event_total	INT64	カウンタ	受信した Pod 変更イベントの総数
pod_modify_event_ignore_total	INT64	カウンタ	無視された Pod 変更イベントの総数。
pod_delete_event_total	INT64	カウンタ	受信した Pod 削除イベントの総数
node_add_event_total ラベル：component	INT64	カウンタ	受信したノード追加イベントの総数。
node_add_event_ignored_total ラベル：component（値：neigbor）	INT64	カウンタ	無視されたノード追加イベントの総数。
node_modify_event_total ラベル：component（値：neigbor）	INT64	カウンタ	受信したノード変更イベントの総数。
node_modify_event_ignored_total ラベル：component（値：neigbor）	INT64	カウンタ	無視されたノード変更イベントの総数。
node_delete_event_total ラベル：component（値：neigbor）	INT64	カウンタ	受信したノード削除イベントの総数。
loadbalancer_customresource _add_event_total	INT64	カウンタ	受信したロードバランサカスタムリソース追加イベントの総数。
loadbalancer_customresource _delete_event_total	INT64	カウンタ	受信したロードバランサカスタムの削除イベントの総数。
loadbalancer_customresource _modify_event_total	INT64	カウンタ	受信したロードバランサカスタムの変更イベントの総数。
loadbalancer_pod_add_event_total	INT64	カウンタ	受信したロードバランサ。 Pod 追加イベントの総数。
loadbalancer_pod_modify_event_total	INT64	カウンタ	受信したロードバランサ Pod 変更イベントの総数。
loadbalancer_pod_delete_event_total	INT64	カウンタ	受信したロードバランサ Pod 削除イベントの総数。
loadbalancer_pod_add_event _ignored_total	INT64	カウンタ	無視されたロードバランサ Pod 追加イベントの総数。
loadbalancer_pod_modify_event _ignored_total	INT64	カウンタ	無視されたロードバランサ Pod 変更イベントの総数。
loadbalancer_pod_delete_event _ignored_total	INT64	カウンタ	無視されたロードバランサ Pod 削除イベントの総数。
serviceoutboundroute_customresource _add_event_total	INT64	カウンタ	受信したサービスアウトバウンドルートカスタムリソース追加イベントの総数。
serviceoutboundroute_customresource _modify_event_total	INT64	カウンタ	受信したサービスアウトバウンドルートカスタムリソース変更イベントの総数。
serviceoutboundroute_customresource _delete_event_total	INT64	カウンタ	受信したサービスアウトバウンドルートカスタムリソース削除イベントの総数。総数。
serviceoutboundroute_customresource _add_event_ignored_total	INT64	カウンタ	無視されたサービスアウトバウンドルートカスタムリソース追加イベントの総数。
serviceoutboundroute_customresource _modify_event_ignored_total	INT64	カウンタ	無視されたサービスアウトバウンドルートカスタムリソース変更イベントの総数。
serviceoutboundroute_customresource _delete_event_ignored_total	INT64	カウンタ	無視されたサービスアウトバウンドルートカスタムリソース削除イベントの総数。
svc_packet_count ラベル：[svc_ip, svc_name, pod_ip, pod_port, pod_name, protocol, direction]	INT64	カウンタ	サービス IP ごとのパケットの総数。
svc_byte_count ラベル：[svc_ip, svc_name, pod_ip, pod_port, pod_name, protocol, direction]	INT64	カウンタ	サービス IP ごとのバイトの総数。

次の表に、エージェントメトリックの一部に関連付けられたラベルの説明を示します。


ラベル名	ラベルタイプ	説明
svc_ip	文字列	サービスの IP アドレス。
svc-name	文字列	EMP サービスの名前
pod_ip	文字列	バックエンド Pod の IP アドレス
pod_port	文字列	バックエンド Pod で使用されるポート
pod_name	文字列	バックエンド Pod の名前。
protocol	文字列	L4 プロトコル：TCP または UDP
direction	文字列	出入力パケットの方法。

ULBConfig CR 経由でデータパス統計を有効にすると、各 ULB E メールは、プロトコルニュートラル eBPF データパス操作統計を Prometheus に公開します。


名前	データ種別	メトリックタイプ	説明
ulb_dp_rx_total	INT64	ゲージ	構成済みの ULB サービスに帰属する累積パケット観測数を、レポート対象のインターフェイスおよびパケットソース別に分類したもの。
ulb_dp_session_total	INT64	ゲージ	プロトコル定義セッション、接続、またはフロー開始の累積観測数。
ulb_dp_forward_total	INT64	ゲージ	インストゥルメント化 ULB フォワーディングパスイベントの累積数。1 つのパケットを複数のパス値に指定できます。
ulb_dp_ebpf_failures	INT64	ゲージ	理由別にグループ化された、インストゥルメント化されたeBPF 障害イベントの累積数。

次の表では、前述の eBPF データパス運用 ulb_dp_* 統計に関連付けられたラベルについて説明します。


ラベル名	ラベルの種類	説明
app_namespace	文字列	ULB サービスに関連付けられた Kubernetes名前空間。
resource_name	文字列	サービスに関連付けられた ULB リソースの名前。
service_ip	文字列	構成された ULB サービスの IPv4 または IPv6 アドレス。
service_port	文字列	設定済みの ULB サービスに関連付けられたポート。
protocol	文字列	サービスに関連付けられたプロトコル。udp、tcp、sctp、gtpc、gtpu、pfcp などの値は小文字でエクスポートされます。
ifname	文字列	報告されたイベントに関連付けられているネットワークインターフェイスの名前。
source	文字列	パケット送信元の分類。このラベルは、ulb_dp_rx_total に固有です。
path	文字列	フォワーダーパスの分類。このラベルは、ulb_dp_forward_total に固有です。
reason	文字列	インストゥルメント化された eBPF 障害に関連付けられた理由。このラベルは、ulb_dp_ebpf_failures に固有です。

Note

エクスポータは、デフォルトでは、これらの累積スナップショットを 5 分ごとに更新します。統計を有効にしたら、コントローラとエージェントの伝達、エクスポータの更新、および Prometheus によるスクレイプが行われるまで時間を置きます。