Menu
Caution
Grafana Alloy is the new name for our distribution of the OTel collector. Grafana Agent has been deprecated and is in Long-Term Support (LTS) through October 31, 2025. Grafana Agent will reach an End-of-Life (EOL) on November 1, 2025. Read more about why we recommend migrating to Grafana Alloy.
Open source
import.http
import.http
retrieves a module from an HTTP server.
Usage
river
import.http "LABEL" {
url = URL
}
Arguments
The following arguments are supported:
Name | Type | Description | Default | Required |
---|---|---|---|---|
url | string | URL to poll. | yes | |
method | string | Define the HTTP method for the request. | "GET" | no |
headers | map(string) | Custom headers for the request. | {} | no |
poll_frequency | duration | Frequency to poll the URL. | "1m" | no |
poll_timeout | duration | Timeout when polling the URL. | "10s" | no |
Example
This example imports custom components from an HTTP response and instantiates a custom component for adding two numbers:
river
declare "add" {
argument "a" {}
argument "b" {}
export "sum" {
value = argument.a.value + argument.b.value
}
}
river
import.http "math" {
url = SERVER_URL
}
math.add "default" {
a = 15
b = 45
}
Was this page helpful?
Related resources from Grafana Labs
Additional helpful documentation, links, and articles:
Video
Getting started with Grafana dashboard design
In this webinar, you'll learn how to design stylish and easily accessible Grafana dashboards that tell a story.
Video
Building advanced Grafana dashboards
In this webinar, we’ll demo how to build and format Grafana dashboards.
Video
Intro to Alerting with Grafana
Master alerting with Grafana: Navigate the complexities, reduce false positives, and boost reliability for your systems.