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

Community Edition

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

Table of Contents
Manager Metrics
CCM Metrics
EnvoyCP Metrics
Label Reference

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

Community Edition

Table of Contents

Manager Metrics

CCM Metrics

EnvoyCP Metrics

Label Reference