Skip to content

netbox-community/netbox-healthcheck-plugin

Repository files navigation

NetBox HealthCheck Plugin

NetBox plugin for HealthCheck.

NetBox provides health check monitors that can be queried to make sure that the service is running in good condition.

NetBox exposes metrics at the /healthcheck HTTP endpoint under the plugin, e.g. https://netbox.local/plugins/netbox_healthcheck_plugin/healthcheck/. It allows monitor conditions via HTTP(S), with responses available in HTML and JSON formats.

Features

The features the plugin provides should be listed here.

Compatibility

NetBox Version Plugin Version
3.4 - 3.7 0.1.0
3.4 - 3.7 0.1.2
3.4 - 3.7 0.1.3
4.0. 0.2.0

Installing

For adding to a NetBox Docker setup see the general instructions for using netbox-docker with plugins.

While this is still in development and not yet on pypi you can install with pip:

pip install git+https://github.com/netbox-community/netbox-healthcheck-plugin

or by adding to your local_requirements.txt or plugin_requirements.txt (netbox-docker):

git+https://github.com/netbox-community/netbox-healthcheck-plugin

Enable the plugin in /opt/netbox/netbox/netbox/configuration.py, or if you use netbox-docker, your /configuration/plugins.py file :

PLUGINS = [
    'netbox_healthcheck_plugin'
]

PLUGINS_CONFIG = {
    "netbox_healthcheck_plugin": {},
}

Setting up Monitoring

NetBox makes use of the django-health-check library, more information on setting up monitors can be found at Setting up Monitoring:

Credits

Based on the NetBox plugin tutorial:

This package was created with Cookiecutter and the netbox-community/cookiecutter-netbox-plugin project template.