Skip to main content


This package contains HTTP related configurations (Request, Client and HTTP structs) and functions to create http.Request and http.Client from them.

HTTP embeds both Request and Client.

Every module that collects metrics doing HTTP requests should use HTTP. It allows to have same set of user configurable options across all modules.

Configuration options

HTTP request options:

  • url: the URL to access.
  • username: the username for basic HTTP authentication.
  • password: the password for basic HTTP authentication.
  • proxy_username: the username for basic HTTP authentication of a user agent to a proxy server.
  • proxy_password: the password for basic HTTP authentication of a user agent to a proxy server.
  • body: the HTTP request body to be sent by the client.
  • method: the HTTP method (GET, POST, PUT, etc.).
  • headers: the HTTP request header fields to be sent by the client.

HTTP client options:

  • timeout: the HTTP request time limit.
  • not_follow_redirects: the policy for handling redirects.
  • proxy_url: the URL of the proxy to use.
  • tls_skip_verify: controls whether a client verifies the server's certificate chain and host name.
  • tls_ca: certificate authority to use when verifying server certificates.
  • tls_cert: tls certificate to use.
  • tls_key: tls key to use.


Just make HTTP part of your module configuration.

package example

import ""

type Config struct {
web.HTTP `yaml:",inline"`

type Example struct {
Config `yaml:",inline"`

func (e *Example) Init() bool {
httpReq, err := web.NewHTTPRequest(e.Request)
if err != nil {
// ...
return false

httpClient, err := web.NewHTTPClient(e.Client)
if err != nil {
// ...
return false

// ...
return true

Having HTTP embedded your configuration inherits all configuration options:

- name: name
url: url
username: username
password: password
proxy_url: proxy_url
proxy_username: proxy_username
proxy_password: proxy_password
timeout: 1
method: GET
body: '{"key": "value"}'
X-API-Key: key
not_follow_redirects: no
tls_skip_verify: no
tls_ca: path/to/ca.pem
tls_cert: path/to/cert.pem
tls_key: path/to/key.pem

Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.