RIPE Atlas Ping Measurement
atlas_measure_pingSend ICMP echo requests from distributed RIPE Atlas probes to a target host to measure network reachability and latency. Customize probe selection, packet parameters, and address family.
Instructions
Create a ping measurement on the RIPE Atlas network.
Sends ICMP echo requests from distributed probes worldwide to a target host.
Args:
target (string): Target hostname or IP address
af (4|6): Address family (default: 4)
packets (1-16): Number of packets (default: 3)
size (1-2048): Packet size in bytes (default: 48)
probe_count (1-1000): Number of probes (default: 5)
from_country/from_asn/from_prefix/from_area/from_probes: Probe selection
is_oneoff (bool): One-shot measurement (default: true)
response_format ('json'|'markdown'): Output format
Returns: Measurement ID(s) and link to results.
Requires: RIPE_ATLAS_API_KEY with 'create measurement' permission.
Input 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 to send (1-16, default: 3) | |
| size | No | Packet size in bytes excluding headers (1-2048, default: 48) | |
| packet_interval | No | Time between packets in ms (2-30000, default: 1000) |