Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/grafana-cloud/send-data/alloy/troubleshoot/controller_metrics.md, or by sending Accept: text/markdown to https://grafana.com/docs/grafana-cloud/send-data/alloy/troubleshoot/controller_metrics/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
Monitor the Grafana Alloy component controller
The Alloy component controller exposes Prometheus metrics which you can use to investigate the controller state.
Metrics for the controller are exposed at the /metrics HTTP endpoint of the Alloy HTTP server, which defaults to listening on http://localhost:12345.
The documentation for the
alloy runcommand describes how to modify the address Alloy listens on for HTTP traffic.
The controller exposes the following metrics:
alloy_component_controller_evaluating(Gauge): Set to1whenever the component controller is evaluating components. This value may be misrepresented depending on how fast evaluations complete or how often evaluations occur.alloy_component_controller_running_components(Gauge): The current number of running components by health. The health is represented in thehealth_typelabel.alloy_component_evaluation_seconds(Histogram): The time it takes to evaluate components after one of their dependencies is updated.alloy_component_dependencies_wait_seconds(Histogram): Time spent by components waiting to be evaluated after one of their dependencies is updated.alloy_component_evaluation_queue_size(Gauge): The current number of component evaluations waiting to be performed.
Was this page helpful?
Related resources from Grafana Labs


