web

web

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.

Usage

Just make HTTP part of your module configuration.

package example

import "github.com/netdata/go.d.plugin/pkg/web"

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:

jobs:
  - 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"}'
    headers:
      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