This version is under construction, please use an official release version

Enterprise Edition

Enterprise Edition

This section documents the Prometheus metrics exposed by KubeLB Enterprise Edition.

Table of Contents

Manager Metrics

Metrics exposed by the KubeLB Manager component (kubelb-manager).

Metric Type Description Labels
kubelb_manager_envoy_proxies Gauge Current number of Envoy proxy deployments namespace, topology
kubelb_manager_envoycp_clusters Gauge Current number of clusters in the Envoy snapshot snapshot_name
kubelb_manager_envoycp_endpoints Gauge Current number of endpoints in the Envoy snapshot snapshot_name
kubelb_manager_envoycp_listeners Gauge Current number of listeners in the Envoy snapshot snapshot_name
kubelb_manager_envoycp_reconcile_duration_seconds Histogram Duration of Envoy control plane reconciliations in seconds -
kubelb_manager_envoycp_reconcile_total Counter Total number of Envoy control plane reconciliation attempts result
kubelb_manager_envoycp_snapshot_updates_total Counter Total number of Envoy snapshot updates snapshot_name
kubelb_manager_loadbalancer_reconcile_duration_seconds Histogram Duration of LoadBalancer reconciliations in seconds namespace
kubelb_manager_loadbalancer_reconcile_total Counter Total number of LoadBalancer reconciliation attempts namespace, result
kubelb_manager_loadbalancers Gauge Current number of LoadBalancer resources namespace, tenant, topology
kubelb_manager_port_allocator_allocated_ports Gauge Current number of allocated ports in the port allocator -
kubelb_manager_port_allocator_endpoints Gauge Current number of endpoints tracked by the port allocator -
kubelb_manager_route_reconcile_duration_seconds Histogram Duration of Route reconciliations in seconds namespace
kubelb_manager_route_reconcile_total Counter Total number of Route reconciliation attempts namespace, route_type, result
kubelb_manager_routes Gauge Current number of Route resources namespace, tenant, route_type
kubelb_manager_sync_secret_reconcile_duration_seconds Histogram Duration of SyncSecret reconciliations in seconds namespace
kubelb_manager_sync_secret_reconcile_total Counter Total number of SyncSecret reconciliation attempts namespace, result
kubelb_manager_tenant_reconcile_duration_seconds Histogram Duration of Tenant reconciliations in seconds -
kubelb_manager_tenant_reconcile_total Counter Total number of Tenant reconciliation attempts result
kubelb_manager_tenants Gauge Current number of Tenant resources -
kubelb_manager_waf_filter_failures_total Counter Total number of WAF filter creation failures namespace, failure_mode
kubelb_manager_waf_policies Gauge Current number of WAFPolicy resources by validity status namespace, status
kubelb_manager_waf_policy_reconcile_duration_seconds Histogram Duration of WAFPolicy reconciliations in seconds name
kubelb_manager_waf_policy_reconcile_total Counter Total number of WAFPolicy reconciliation attempts name, result
kubelb_manager_waf_routes_blocked Gauge Number of routes blocked due to WAF fail-closed mode namespace
kubelb_manager_waf_routes_protected Gauge Number of routes with WAF protection successfully applied namespace

CCM Metrics

Metrics exposed by the KubeLB Cloud Controller Manager component (kubelb-ccm).

Metric Type Description Labels
kubelb_ccm_backendtrafficpolicy_reconcile_duration_seconds Histogram Duration of BackendTrafficPolicy reconciliations in seconds namespace
kubelb_ccm_backendtrafficpolicy_reconcile_total Counter Total number of BackendTrafficPolicy reconciliation attempts namespace, result
kubelb_ccm_clienttrafficpolicy_reconcile_duration_seconds Histogram Duration of ClientTrafficPolicy reconciliations in seconds namespace
kubelb_ccm_clienttrafficpolicy_reconcile_total Counter Total number of ClientTrafficPolicy reconciliation attempts namespace, result
kubelb_ccm_gateway_reconcile_duration_seconds Histogram Duration of Gateway reconciliations in seconds namespace
kubelb_ccm_gateway_reconcile_total Counter Total number of Gateway reconciliation attempts namespace, result
kubelb_ccm_grpcroute_reconcile_duration_seconds Histogram Duration of GRPCRoute reconciliations in seconds namespace
kubelb_ccm_grpcroute_reconcile_total Counter Total number of GRPCRoute reconciliation attempts namespace, result
kubelb_ccm_httproute_reconcile_duration_seconds Histogram Duration of HTTPRoute reconciliations in seconds namespace
kubelb_ccm_httproute_reconcile_total Counter Total number of HTTPRoute reconciliation attempts namespace, result
kubelb_ccm_ingress_reconcile_duration_seconds Histogram Duration of Ingress reconciliations in seconds namespace
kubelb_ccm_ingress_reconcile_total Counter Total number of Ingress reconciliation attempts namespace, result
kubelb_ccm_kubelb_cluster_connected Gauge Whether the CCM is connected to the KubeLB cluster (1=connected, 0=disconnected) -
kubelb_ccm_kubelb_cluster_latency_seconds Histogram Latency of operations to the KubeLB cluster in seconds operation
kubelb_ccm_kubelb_cluster_operations_total Counter Total number of operations performed on the KubeLB cluster operation, result
kubelb_ccm_managed_backendtrafficpolicies Gauge Current number of BackendTrafficPolicies managed by CCM namespace
kubelb_ccm_managed_clienttrafficpolicies Gauge Current number of ClientTrafficPolicies managed by CCM namespace
kubelb_ccm_managed_gateways Gauge Current number of Gateways managed by CCM namespace
kubelb_ccm_managed_grpcroutes Gauge Current number of GRPCRoutes managed by CCM namespace
kubelb_ccm_managed_httproutes Gauge Current number of HTTPRoutes managed by CCM namespace
kubelb_ccm_managed_ingresses Gauge Current number of Ingresses managed by CCM namespace
kubelb_ccm_managed_services Gauge Current number of LoadBalancer services managed by CCM namespace
kubelb_ccm_managed_tcproutes Gauge Current number of TCPRoutes managed by CCM namespace
kubelb_ccm_managed_tlsroutes Gauge Current number of TLSRoutes managed by CCM namespace
kubelb_ccm_managed_udproutes Gauge Current number of UDPRoutes managed by CCM namespace
kubelb_ccm_node_reconcile_duration_seconds Histogram Duration of Node reconciliations in seconds -
kubelb_ccm_node_reconcile_total Counter Total number of Node reconciliation attempts result
kubelb_ccm_nodes Gauge Current number of nodes in the cluster -
kubelb_ccm_service_reconcile_duration_seconds Histogram Duration of Service reconciliations in seconds namespace
kubelb_ccm_service_reconcile_total Counter Total number of Service reconciliation attempts namespace, result
kubelb_ccm_sync_secret_reconcile_duration_seconds Histogram Duration of SyncSecret reconciliations in seconds namespace
kubelb_ccm_sync_secret_reconcile_total Counter Total number of SyncSecret reconciliation attempts namespace, result
kubelb_ccm_tcproute_reconcile_duration_seconds Histogram Duration of TCPRoute reconciliations in seconds namespace
kubelb_ccm_tcproute_reconcile_total Counter Total number of TCPRoute reconciliation attempts namespace, result
kubelb_ccm_tlsroute_reconcile_duration_seconds Histogram Duration of TLSRoute reconciliations in seconds namespace
kubelb_ccm_tlsroute_reconcile_total Counter Total number of TLSRoute reconciliation attempts namespace, result
kubelb_ccm_udproute_reconcile_duration_seconds Histogram Duration of UDPRoute reconciliations in seconds namespace
kubelb_ccm_udproute_reconcile_total Counter Total number of UDPRoute reconciliation attempts namespace, result

EnvoyCP Metrics

Metrics exposed by the KubeLB Envoy Control Plane component.

Metric Type Description Labels
kubelb_envoy_control_plane_cache_clears_total Counter Total number of cache clears snapshot_name
kubelb_envoy_control_plane_cache_hits_total Counter Total number of cache hits for snapshot lookups snapshot_name
kubelb_envoy_control_plane_cache_misses_total Counter Total number of cache misses for snapshot lookups snapshot_name
kubelb_envoy_control_plane_clusters Gauge Current number of clusters in the Envoy snapshot snapshot_name
kubelb_envoy_control_plane_endpoints Gauge Current number of endpoints in the Envoy snapshot snapshot_name
kubelb_envoy_control_plane_envoy_proxies Gauge Current number of Envoy proxy deployments namespace, topology
kubelb_envoy_control_plane_envoy_proxy_create_total Counter Total number of Envoy proxy deployments created namespace
kubelb_envoy_control_plane_envoy_proxy_delete_total Counter Total number of Envoy proxy deployments deleted namespace
kubelb_envoy_control_plane_grpc_connections Gauge Current number of active gRPC connections to the xDS server -
kubelb_envoy_control_plane_grpc_requests_total Counter Total number of gRPC xDS requests type_url
kubelb_envoy_control_plane_grpc_responses_total Counter Total number of gRPC xDS responses type_url
kubelb_envoy_control_plane_listeners Gauge Current number of listeners in the Envoy snapshot snapshot_name
kubelb_envoy_control_plane_routes Gauge Current number of routes in the Envoy snapshot snapshot_name
kubelb_envoy_control_plane_secrets Gauge Current number of secrets in the Envoy snapshot snapshot_name
kubelb_envoy_control_plane_snapshot_generation_duration_seconds Histogram Duration of Envoy snapshot generation in seconds snapshot_name
kubelb_envoy_control_plane_snapshot_updates_total Counter Total number of Envoy snapshot updates snapshot_name
kubelb_envoy_control_plane_snapshots Gauge Current number of active Envoy snapshots -

Label Reference

Common labels used across KubeLB metrics:

Label Description
namespace Kubernetes namespace of the resource
tenant KubeLB tenant identifier
result Reconciliation result: success, error, or skipped
route_type Type of route: ingress, gateway, httproute, grpcroute, tcproute, tlsroute, udproute
topology Envoy proxy topology: shared, dedicated, global
operation Operation type for KubeLB cluster operations
snapshot_name Envoy xDS snapshot identifier
type_url Envoy xDS resource type URL