Skip to main content

HTTP endpoint monitoring with Netdata

Monitors remote http server for availability and response time.

Following charts are drawn per job:

  1. Response time ms

    • Time in 0.1 ms resolution in which the server responds. If the connection failed, the value is missing.
  2. Status boolean

    • Connection successful
    • Unexpected content: No Regex match found in the response
    • Unexpected status code: Do we get 500 errors?
    • Connection failed: port not listening or blocked
    • Connection timed out: host or port unreachable


Edit the python.d/httpcheck.conf configuration file using edit-config from the Netdata config directory, which is typically at /etc/netdata.

cd /etc/netdata # Replace this path with your Netdata config directory, if different
sudo ./edit-config python.d/httpcheck.conf

Sample configuration and their default values.

url: 'http://host:port/path' # required
status_accepted: # optional
- 200
timeout: 1 # optional, supports decimals (e.g. 0.2)
update_every: 3 # optional
regex: 'REGULAR_EXPRESSION' # optional, see
redirect: yes # optional


  • The status chart is primarily intended for alarms, badges or for access via API.
  • A system/service/firewall might block Netdata's access if a portscan or similar is detected.
  • This plugin is meant for simple use cases. Currently, the accuracy of the response time is low and should be used as reference only.

Reach out

If you need help after reading this doc, search our community forum for an answer. There's a good chance someone else has already found a solution to the same issue.



Last updated on