RIPE Atlas DNS Measurement
atlas_measure_dnsCreate DNS measurements on the RIPE Atlas network to query DNS records from distributed probes. Supports custom resolvers, record types, and flags.
Instructions
Create a DNS measurement on the RIPE Atlas network.
Performs DNS lookups from distributed probes. Can query specific DNS servers or use the probe's local resolver.
Args:
query_argument (string): DNS name to query (e.g. 'example.com')
query_type: Record type (A, AAAA, MX, NS, SOA, TXT, CNAME, DNSKEY, etc.)
target (string, optional): DNS server to query. Omit to use probe's resolver.
set_rd_bit: Recursion Desired (default: true)
set_do_bit: DNSSEC OK flag
set_cd_bit: DNSSEC Checking Disabled
set_nsid_bit: Request Name Server ID
protocol ('UDP'|'TCP'): Transport (default: UDP)
probe_count, from_country, etc.: Probe selection
Returns: Measurement ID(s).
Requires: RIPE_ATLAS_API_KEY with 'create measurement' permission.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target | No | Target DNS server IP/hostname. If omitted, the probe's resolver is used. | |
| af | No | Address family: 4 for IPv4, 6 for IPv6 | |
| description | No | Human-readable description of the measurement | |
| is_oneoff | No | If true (default), run once. If false, run periodically at 'interval' | |
| interval | No | Interval in seconds between measurements (only used when is_oneoff=false) | |
| resolve_on_probe | No | Resolve DNS names on probe instead of RIPE servers | |
| tags | No | Tags to apply to the measurement | |
| response_format | No | Output format: 'json' for structured data or 'markdown' for human-readable | json |
| probe_count | No | Number of probes to use (1-1000, default: 5) | |
| from_country | No | Two-letter ISO country code to select probes from (e.g. 'DE', 'US') | |
| from_asn | No | ASN number to select probes from | |
| from_prefix | No | IP prefix to select probes from (e.g. '193.0.0.0/21') | |
| from_area | No | Geographic area to select probes from | |
| from_probes | No | Comma-separated list of specific probe IDs to use | |
| include_tags | No | Only include probes with these tags (e.g. ['system-ipv6-works']) | |
| exclude_tags | No | Exclude probes with these tags | |
| query_argument | Yes | DNS name to query (e.g. 'example.com') | |
| query_type | No | DNS query type (default: A) | A |
| query_class | No | DNS query class (default: IN) | IN |
| set_rd_bit | No | Set Recursion Desired flag | |
| set_do_bit | No | Set DNSSEC OK flag (RFC3225) | |
| set_cd_bit | No | Set DNSSEC Checking Disabled flag (RFC4035) | |
| set_nsid_bit | No | Include EDNS Name Server ID request | |
| udp_payload_size | No | EDNS UDP payload size (512-4096) | |
| protocol | No | Transport protocol for DNS query | UDP |
| retry | No | Number of retries |