插件〉Checkmk Cloud & MSP的数据源

数据源

商业版

Checkmk Cloud & MSP 的 Checkmk 数据源

概述
安装
变更日志
相关内容

Checkmk Cloud 版本的 Checkmk 数据源

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 市场平台安装签名插件，或者使用 grafana-cli

grafana-cli plugins install checkmk-cloud-datasource

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

官方文档

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

许可证

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

在Grafana Cloud上安装Checkmk数据源以供Checkmk Cloud & MSP使用

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

变更日志

3.3.0

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

3.2.2

支持Checkmk管理版
对数据源设置的默认值进行对齐 如果您使用Checkmk原始版和已配置的数据源或使用此插件的非常旧版本创建数据源，您必须采取手动操作。请参阅提交消息b6aa9b
澄清REST-API请求404的错误信息

3.2.1

放弃对Grafana 9.5.15之前版本的支持

3.2.0

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

3.1.1

更新依赖项

3.1.0

添加了对查询变量的支持
更好的错误信息，以显示缺失的必填字段

3.0.1

我们现在构建和分发此插件的签名版本
- 已签名的插件“Checkmk数据源用于Checkmk Cloud版”将只与Checkmk Cloud版通信
- 插件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端点的支持
许多用户界面改进
- 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服务器的负载，文本字段更新将延迟500ms。这也影响：主机名正则表达式、服务正则表达式、主机属于组、服务属于组

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数据库从旧的连接器设置到新的连接器。在这个过程中，它将遍历所有仪表板，并为它们创建一个带有更新连接器的新版本。**请更新前备份此文件**。

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