Skip to content

Latest commit

 

History

History
 
 

httpcheck

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 

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

Configuration

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.

server:
  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 https://docs.python.org/3/howto/regex.html
  redirect: yes                 # optional

Notes

  • 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.

analytics