Community Edition

This section documents the Prometheus metrics exposed by KubeLB Community 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 -

CCM Metrics

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

Metric Type Description Labels
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_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_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

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
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