Caution
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.
integrations_config
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
:
# Controls the Agent integration
agent:
# 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 integration
apache_http: <apache_http_config>
# Controls the node_exporter integration
node_exporter: <node_exporter_config>
# Controls the process_exporter integration
process_exporter: <process_exporter_config>
# Controls the mysqld_exporter integration
mysqld_exporter: <mysqld_exporter_config>
# Controls the oracledb integration
oracledb: <oracledb_config>
# Controls the redis_exporter integration
redis_exporter: <redis_exporter_config>
# Controls the dnsmasq_exporter integration
dnsmasq_exporter: <dnsmasq_exporter_config>
# Controls the elasticsearch_exporter integration
elasticsearch_exporter: <elasticsearch_exporter_config>
# Controls the memcached_exporter integration
memcached_exporter: <memcached_exporter_config>
# Controls the mssql integration
mssql: <mssql_config>
# Controls the postgres_exporter integration
postgres_exporter: <postgres_exporter_config>
# Controls the snmp_exporter integration
snmp_exporter: <snmp_exporter_config>
# Controls the snowflake integration
snowflake: <snowflake_config>
# Controls the statsd_exporter integration
statsd_exporter: <statsd_exporter_config>
# Controls the consul_exporter integration
consul_exporter: <consul_exporter_config>
# Controls the windows_exporter integration
windows_exporter: <windows_exporter_config>
# Controls the kafka_exporter integration
kafka_exporter: <kafka_exporter_config>
# Controls the mongodb_exporter integration
mongodb_exporter: <mongodb_exporter_config>
# Controls the github_exporter integration
github_exporter: <github_exporter_config>
# Controls the blackbox_exporter integration
blackbox: <blackbox_config>
# Controls the CloudWatch exporter integration
cloudwatch_exporter: <cloudwatch_exporter_config>
# Controls the azure_exporter integration
azure_exporter: <azure_exporter_config>
# Controls the gcp_exporter integration
gcp_exporter: <gcp_exporter_config>
# Controls the squid integration
squid: <squid_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>]