Plugins 〉Checkmk data source for Checkmk Cloud & MSP
Checkmk data source for Checkmk Cloud & MSP
Checkmk data source for Checkmk Cloud Edition
Introduction
This data source plugin for Grafana allows to address Checkmk as source and to display individual metrics in Grafana.
Requirements
To make use of the plugin, you need to take care the correct versions are installed. You need to match both, the Grafana and the Checkmk version:
- Grafana 9.5.15 or higher Current and previous major version of Grafana
- Checkmk Cloud or Checkmk MSP 2.2.0 or higher for the signed plugin available from Grafana
- Checkmk 2.1.0 or higher for the unsigned plugin available from Github
Installing the plug-in
The signed plug-in can be installed from the Grafana marketplace or by using the grafana-cli
:
grafana-cli plugins install checkmk-cloud-datasource
For the installation of the unsigned plugin, please take a look at the official Checkmk User Guide.
Official documentation
For detailed information regarding the installation, configuration and usage, please consult the official Checkmk User Guide.
Further information
See CHANGELOG.md for information about updating from previous versions.
See DEVELOPMENT.md for information about how to test, build and release this software.
License
This project is using the Apache-2.0 license.
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
.h4 . .mb-0 }
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Installing Checkmk data source for Checkmk Cloud & MSP on Grafana Cloud:
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
For more information, visit the docs on plugin installation.
Installing on a local Grafana:
For local instances, plugins are installed and updated via a simple CLI command. Plugins are not updated automatically, however you will be notified when updates are available right within your Grafana.
1. Install the Data Source
Use the grafana-cli tool to install Checkmk data source for Checkmk Cloud & MSP from the commandline:
grafana-cli plugins install
The plugin will be installed into your grafana plugins directory; the default is /var/lib/grafana/plugins. More information on the cli tool.
Alternatively, you can manually download the .zip file for your architecture below and unpack it into your grafana plugins directory.
Alternatively, you can manually download the .zip file and unpack it into your grafana plugins directory.
2. Configure the Data Source
Accessed from the Grafana main menu, newly installed data sources can be added immediately within the Data Sources section.
Next, click the Add data source button in the upper right. The data source will be available for selection in the Type select box.
To see a list of installed data sources, click the Plugins item in the main menu. Both core data sources and installed data sources will appear.
Changelog
3.3.0
- Support for new autocomplete endpoints
- Rebranding of Checkmk commercial products
3.2.2
- Support for Checkmk Managed Edition
- Align defaults for datasource settings If you use checkmk raw edition and a provisioned datasource or created the datasource with an very old version of this plugin you have to take manual action. See commit message b6aa9b
- Clarify error message on 404 on REST-API request
3.2.1
- Dropped support for Grafana prior 9.5.15
3.2.0
- Dropped support for Grafana prior 9.0.0
- At custom label field:
- Filter values can be used as variables
- Bugfix: Remove decimals from time periods as Checkmk does not support sub-second accuracy
- Datasource configuration:
- Mention feature degratadtion for older versions of Checkmk
- Display an error message on edition mismatch
- Update non-RAW editions name
3.1.1
- update dependencies
3.1.0
- added support for query variables
- better error message for missing mandatory fields
3.0.1
- We now build and ship a signed version of this plugin:
- The signed plugin "Checkmk data source for Checkmk Cloud Edition" will only talk to the Cloud Edition of checkmk
- the plugin id is
checkmk-cloud-datasource
, so dashboards created with the unsigned data source (id=tribe-29-checkmk-datasource
) needs to be recreated. We will try to provide a script to automatically transfer existing dashboards in the near future. - The unsigned plugin (id=
tribe-29-checkmk-datasource
) will continue to work and will still be maintained.
- Adapted the build process of the plugin to use
@grafana/create-plugin
- "tribe29 GmbH" is now "Checkmk GmbH"
3.0.0
Highlights
- Add support for REST API endpoints of Checkmk 2.2.0
- Many UI improvements:
- Clearer layout for both the RAW and CEE Query Editor
- RAW filters are now displayed vertically aligned
- The filter type of existing filters can no longer be changed, they have to be removed, and another filter can be added.
- Errors in the Query Editor Fields are more prominently featured in the inputs themselves
- Graphs in Grafana now show the same color as in Checkmk
(Breaking) Changes
- When using Checkmk < 2.2.0 you will have to choose the correct version in the data source settings, as this defaults to ">= 2.2"
- Graph Types have been renamed, existing configuration is not affect by this.
- "Template" Graphs are now called "Predefined Graphs"
- "Metric" Graphs are now called "Single Metric"
2.0.3
- Provide better error message on wrong authentication.
2.0.2
- Removed
/dist
folder from git repository. That means that it's no longer possible to install this Grafana plugin bygit clone
. If you usegit pull
to update the plugin, you will have to change your deployment strategy of this plugin. Please refer to the official documentation - FIX: After changing a "Hostname Regex", the graph was not automatically updated, but Grafanas "Refresh dashboard" button on the upper right had to be clicked. Now the graph should update automatically. In order to limit the load on the checkmk server, the update is delayed by 500ms for text fields. This also affects: Hostname regex, Service Regex, Host is in Group, Service is in Group
2.0.1
- README.md already states that at least Grafana 8.0.0 is required, now the plugin also reflects that version requirement.
- add missing logo file to dist folder
2.0.0
Checkmk's Grafana connector underwent a complete rewrite. This plugin release accompanies checkmk 2.1, yet for testing purposes it will work with checkmk 2.0.0p20
An update script is available to migrate the configuration from the previous connector to this new one. However, there are some backwards incompatible changes and not all features are conserved.
We provide a Python script utils/converter.py
in our github project which updates the Grafana
SQLite database from the old connector setup to the new one. In that process it
will go over all the dashboards and create a new version of them with the
updated connector. PLEASE BACKUP THIS FILE BEFORE UPDATING.
Install and configure this new connector. Take note of the name you give it and take note of which name you gave the old connector. In this example we call them "Latest cmk connector" and "checkmk".
Stop your Grafana instance and backup the file
grafana.db
Use the
converter.py
script, it has a-h
option to remind you of the usage. To update from the previous datasource "checkmk" into this new connector "Latest cmk connector" on thegrafana.db
file, execute:python3 converter.py -o "checkmk" -n "Latest cmk connector" -db grafana.db
If any of the two datasources is your default datasource, omit that option on the command.
This script will go over all your dashboards, it might take some time because it also queries information from your checkmk site, and that communication takes time.
After the update completes start your Grafana server again.
2.0.0b3
- Update dependencies
- Fix data source test on raw edition
2.0.0b2
- Update dependencies
- Filter METRIC_ graph templates on CEE
2.0.0b1
- Complete rewrite from scratch