Icinga/Nagios check for Spring Boot applications using the actuator framework

About check_springboot_actuator

This is an Nagios/Icinga check plugin for Spring Boot applications using the actuator framework. The check inspects the response from the health and metrics endpoints.


The check checks the status field from the health endpoint for

  • global status
  • cassandra status
  • diskSpace status
  • db
  • dataSource status
  • elasticsearch status
  • jms status
  • mail status
  • mongo status
  • rabbit status
  • redis status
  • solr status
  • vault
  • livenessState status
  • readinessState status
  • ping status
  • couchbase status
  • hazelcast status
  • influxdb status
  • ldap status
  • neo4j status

The check aggregates metrics for the counter.status data from the metrics endpoints.


check_springboot_actuator is licensed under the terms of the MIT license as described in the LICENSE file.


check_springboot_actuator runs on Python 2.7 and 3.x. It was originaly build for RHEL/CentOS 7 with EPEL repositories enabled:

yum -y install epel-release
yum -y install pynag python-requests

check_springboot_actuator will run on newer OS releases with Python 3. Dependencies can be installed using a package manager or via pip:

python3 -m pip install -r requirements.txt


The check can be run from a shell either using ./ or python3 depending on your OS and Python version.


Dependency update

Minimum dependency versions are defined in The requirements.txt file has been generated by pip-compile. Perform the following steps to update requirements.txt to newer dependency versions:

python3 -m pip install -U pip-tools
pip-compile --upgrade