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.

This is documentation for the next version of Agent. For the latest stable release, go to the latest version.

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:

NameTypeDescriptionDefaultRequired
urlstringURL to poll.yes
methodstringDefine the HTTP method for the request."GET"no
headersmap(string)Custom headers for the request.{}no
poll_frequencydurationFrequency to poll the URL."1m"no
poll_timeoutdurationTimeout 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: