插件 〉Checkmk 数据源
Checkmk 数据源
Checkmk 数据源
简介
此数据源插件用于Grafana,可以将 Checkmk 作为数据源,并在 Grafana 中显示各项指标。
要求
要使用此插件,您需要确保安装了正确的版本。您需要匹配 Grafana 和 Checkmk 的版本
- Grafana 10.4.18 或更高版本 当前和上一个 Grafana 主要版本
- Checkmk 2.2.0 或更高版本 可从 Github 或 Grafana Marketplace 获取插件
安装插件
可从 Grafana Marketplace 或使用 grafana-cli
安装插件
grafana-cli plugins install checkmk-cloud-datasource
官方文档
有关安装、配置和使用的详细信息,请参阅官方 Checkmk 用户指南。
更多信息
请参阅 CHANGELOG.md 以了解如何从先前版本更新的信息。
请参阅 DEVELOPMENT.md 以了解如何测试、构建和发布此软件的信息。
许可证
本项目使用 Apache-2.0 许可证。
在 Grafana Cloud 上安装 Checkmk 数据源
在 Grafana Cloud 实例上安装插件是一键式操作;更新也是如此。很酷吧?
请注意,插件可能需要最多 1 分钟才能在您的 Grafana 中显示。
在 Grafana Cloud 实例上安装插件是一键式操作;更新也是如此。很酷吧?
请注意,插件可能需要最多 1 分钟才能在您的 Grafana 中显示。
在 Grafana Cloud 实例上安装插件是一键式操作;更新也是如此。很酷吧?
请注意,插件可能需要最多 1 分钟才能在您的 Grafana 中显示。
在 Grafana Cloud 实例上安装插件是一键式操作;更新也是如此。很酷吧?
请注意,插件可能需要最多 1 分钟才能在您的 Grafana 中显示。
在 Grafana Cloud 实例上安装插件是一键式操作;更新也是如此。很酷吧?
请注意,插件可能需要最多 1 分钟才能在您的 Grafana 中显示。
在 Grafana Cloud 实例上安装插件是一键式操作;更新也是如此。很酷吧?
请注意,插件可能需要最多 1 分钟才能在您的 Grafana 中显示。
在 Grafana Cloud 实例上安装插件是一键式操作;更新也是如此。很酷吧?
请注意,插件可能需要最多 1 分钟才能在您的 Grafana 中显示。
更多信息,请访问以下文档:关于插件安装。
在本地 Grafana 上安装
对于本地实例,插件通过简单的 CLI 命令安装和更新。插件不会自动更新,但当有更新可用时,您会在 Grafana 中收到通知。
1. 安装数据源
使用 grafana-cli 工具从命令行安装 Checkmk 数据源
grafana-cli plugins install
插件将安装到您的 grafana 插件目录中;默认路径为 /var/lib/grafana/plugins。更多关于 cli 工具的信息。
2. 配置数据源
从 Grafana 主菜单访问,新安装的数据源可立即在“数据源”部分添加。
接下来,点击右上角的“添加数据源”按钮。数据源将可在类型选择框中选择。
要查看已安装数据源列表,请点击主菜单中的插件项。核心数据源和已安装数据源都将显示。
更新日志
4.0.2
- 停止支持低于 10.4.18 的 Grafana 版本
4.0.1
- 更新了 GitHub Actions
4.0.0
- 移除了签名插件限制:签名插件现在兼容所有 Checkmk 版本,包括 Raw Edition
- 停止支持未签名插件:请迁移至签名插件
- 停止支持低于 2.2.0 的 Checkmk 版本:Checkmk 2.1.0 已于 2024 年 11 月 24 日达到 EOL
- 更新了文档
- 将依赖项更新至最新版本
- Bug 修复
3.4.1
- 修复用户定义变量问题
3.4.0
- 更新了找不到 Rest API 时的错误消息
- 从 yarn 切换到 npm
- 将依赖项更新至最新版本
- 更新了单元测试
- 将端到端测试迁移到 Playwright
- 更新了文档
3.3.0
- 支持新的自动完成端点
- Checkmk 商业版产品重新品牌化
3.2.2
- 支持 Checkmk Managed Edition
- 调整数据源设置的默认值 如果您使用 checkmk Raw Edition 并使用了预配置的数据源,或使用了此插件的非常旧的版本创建了数据源,则需要手动操作。请参阅提交消息 b6aa9b
- 澄清 REST-API 请求 404 时的错误消息
3.2.1
- 停止支持低于 9.5.15 的 Grafana 版本
3.2.0
- 停止支持低于 9.0.0 的 Grafana 版本
- 在自定义标签字段处
- 筛选值可用作变量
- Bug 修复:移除时间段中的小数,因为 Checkmk 不支持亚秒级精度
- 数据源配置
- 提及旧版本 Checkmk 的功能降级
- 版本不匹配时显示错误消息
- 更新非 RAW 版本名称
3.1.1
- 更新依赖项
3.1.0
- 增加了对查询变量的支持
- 优化了必填字段缺失时的错误消息
3.0.1
- 我们现在构建并发布此插件的签名版本
- 签名插件“用于 Checkmk Cloud Edition 的 Checkmk 数据源”将仅与 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
- 移除了
/dist
文件夹。这意味着不再可以通过git clone
安装此 Grafana 插件。如果您使用git pull
更新插件,则必须更改此插件的部署策略。请参阅官方文档 - 修复:更改“主机名正则表达式”后,图表不会自动更新,需要点击右上角的 Grafana“刷新仪表盘”按钮。现在图表应该会自动更新。为了限制 checkmk 服务器的负载,文本字段的更新延迟 500ms。这也影响以下字段:主机名正则表达式、服务正则表达式、主机所属组、服务所属组
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 数据库从旧连接器设置更新到新设置。在此过程中,它会遍历所有仪表盘,并使用更新后的连接器创建新版本的仪表盘。请在更新前备份此文件。
安装并配置此新连接器。记下您为其指定的名称,并记下您为旧连接器指定的名称。在此示例中,我们将它们分别命名为“Latest cmk connector”和“checkmk”。
停止您的 Grafana 实例并备份文件
grafana.db
使用
converter.py
脚本,它带有-h
选项以提示用法。要在grafana.db
文件上从旧数据源“checkmk”更新到新连接器“Latest cmk connector”,请执行python3 converter.py -o "checkmk" -n "Latest cmk connector" -db grafana.db
如果其中任何一个数据源是您的默认数据源,则在命令中省略该选项。
此脚本将遍历所有仪表盘,这可能需要一些时间,因为它还会从您的 checkmk 站点查询信息,而该通信需要时间。
更新完成后,再次启动您的 Grafana 服务器。
2.0.0b3
- 更新依赖项
- 修复 Raw Edition 上的数据源测试
2.0.0b2
- 更新依赖项
- 在 CEE 上过滤 METRIC_ 图表模板
2.0.0b1
- 从头彻底重写