RIPE Atlas Traceroute Measurement
atlas_measure_tracerouteTraces the network path from distributed probes to a target using ICMP, UDP, or TCP. Supports customizable hop limits, Paris traceroute, and probe selection by country or ASN.
Instructions
Create a traceroute measurement on the RIPE Atlas network.
Traces the network path from distributed probes to a target, showing each hop.
Args:
target (string): Target hostname or IP
protocol ('ICMP'|'UDP'|'TCP'): Protocol (default: ICMP)
max_hops (1-255): Max TTL (default: 32)
paris (0-64): Paris traceroute mode (default: 16, 0=standard)
port (1-65535): Destination port (TCP only)
probe_count, from_country, etc.: Probe selection
Returns: Measurement ID(s).
Requires: RIPE_ATLAS_API_KEY with 'create measurement' permission.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target | Yes | Target hostname or IP address | |
| 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 | |
| packets | No | Number of packets per hop (1-16, default: 3) | |
| size | No | Packet size in bytes (1-2048, default: 48) | |
| protocol | No | Protocol to use: ICMP, UDP, or TCP | ICMP |
| timeout | No | Timeout per packet in ms | |
| dont_fragment | No | Set Don't Fragment flag | |
| paris | No | Paris traceroute variant (0=standard, 1-64=Paris, default: 16) | |
| first_hop | No | First TTL hop (1-255, default: 1) | |
| max_hops | No | Maximum TTL hops (1-255, default: 32) | |
| port | No | Destination port (TCP only) | |
| destination_option_size | No | IPv6 destination option header size | |
| hop_by_hop_option_size | No | IPv6 hop-by-hop option header size |