插件〉Checkmk Cloud & MSP 数据源

数据源

商业版

Checkmk Cloud & MSP 数据源

概览
安装
更新日志
相关内容

Checkmk Cloud Edition 数据源

Checkmk Grafana Data Source Plugin

简介

此数据源 Grafana 插件允许将 Checkmk 作为数据源，并在 Grafana 中显示单个指标。

要求

要使用此插件，您需要确保安装了正确的版本。您需要匹配 Grafana 和 Checkmk 版本

Grafana 9.5.15 或更高版本 当前和以前的主要 Grafana 版本
Checkmk Cloud 或 Checkmk MSP 2.2.0 或更高版本，适用于从 Grafana 获取的已签名插件
Checkmk 2.1.0 或更高版本，适用于从 Github 获取的未签名插件

安装插件

已签名插件可以从 Grafana marketplace 安装，也可以使用 grafana-cli 安装

grafana-cli plugins install checkmk-cloud-datasource

有关安装未签名插件的信息，请参阅官方 Checkmk 用户指南。

官方文档

有关安装、配置和使用的详细信息，请查阅官方 Checkmk 用户指南。

许可证

本项目使用 Apache-2.0 许可证。

在 Grafana Cloud 上安装 Checkmk Cloud & MSP 数据源

有关更多信息，请访问关于插件安装的文档。

更新日志

3.4.1

修复用户定义变量的问题

3.4.0

更新了找不到 Rest API 时的错误消息
从 yarn 切换到 npm
将依赖项更新到最新版本
更新了单元测试
将端到端测试迁移到 Playwright
更新了文档

3.3.0

支持新的自动完成端点
Checkmk 商业产品品牌重塑

3.2.2

支持 Checkmk Managed Edition
对数据源设置对齐默认值 如果您使用 checkmk raw 版本和预配置的数据源，或者使用此插件的非常旧的版本创建了数据源，则必须手动操作。请参阅提交消息 b6aa9b
澄清有关 REST-API 请求 404 错误的错误消息

3.2.1

停止支持 Grafana 9.5.15 之前的版本

3.2.0

停止支持 Grafana 9.0.0 之前的版本
在自定义标签字段中
- 过滤器值可以用作变量
Bugfix：删除时间段的小数，因为 Checkmk 不支持亚秒级精度
数据源配置
- 提及旧版本 Checkmk 的功能降级
- 在版本不匹配时显示错误消息
- 更新非 RAW 版本的名称

3.1.1

更新依赖项

3.1.0

添加了对查询变量的支持
为缺少必填字段提供更好的错误消息

3.0.1

我们现在构建和发布此插件的签名版本
- 签名插件“Checkmk Cloud Edition 数据源”将仅与 Checkmk 的 Cloud Edition 通信
- 插件 ID 为 checkmk-cloud-datasource，因此需要重新创建使用未签名数据源（id=tribe-29-checkmk-datasource）创建的仪表板。我们将尝试在不久的将来提供一个脚本来自动传输现有仪表板。
- 未签名插件（id=tribe-29-checkmk-datasource）将继续工作，并将继续维护。
调整了插件的构建过程以使用 @grafana/create-plugin
“tribe29 GmbH”现在是“Checkmk GmbH”

3.0.0

亮点

为 Checkmk 2.2.0 的 REST API 端点添加支持
许多 UI 改进
- RAW 和 CEE 查询编辑器的更清晰布局
- RAW 过滤器现在垂直对齐显示
- 现有过滤器的过滤器类型不能再更改，必须删除它们，然后可以添加另一个过滤器。
- 查询编辑器字段中的错误在输入本身中更加突出显示
Grafana 中的图表现在显示与 Checkmk 中相同的颜色

（重大）更改

当使用 Checkmk < 2.2.0 时，您必须在数据源设置中选择正确的版本，因为默认设置为“>= 2.2”
图表类型已重命名，现有配置不受此影响。
- “模板”图表现在称为“预定义图表”
- “指标”图表现在称为“单指标”

2.0.3

为错误的身份验证提供更好的错误消息。

2.0.2

从 git 存储库中删除了 /dist 文件夹。这意味着不再可能通过 git clone 安装此 Grafana 插件。如果您使用 git pull 更新插件，则必须更改此插件的部署策略。请参阅官方文档
修复：更改“主机名正则表达式”后，图表不会自动更新，但必须单击右上角的 Grafana“刷新仪表板”按钮。现在图表应该会自动更新。为了限制 checkmk 服务器上的负载，文本字段的更新延迟了 500 毫秒。这也影响：主机名正则表达式、服务正则表达式、主机在组中、服务在组中

2.0.1

README.md 已经说明至少需要 Grafana 8.0.0，现在插件也反映了该版本要求。
将缺少的 logo 文件添加到 dist 文件夹

2.0.0

Checkmk 的 Grafana 连接器经历了完全重写。此插件版本与 checkmk 2.1 相伴而生，但出于测试目的，它将与 checkmk 2.0.0p20 一起使用

提供了一个更新脚本，用于将配置从以前的连接器迁移到这个新的连接器。但是，存在一些向后不兼容的更改，并非所有功能都得以保留。

我们在 github 项目中提供了一个 Python 脚本 utils/converter.py，用于将 Grafana SQLite 数据库从旧连接器设置更新到新连接器设置。在此过程中，它将遍历所有仪表板并创建更新连接器的新版本。请在更新前备份此文件。

安装并配置这个新连接器。记下您给它的名称，并记下您给旧连接器的名称。在本例中，我们称它们为“Latest cmk connector”和“checkmk”。
停止您的 Grafana 实例并备份文件 grafana.db
使用 converter.py 脚本，它有一个 -h 选项来提醒您用法。要将以前的数据源“checkmk”更新到 grafana.db 文件上的这个新连接器“Latest cmk connector”，请执行
```
python3  converter.py -o "checkmk" -n "Latest cmk connector" -db grafana.db
```
如果其中任何一个数据源是您的默认数据源，请在命令中省略该选项。
此脚本将遍历您的所有仪表板，这可能需要一些时间，因为它还会查询来自您的 checkmk 站点的信息，而这种通信需要时间。
更新完成后，再次启动您的 Grafana 服务器。