For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.
Control plane metrics
View and reference control plane metrics that are emitted by the agentgateway controller.
The agentgateway control plane exposes Prometheus-compatible metrics on port 9092. These metrics reflect the health and activity of the Kubernetes controller, such as how many resources have been reconciled, how long reconciliations take, and whether the controller is keeping the XDS snapshot in sync with the proxy.
Control plane metrics cannot be customized. To set up automatic scraping of these metrics with Prometheus, see Enable metrics scraping.
View control plane metrics
Port-forward the control plane deployment.
kubectl port-forward -n agentgateway-system deployment/agentgateway 9092:9092Query the metrics endpoint.
curl http://localhost:9092/metricsExample output:
# HELP agentgateway_controller_reconciliations_total Total number of controller reconciliations # TYPE agentgateway_controller_reconciliations_total counter agentgateway_controller_reconciliations_total{controller="gateway",result="success"} 1 agentgateway_controller_reconciliations_total{controller="gatewayclass",result="success"} 2 agentgateway_controller_reconciliations_total{controller="gatewayclass-provisioner",result="success"} 2Enable metrics scraping for control plane metrics with the OTel stack so that you can export and visualize metrics in monitoring tools, such as Prometheus and Grafana. For more information, see Scrape metrics for querying and visualization.
Control plane metrics reference
Review the metrics that are emitted by the agentgateway control plane.
| Name | Type | Labels | Help |
|---|---|---|---|
| agentgateway_controller_reconcile_duration_seconds | histogram | controller, name, namespace | Reconcile duration for controller |
| agentgateway_controller_reconciliations_running | gauge | controller, name, namespace | Number of reconciliations currently running |
| agentgateway_controller_reconciliations_total | counter | controller, name, namespace, result | Total number of controller reconciliations |
| agentgateway_xds_auth_rq_failure_total | counter | Total number of failed xDS auth requests | |
| agentgateway_xds_auth_rq_success_total | counter | Total number of successful xDS auth requests | |
| agentgateway_xds_auth_rq_total | counter | Total number of xDS auth requests | |
| agentgateway_xds_rejects_total | counter | Total number of xDS responses rejected by agentgateway proxy |
