插件 〉Checkmk 数据源


开发者

Checkmk GmbH

订阅以接收不定期的产品新闻和更新



数据源
商业版

Checkmk 数据源

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

Checkmk 数据源

Grafana 10.4 Grafana 11.6 Checkmk data source for Checkmk Cloud & MSP CI

Checkmk Grafana Data Source Plugin

简介

数据源插件用于Grafana,可以将 Checkmk 作为数据源,并在 Grafana 中显示各项指标。

要求

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

  • Grafana 10.4.18 或更高版本 当前和上一个 Grafana 主要版本
  • Checkmk 2.2.0 或更高版本 可从 GithubGrafana Marketplace 获取插件

安装插件

可从 Grafana Marketplace 或使用 grafana-cli 安装插件

grafana-cli plugins install checkmk-cloud-datasource

官方文档

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

更多信息

请参阅 CHANGELOG.md 以了解如何从先前版本更新的信息。

请参阅 DEVELOPMENT.md 以了解如何测试、构建和发布此软件的信息。

许可证

本项目使用 Apache-2.0 许可证

在 Grafana Cloud 上安装 Checkmk 数据源

更多信息,请访问以下文档:关于插件安装

更新日志

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 数据库从旧连接器设置更新到新设置。在此过程中,它会遍历所有仪表盘,并使用更新后的连接器创建新版本的仪表盘。请在更新前备份此文件。

  1. 安装并配置此新连接器。记下您为其指定的名称,并记下您为旧连接器指定的名称。在此示例中,我们将它们分别命名为“Latest cmk connector”和“checkmk”。

  2. 停止您的 Grafana 实例并备份文件 grafana.db

  3. 使用 converter.py 脚本,它带有 -h 选项以提示用法。要在 grafana.db 文件上从旧数据源“checkmk”更新到新连接器“Latest cmk connector”,请执行

    python3  converter.py -o "checkmk" -n "Latest cmk connector" -db grafana.db
    

    如果其中任何一个数据源是您的默认数据源,则在命令中省略该选项。

    此脚本将遍历所有仪表盘,这可能需要一些时间,因为它还会从您的 checkmk 站点查询信息,而该通信需要时间。

  4. 更新完成后,再次启动您的 Grafana 服务器。

2.0.0b3

  • 更新依赖项
  • 修复 Raw Edition 上的数据源测试

2.0.0b2

  • 更新依赖项
  • 在 CEE 上过滤 METRIC_ 图表模板

2.0.0b1

  • 从头彻底重写