Nagios plugin to check JSON attributes via http(s)

This fork is currently unmaintained. Please use one of the other forks for a better experience (e.g.


Nagios plugin to check JSON attributes via http(s).

This Plugin is a fork of the existing JSON Plugin from with the enhancements of using the Nagios::Plugin Perl Module, allowing to use thresholds and performance data collection from various json attributes.

Performance data is also enhanced to extract performance data compliant to Nagios and Graphite standards. One attribute is selected for thresholds check, multiple others can be added for extracting performance data. This plugin is aimed at simplifying Nagios, Icinga & Icinga2 polling of JSON status APIs.


check_json -u|--url  -a|--attribute  [ -c|--critical  ] [ -w|--warning  ] [ -p|--perfvars  ] [ -o|--outputvars  ] [ -t|--timeout  ] [ -d|--divisor  ] [ -T|--contenttype  ] [ --ignoressl ] [ -h|--help ]


./ --url --attribute '{shares}->{dead_shares}' --warning :5 --critical :10 --perfvars '{shares}->{dead_shares},{shares}->{live_shares},{clients}->{clients_connected}'


Check JSON status API OK - dead_shares: 2, live_shares: 12, clients_connected: 234 | dead_shares=2;5;10 live_shares=12 clients_connected=234


Perl JSON package

  • Debian / Ubuntu : libjson-perl libnagios-plugin-perl libwww-perl