RIPE Atlas HTTP Measurement
atlas_measure_httpCreate HTTP measurements from distributed probes to a target web server. Configure method, path, port, and probe selection to test web performance and availability.
Instructions
Create an HTTP measurement on the RIPE Atlas network.
Makes HTTP requests from distributed probes to a target web server.
Args:
target (string): Target hostname or IP
method ('GET'|'HEAD'|'POST'): HTTP method (default: GET)
path (string): URL path (default: '/')
port (1-65535): Port (default: 80)
version (string): HTTP version (default: '1.1')
header_bytes: Max header bytes to capture
body_bytes: Max body bytes to capture
timing_verbosity (0|1|2): Detail level
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 | 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 | |
| port | No | Port number (default: 80) | |
| header_bytes | No | Max bytes to retrieve from response header (0=no limit) | |
| version | No | HTTP version (e.g. '1.0', '1.1') | 1.1 |
| method | No | HTTP method | GET |
| path | No | URL path (default: '/') | / |
| query_string | No | Query string to append to path | |
| user_agent | No | Custom User-Agent header | |
| body_bytes | No | Max bytes to retrieve from response body (0=no limit) | |
| timing_verbosity | No | Timing detail: 0=none, 1=basic, 2=per-read |