check_rancher2

Monitoring plugin to check Docker / Kubernetes clusters managed by Rancher 2.x

Release 1.13.0 latest

Version 1.13.0 adds a new check type api-token. This check is used to monitor the expiry of the used API token (used by check_rancher2).

Background In newer Rancher2 versions, API tokens must be created with an expiry. The tokens are no longer valid without expiration date (such as in Rancher 2.5). When the API token expired, the monitoring checks with check_rancher2 run into an authentication error. With the new api-token check type, the plugin will alert in advance, prior to the expiry of the token, when used in combination with --expiry-warn.

Furthermore the --cert-warn parameter, used for the local-certs certificate check, is now DEPRECATED. Please use --expiry-warn for this check as well.

The local-certs check type received a bug fix in the output.

Launching the plugin with --help no longer shows unrecognized option '--help' at the top.

check_rancher2-1.13.0.tar.gz

Release tarball
application/gzip 2025-06-13 Download from Github

Release 1.12.1

Use 'command -v' instead of 'which' for required command check. Makes the plugin more distribution independent, as which is not always installed by default - depending on the Linux distribution.

check_rancher2-1.12.1.tar.gz

Release tarball
application/gzip 2023-12-08 Download from Github

Release 1.12.0

This release adds a new check type to the plugin.

The "local-certs" check type allows to check for valid certificates deployed by Rancher in the "local" cluster, under the "System" project. These certificates are deployed as Kubernetes secrets in the "cattle-system" namespace.

These certificates are by default created with a one year validity (Rancher, whyyyy?!). When these local certificates expire, this can create some issues in the background of Rancher, e.g. when RBAC actions are used. It's therefore important to verify these certificates have not expired.

check_rancher2-1.12.0.tar.gz

Release tarball
application/gzip 2023-02-02 Download from Github
Newer Older