插件〉Checkmk Cloud & MSP 的 Checkmk 数据源

数据源

商业版

Checkmk Cloud & MSP 的 Checkmk 数据源

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

Checkmk Cloud Edition 的 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 Cloud & MSP 的 Checkmk 数据源

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

变更日志

3.3.0

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

3.2.2

支持 Checkmk 托管版
调整数据源设置的默认值 **如果您使用的是 checkmk raw 版本和预配的数据源，或者使用非常旧版本的此插件创建了数据源**，则您需要采取手动操作。请参阅提交消息 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 Cloud 版的 Checkmk 数据源”只与 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 端点的支持
许多 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 更新插件，您将需要更改此插件的部署策略。请参阅官方文档
修复：更改“主机名正则表达式”后，图形没有自动更新，而是必须单击右上角的 Grafanas“刷新仪表板”按钮。现在，图形应该自动更新。为了限制对 checkmk 服务器的负载，文本字段的更新将延迟 500 毫秒。这也影响：主机名正则表达式、服务正则表达式、主机位于组中、服务位于组中

2.0.1

README.md 已经说明至少需要 Grafana 8.0.0，现在插件也反映了该版本要求。
将丢失的徽标文件添加到 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 服务器。