Newer
Older
This plugin mointors the update status of yor CMK sites and your CMK appliance firmware. The plugin reads it's data once a day form the Checkmk download page (**https://download.checkmk.com/stable_downloads.json**).
THX to Baris Leenders for providing the data as JSON download and Martin Hirschvogel for supporting the development of this plugin (both from tribe29).
**NOTE**: before updating from the special agent version of this plugin, remove the old package completely (rules and package) please.
**NOTE**: to get the download URLs in the service details not replaced by CMK you need to disable `Escape HTML in service output` (_Setup_ > _Services_ > _Service monitoring rules_ > _Escape HTML in service output_) for the service `Checkmk Update`.
For the check plugin to work
- Your CMK site servers need to run check-mk agent version 2.0.0 or higher to get CMK site informations
- The HW/SW inventory plugin for Linux must be installad and running (`mk_inventory.linux` agent plugin needs to be deployed)
- The CMK server, where the check runs must have access to **https://download.checkmk.com/stable_downloads.json**
* [checkmk_update.mkp (latest version)](https://thl-cmk.hopto.org/gitlab/checkmk/checkmk_update/-/raw/master/checkmk_update.mkp "Download latest version")
---
### Installation
You can install the package by uploading it to your CheckMK site and as site user run `mkp install checkmk_update.mkp`.
In the Enterprise/Free edition of CheckMK you can use the GUI to install the package (_Setup_ -> _Extension Packages_ -> _Upload package_)
---
#### Want to contribute?
Nice ;-) Have a look at the [contribution guidelines](CONTRIBUTING.md "Contributing")
---
#### Check Info:
The plugin creates the service **_Checkmk Update_** with the CMK site name as the _item_
<details><summary>Montoring states</summary>
| State | condition | WATO |
| ------ | ------ | ------ |
| CRIT | if CMK base version is older than old stable base version | yes |
| WARN | if CMK version is older than latest version of base version | yes |
| WARN | if CMK version is an old stable release | yes |
| WARN | if CMK base version could not be detected | yes |
| CRIT | if CMK appliance firmware is unsupported | yes |
| WARN | if CMK appliance firmware update is available (same base version) | yes |
| WARN | if CMK appliance firmware is not the latest release | yes |
</details>
<details><summary>Perfdata</summary>
| Metric | Unit | Perfometer | |
| ------ | ------ | ------ | ----- |
| Latest stable | count | no | Patchlevel of latest sable version |
| Old stable | count | no | Patchlevel of latest old stable version |
</details>
### WATO
<details><summary>Service monitoring rule</summary>
| Section | Rule name |
| ------ | ------ |
| Operating System Resources | Checkmk update |
| Option | Defailt value |
| ------ | ------ |
| State if CMK base version older than old stable base version. | CRIT |
| State if CMK version is older than latest version of base version. | WARN |
| State if CMK version is an old stable release. | WARN |
| State if CMK base version could not be detected. | WARN |
| State if CMK appliance firmware is unsupported. | CRIT |
| State if CMK appliance firmware update available (same base version). | WARN |
| State if CMK appliance firmware is not the latest release. | WARN |
| Connection Timeout for update data download | 5 seconds |
</details>
Sample output
![sample output](/doc/sample.png?raw=true "sample output")
![sample details output](/doc/sample-details.png?raw=true "sample details output")