Kuma integration metrics

The official Datadog integration for monitoring Kuma. It collects 132 metrics.

Definitions as of 2026-09-02

Official summary

Collect metrics and logs from Kuma, a service mesh for Kubernetes and VMs. Kuma is the community version of Kong Mesh.

Metric types

count (occurrences in the interval): 93
gauge (value at a point in time): 39

Metrics

Descriptions are the official definitions, unedited.

Metric	Type	Unit
`kuma.api_server.http_request_duration_seconds.bucket`The latency of API HTTP requests. (bucket)	count	-
`kuma.api_server.http_request_duration_seconds.count`The latency of API HTTP requests. (count)	count	request
`kuma.api_server.http_request_duration_seconds.sum`The latency of API HTTP requests. (sum)	count	second
`kuma.api_server.http_requests_inflight`The number of inflight requests being handled simultaneously.	gauge	request
`kuma.api_server.http_response_size_bytes.bucket`The size of API HTTP responses. (bucket)	count	-
`kuma.api_server.http_response_size_bytes.count`The size of API HTTP responses. (count)	count	-
`kuma.api_server.http_response_size_bytes.sum`The size of API HTTP responses. (sum)	count	byte
`kuma.ca_manager.get_cert.count`CA manager get certificate latencies. (count)	count	-
`kuma.ca_manager.get_cert.sum`CA manager get certificate latencies. (sum)	count	second
`kuma.ca_manager.get_root_cert_chain.count`CA manager get CA root certificate chain latencies. (count)	count	-
`kuma.ca_manager.get_root_cert_chain.sum`CA manager get CA root certificate chain latencies. (sum)	count	second
`kuma.cert_generation.count`Number of generated certificates.	count	-
`kuma.certwatcher.read_certificate.errors_total.count`Total number of certificate read errors.	count	error
`kuma.certwatcher.read_certificate.total.count`Total number of certificate reads.	count	read
`kuma.cla_cache`Cluster Load Assignment cache operations.	gauge	operation
`kuma.component.catalog_writer.count`Inter CP Catalog Writer component interval. (count)	count	-
`kuma.component.catalog_writer.quantile`Inter CP Catalog Writer component interval. (quantile)	gauge	second
`kuma.component.catalog_writer.sum`Inter CP Catalog Writer component interval. (sum)	count	second
`kuma.component.heartbeat.count`Inter CP Heartbeat component interval. (count)	count	-
`kuma.component.heartbeat.quantile`Inter CP Heartbeat component interval. (quantile)	gauge	second
`kuma.component.heartbeat.sum`Inter CP Heartbeat component interval. (sum)	count	second
`kuma.component.hostname_generator.count`Hostname generator interval. (count)	count	-
`kuma.component.hostname_generator.quantile`Hostname generator interval. (quantile)	gauge	second
`kuma.component.hostname_generator.sum`Hostname generator interval. (sum)	count	second
`kuma.component.ms_status_updater.count`Inter CP Heartbeat component interval. (count)	count	-
`kuma.component.ms_status_updater.quantile`Inter CP Heartbeat component interval. (quantile)	gauge	second
`kuma.component.ms_status_updater.sum`Inter CP Heartbeat component interval. (sum)	count	second
`kuma.component.mzms_status_updater.count`MeshMultizoneService Updater component. (count)	count	operation
`kuma.component.mzms_status_updater.quantile`MeshMultizoneService Updater component. (quantile)	gauge	operation
`kuma.component.mzms_status_updater.sum`MeshMultizoneService Updater component. (sum)	count	operation
`kuma.component.store_counter.count`Store Counter component interval. (count)	count	-
`kuma.component.store_counter.quantile`Store Counter component interval. (quantile)	gauge	second
`kuma.component.store_counter.sum`Store Counter component interval. (sum)	count	second
`kuma.component.sub_finalizer.count`Subscription finalizer component interval. (count)	count	-
`kuma.component.sub_finalizer.quantile`Subscription finalizer component interval. (quantile)	gauge	second
`kuma.component.sub_finalizer.sum`Subscription finalizer component interval. (sum)	count	second
`kuma.component.vip_allocator.count`Virtual IP allocation duration. (count)	count	-
`kuma.component.vip_allocator.quantile`Virtual IP allocation duration. (quantile)	gauge	second
`kuma.component.vip_allocator.sum`Virtual IP allocation duration. (sum)	count	second
`kuma.component.zone_available_services.count`Available services tracker component interval. (count)	count	-
`kuma.component.zone_available_services.quantile`Available services tracker component interval. (quantile)	gauge	second
`kuma.component.zone_available_services.sum`Available services tracker component interval. (sum)	count	second
`kuma.controller_runtime.active_workers`Number of currently used workers per controller.	gauge	worker
`kuma.controller_runtime.max_concurrent_reconciles`Maximum number of concurrent reconciles per controller.	gauge	-
`kuma.controller_runtime.reconcile.errors_total.count`Total number of reconciliation errors per controller.	count	error
`kuma.controller_runtime.reconcile.panics_total.count`Total number of reconciliation panics per controller.	count	-
`kuma.controller_runtime.reconcile.time_seconds.bucket`Length of time per reconciliation per controller. (bucket)	count	-
`kuma.controller_runtime.reconcile.time_seconds.count`Length of time per reconciliation per controller. (count)	count	-
`kuma.controller_runtime.reconcile.time_seconds.sum`Length of time per reconciliation per controller. (sum)	count	second
`kuma.controller_runtime.reconcile.total.count`Total number of reconciliations per controller.	count	-
`kuma.controller_runtime.terminal_reconcile.errors_total.count`Total number of terminal reconciliation errors per controller.	count	error
`kuma.controller_runtime.webhook.latency_seconds.bucket`Histogram of the latency of processing admission requests. (bucket)	count	-
`kuma.controller_runtime.webhook.latency_seconds.count`Histogram of the latency of processing admission requests. (count)	count	-
`kuma.controller_runtime.webhook.latency_seconds.sum`Histogram of the latency of processing admission requests. (sum)	count	second
`kuma.controller_runtime.webhook.panics_total.count`Total number of webhook panics.	count	-
`kuma.controller_runtime.webhook.requests_in_flight`Current number of admission requests being served.	gauge	-
`kuma.controller_runtime.webhook.requests_total.count`Total number of admission requests by HTTP status code.	count	request
`kuma.cp_info`Static information about the CP instance.	gauge	-
`kuma.dp_server.http_request_duration_seconds.bucket`The latency of the HTTP requests. (bucket)	count	-
`kuma.dp_server.http_request_duration_seconds.count`The latency of the HTTP requests. (count)	count	-
`kuma.dp_server.http_request_duration_seconds.sum`The latency of the HTTP requests. (sum)	count	second
`kuma.dp_server.http_requests_inflight`The number of inflight requests being handled at the same time.	gauge	request
`kuma.dp_server.http_response_size_bytes.bucket`The size of the HTTP responses. (bucket)	count	-
`kuma.dp_server.http_response_size_bytes.count`The size of the HTTP responses. (count)	count	-
`kuma.dp_server.http_response_size_bytes.sum`The size of the HTTP responses. (sum)	count	byte
`kuma.events.dropped.count`Number of dropped events in event bus due to full channels.	count	event
`kuma.go.gc.duration_seconds.count`Wall-time pause (stop-the-world) duration in garbage collection cycles. (count)	count	-
`kuma.go.gc.duration_seconds.quantile`Wall-time pause (stop-the-world) duration in garbage collection cycles. (quantile)	gauge	second
`kuma.go.gc.duration_seconds.sum`Wall-time pause (stop-the-world) duration in garbage collection cycles. (sum)	count	second
`kuma.go.goroutines`Number of goroutines that currently exist.	gauge	-
`kuma.go.memstats.alloc_bytes`Number of bytes allocated in heap and currently in use.	gauge	byte
`kuma.go.threads`Number of OS threads created.	gauge	thread
`kuma.grpc.server.handled_total.count`Total number of RPCs completed on the server, regardless of success or failure.	count	request
`kuma.grpc.server.handling_seconds.bucket`Histogram of response latency (seconds) of gRPC that had been application-level handled by the server. (bucket)	count	-
`kuma.grpc.server.handling_seconds.count`Histogram of response latency (seconds) of gRPC that had been application-level handled by the server. (count)	count	-
`kuma.grpc.server.handling_seconds.sum`Histogram of response latency (seconds) of gRPC that had been application-level handled by the server. (sum)	count	second
`kuma.grpc.server.msg_received_total.count`Total number of gRPC stream messages received on the server.	count	message
`kuma.grpc.server.msg_sent_total.count`Total number of gRPC stream messages sent by the server.	count	message
`kuma.grpc.server.started_total.count`Total number of RPCs started on the server.	count	request
`kuma.insights_resyncer.event_time_processing.count`The time spent to process an event. (count)	count	-
`kuma.insights_resyncer.event_time_processing.quantile`The time spent to process an event. (quantile)	gauge	second
`kuma.insights_resyncer.event_time_processing.sum`The time spent to process an event. (sum)	count	second
`kuma.insights_resyncer.event_time_to_process.count`The time between an event being added to a batch and it being processed, in a well behaving system this should be less of equal to the MinResyncInterval. (count)	count	-
`kuma.insights_resyncer.event_time_to_process.quantile`The time between an event being added to a batch and it being processed, in a well behaving system this should be less of equal to the MinResyncInterval. (quantile)	gauge	second
`kuma.insights_resyncer.event_time_to_process.sum`The time between an event being added to a batch and it being processed, in a well behaving system this should be less of equal to the MinResyncInterval. (sum)	count	second
`kuma.insights_resyncer.processor_idle_time.count`The time that the processor loop sits idle, the closer this gets to 0 the more the processing loop is at capacity. (count)	count	-
`kuma.insights_resyncer.processor_idle_time.quantile`The time that the processor loop sits idle, the closer this gets to 0 the more the processing loop is at capacity. (quantile)	gauge	second
`kuma.insights_resyncer.processor_idle_time.sum`The time that the processor loop sits idle, the closer this gets to 0 the more the processing loop is at capacity. (sum)	count	second
`kuma.leader`Indicates if this instance is the leader (1 for leader).	gauge	-
`kuma.leader_election.master_status`Gauge of if the reporting system is master of the relevant lease, 0 indicates backup, 1 indicates master. 'kuma_name' is the tag used to indentify the lease.	gauge	-
`kuma.mesh_cache`Mesh context cache operations for XDS resource optimization.	gauge	operation
`kuma.process.cpu_seconds_total.count`Total user and system CPU time spent in seconds.	count	second
`kuma.process.max_fds`Maximum number of open file descriptors.	gauge	-
`kuma.process.network.receive_bytes_total.count`Number of bytes received by the process over the network.	count	byte
`kuma.process.network.transmit_bytes_total.count`Number of bytes sent by the process over the network.	count	byte
`kuma.process.open_fds`Number of open file descriptors.	gauge	-
`kuma.process.resident_memory_bytes`Resident memory size in bytes.	gauge	byte
`kuma.process.start_time_seconds`Start time of the process since unix epoch in seconds.	gauge	second
`kuma.process.virtual_memory_bytes`Virtual memory size in bytes.	gauge	byte
`kuma.process.virtual_memory_max_bytes`Maximum amount of virtual memory available in bytes.	gauge	byte
`kuma.promhttp.metric_handler.requests_in_flight`Current number of scrapes being served.	gauge	request
`kuma.promhttp.metric_handler.requests_total.count`Total number of scrapes by HTTP status code.	count	request
`kuma.resources_count`Number of Kuma resources by type and zone.	gauge	-
`kuma.rest_client.requests_total.count`Number of HTTP requests, partitioned by status code, method, and host.	count	request
`kuma.store.bucket`Store operations. (bucket)	count	operation
`kuma.store.count`Store operations. (count)	count	operation
`kuma.store.sum`Store operations. (sum)	count	operation
`kuma.store_cache.count`Resource store cache operations (Get/List) to reduce database load.	count	item
`kuma.store_conflicts.count`Store conflicts while updating.	count	-
`kuma.vip_generation.count`Virtual IP generation. (count)	count	-
`kuma.vip_generation.sum`Virtual IP generation. (sum)	count	-
`kuma.vip_generation_errors.count`Errors during Virtual IP generation.	count	error
`kuma.workqueue.adds_total.count`Total number of adds handled by workqueue.	count	item
`kuma.workqueue.depth`Current depth of workqueue.	gauge	item
`kuma.workqueue.longest_running_processor_seconds`How many seconds has the longest running processor for workqueue been running.	gauge	second
`kuma.workqueue.queue_duration_seconds.bucket`How long in seconds an item stays in workqueue before being requested. (bucket)	count	-
`kuma.workqueue.queue_duration_seconds.count`How long in seconds an item stays in workqueue before being requested. (count)	count	-
`kuma.workqueue.queue_duration_seconds.sum`How long in seconds an item stays in workqueue before being requested. (sum)	count	second
`kuma.workqueue.retries_total.count`Total number of retries handled by workqueue.	count	-
`kuma.workqueue.unfinished_work_seconds`How many seconds of work has been done that is in progress and hasn't been observed by work_duration. Large values indicate stuck threads. One can deduce the number of stuck threads by observing the rate at which this increases.	gauge	second
`kuma.workqueue.work_duration_seconds.bucket`How long in seconds processing an item from workqueue takes. (bucket)	count	-
`kuma.workqueue.work_duration_seconds.count`How long in seconds processing an item from workqueue takes. (count)	count	-
`kuma.workqueue.work_duration_seconds.sum`How long in seconds processing an item from workqueue takes. (sum)	count	second
`kuma.xds.delivery.count`XDS config delivery including response (ACK/NACK) from client. (count)	count	-
`kuma.xds.delivery.sum`XDS config delivery including response (ACK/NACK) from client. (sum)	count	second
`kuma.xds.generation.count`XDS Snapshot generation. (count)	count	-
`kuma.xds.generation.quantile`XDS Snapshot generation. (quantile)	gauge	second
`kuma.xds.generation.sum`XDS Snapshot generation. (sum)	count	second
`kuma.xds.generation_errors.count`Errors during XDS generation.	count	error
`kuma.xds.requests_received.count`Number of confirmations requests from a client.	count	request
`kuma.xds.responses_sent.count`Number of responses sent by the server to a client.	count	response
`kuma.xds.streams_active`Number of active connections between a server and a client.	gauge	connection

Official documentation

Official documentation for the Kuma integration

Metric names and descriptions are the official Datadog integration definitions (Copyright Datadog, Inc., BSD-3-Clause), reproduced unedited. The full license terms are on the About page.

Official summary

Metric types

Metrics

Official documentation

Related products

Other Kubernetes integrations