跳至主内容
版本:2.6.7

使用 Grafana 数据源插件进行观测

非官方测试版翻译

本页面由 PageTurner AI 翻译(测试版)。未经项目官方认可。 发现错误? 报告问题 →

本文档介绍如何安装 Grafana 数据源插件并配置该插件以观测 Chaos Mesh 事件。

备注

本插件要求 Chaos Mesh >=2.1 且 Grafana >= 10.0

我们仅在 Grafana 10.0.3 版本上测试过该插件,它可能支持更低版本但不保证可用。升级到 Grafana v10 是由于 Angular 支持弃用。如遇任何问题,请提交 issue 告知我们。

安装

通过控制面板安装

https://grafana.com/docs/grafana/latest/administration/plugin-management/#install-a-plugin

通过命令行安装

grafana-cli plugins install chaosmeshorg-datasource

手动安装

使用以下命令下载插件压缩包或访问 https://github.com/chaos-mesh/datasource/releases 下载:

curl -LO https://github.com/chaos-mesh/datasource/releases/download/v3.0.0/chaosmeshorg-datasource-3.0.0.zip

下载完成后解压:

unzip chaosmeshorg-datasource-3.0.0.zip -d YOUR_PLUGIN_DIR

更新并保存 grafana.ini 文件:

[plugins]
allow_loading_unsigned_plugins = chaosmeshorg-datasource

最后重启 Grafana 以加载插件。

配置

安装完成后,前往管理 -> 数据源添加 Chaos Mesh 数据源,进入配置页面:

配置界面
配置界面

假设 Chaos Mesh 已本地部署,Chaos Dashboard 默认会在 2333 端口暴露 API。如未更改配置,此处应填写 http://localhost:2333

使用 port-forward 命令使 API 可外部访问:

kubectl port-forward -n chaos-mesh svc/chaos-dashboard 2333:2333

点击保存并测试进行连接验证。若显示成功通知,则配置完成。

认证配置

若部署 Chaos Mesh 时启用了权限认证,需在配置中添加 Authorization 请求头。按以下步骤添加:

  1. 点击添加请求头按钮

  2. 请求头字段填写 Authorization

  3. 按照此章节获取令牌

  4. 字段填写 Bearer YOUR_TOKEN

完成后请务必点击保存并测试验证连接。

查询

该数据源插件通过事件视角观测 Chaos Mesh,以下选项用于筛选不同事件:

  • 对象 ID

    按对象 uuid 筛选

  • 命名空间

    按不同命名空间筛选

  • 名称

    按对象名称筛选

  • 类型

    按类型筛选 (PodChaos, NetworkChaos, Schedule...)。若在 Chaos Mesh 中实现了新类型,也可直接输入

  • 数量限制

    限制事件返回数量

以上参数均会作为查询参数传递给 /api/events 接口。

变量配置

该数据源插件支持通过不同指标添加查询变量:

变量
变量

  • 命名空间

    选择后,所有可用的命名空间将直接显示在值预览区域。

  • 类型

    命名空间相同,检索所有类型。

  • 实验/计划/工作流

    命名空间相同,检索当前所有实验/计划/工作流。

    你还可以指定 queries 参数进一步过滤值,例如 ?namespace=default 将仅检索 default 命名空间中的实验/计划/工作流。

注解

你可以通过注解将事件集成到面板中,以下示例将检索所有 PodChaos 事件:

注解
注解

请参考查询部分填写相应字段。

问题与反馈

如果在安装或设置过程中遇到问题,欢迎在 CNCF Slack 向社区提问,或创建 GitHub issue 与 Chaos Mesh 团队沟通。

后续计划

如需了解数据源插件的更多细节,请随时查看 chaos-mesh/datasource 的源代码。