discovery.dns
discovery.dns
discovers scrape targets from DNS records.
Usage
discovery.dns "<LABEL>" {
names = ["<NAME_1>", "<NAME_2>", ...]
}
Arguments
You can use the following arguments with discovery.dns
:
Blocks
The discovery.dns
component doesn’t support any blocks. You can configure this component with arguments.
Exported fields
The following field is exported and can be referenced by other components:
Each target includes the following labels:
__meta_dns_mx_record_target
: Target field of the MX record.__meta_dns_name
: Name of the record that produced the discovered target.__meta_dns_ns_record_target
: Target field of the NS record.__meta_dns_srv_record_port
: Port field of the SRV record.__meta_dns_srv_record_target
: Target field of the SRV record.
Component health
discovery.dns
is only reported as unhealthy when given an invalid configuration.
In those cases, exported fields retain their last healthy values.
Debug information
discovery.dns
doesn’t expose any component-specific debug information.
Debug metrics
discovery.dns
doesn’t expose any component-specific debug metrics.
Example
This example discovers targets from an A record.
Replace the following:
<PROMETHEUS_REMOTE_WRITE_URL>
: The URL of the Prometheus remote_write-compatible server to send metrics to.<USERNAME>
: The username to use for authentication to theremote_write
API.<PASSWORD>
: The password to use for authentication to theremote_write
API.
Compatible components
discovery.dns
has exports that can be consumed by the following components:
- Components that consume Targets
Note
Connecting some components may not be sensible or components may require further configuration to make the connection work correctly. Refer to the linked documentation for more details.