Grafana Alloy is the new name for our distribution of the OTel collector.
Grafana Agent has been deprecated and is in Long-Term Support (LTS) through October 31, 2025.
Grafana Agent will reach an End-of-Life (EOL) on November 1, 2025.
Read more about why we recommend migrating to Grafana Alloy.
Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.
The integrations_config block configures how the Agent runs integrations that
scrape and send metrics without needing to run specific Prometheus exporters or
manually write scrape_configs:
yaml
# Controls the Agent integrationagent:# Enables the Agent integration, allowing the Agent to automatically# collect and send metrics about itself.[enabled: <boolean>| default = false]# Sets an explicit value for the instance label when the integration is# self-scraped. Overrides inferred values.## The default value for this integration is inferred from the agent hostname# and HTTP listen port, delimited by a colon.[instance: <string>]# Automatically collect metrics from this integration. If disabled,# the agent integration will be run but not scraped and thus not# remote_written. Metrics for the integration will be exposed at# /integrations/agent/metrics and can be scraped by an external process.[scrape_integration: <boolean>| default = <integrations_config.scrape_integrations>]# How often should the metrics be collected? Defaults to# prometheus.global.scrape_interval.[scrape_interval: <duration>| default = <global_config.scrape_interval>]# The timeout before considering the scrape a failure. Defaults to# prometheus.global.scrape_timeout.[scrape_timeout: <duration>| default = <global_config.scrape_timeout>]# How frequent to truncate the WAL for this integration.[wal_truncate_frequency: <duration>| default = "60m"]# Allows for relabeling labels on the target.relabel_configs:[- <relabel_config>...]# Relabel metrics coming from the integration, allowing to drop series# from the integration that you don't care about.metric_relabel_configs:[- <relabel_config>...]# Client TLS Configuration# Client Cert/Key Values need to be defined if the server is requesting a certificate# (Client Auth Type = RequireAndVerifyClientCert || RequireAnyClientCert).http_tls_config: <tls_config># Controls the apache_http integrationapache_http: <apache_http_config># Controls the node_exporter integrationnode_exporter: <node_exporter_config># Controls the process_exporter integrationprocess_exporter: <process_exporter_config># Controls the mysqld_exporter integrationmysqld_exporter: <mysqld_exporter_config># Controls the redis_exporter integrationredis_exporter: <redis_exporter_config># Controls the dnsmasq_exporter integrationdnsmasq_exporter: <dnsmasq_exporter_config># Controls the elasticsearch_exporter integrationelasticsearch_exporter: <elasticsearch_exporter_config># Controls the memcached_exporter integrationmemcached_exporter: <memcached_exporter_config># Controls the postgres_exporter integrationpostgres_exporter: <postgres_exporter_config># Controls the snmp_exporter integrationsnmp_exporter: <snmp_exporter_config># Controls the snowflake integrationsnowflake: <snowflake_config># Controls the statsd_exporter integrationstatsd_exporter: <statsd_exporter_config># Controls the consul_exporter integrationconsul_exporter: <consul_exporter_config># Controls the windows_exporter integrationwindows_exporter: <windows_exporter_config># Controls the kafka_exporter integrationkafka_exporter: <kafka_exporter_config># Controls the mongodb_exporter integrationmongodb_exporter: <mongodb_exporter_config># Controls the github_exporter integrationgithub_exporter: <github_exporter_config># Controls the blackbox_exporter integrationblackbox: <blackbox_config># Automatically collect metrics from enabled integrations. If disabled,# integrations will be run but not scraped and thus not remote_written. Metrics# for integrations will be exposed at /integrations/<integration_key>/metrics# and can be scraped by an external process.[scrape_integrations: <boolean>| default = true]# Extra labels to add to all samples coming from integrations.labels:{<string>: <string>}# The period to wait before restarting an integration that exits with an# error.[integration_restart_backoff: <duration>| default = "5s"]# A list of remote_write targets. Defaults to global_config.remote_write.# If provided, overrides the global defaults.prometheus_remote_write:-[<remote_write>]