插件 〉图表
图表
投票选择新功能
或者通过捐赠几美元来帮助养活我的孩子 :sweat_smile
我也提供自定义插件开发合同 [和其他技术项目]
grafana-diagram
这是一个 Grafana 面板插件,它通过利用 mermaid.js 库提供了一种创建流程图、序列图和甘特图的方法。
- 可以使用 Mermaid JS 语法定义图表。
- 指标序列用于为形状/节点的文本或背景着色。
- 将序列的目标或“别名”与图表节点的 ID 进行比较以查找匹配项,然后将样式应用于形状。
- 组合可以用于聚合单个节点的多个序列,每个序列都有自定义阈值。
**注意 - 别名中的特殊字符将替换为下划线。请参见下面的字符替换**
快速入门
图表定义使用类似 Markdown
的语法,称为 Mermaid
这是一个简单的流程图定义 -
graph LR
A --> B
生成此图形
假设您有两个带有别名 A-series
和 B-series
的序列
在图表插件中,您可以修改定义以匹配数据的标识 -
字符替换
指标名称中的以下字符将自动替换为下划线。
" , ; = : { }
待办事项
You can add additional metric replacements in the Display tab, under the section Metric Character Replacement:
A single character can be specified or a regular expression, along with the text to be used for the replacement (the default is underscore).
示例
带有子图
带有自定义形状、别名和图标
graph LR
LB[Load Balancer] -- route1 --> web1
LB[Load Balancer] --> web2
web1 --> app1(fa:fa-check app1)
web1 ==> app2
web2 ==> app2(fa:fa-ban app2)
web2 --> app1
app1 --> D[(database)]
字段选项
字段覆盖
自定义主题
CSS 覆盖
使用变量
使用背景作为指示器
选项
- 阈值 [字段可以覆盖]
- 聚合选项 [字段可以覆盖]
- 无界颜色级别 [字段可以覆盖]
- 值映射到文本 [字段可以覆盖]
- 单位格式 [字段可以覆盖]
- 要显示的指标值(最小值/最大值/平均值/最后一个/)[字段可以覆盖]
- 小数精度 [字段可以覆盖]
- CSS 覆盖
- 指示器作为背景或文本颜色
- 主题响应式
- 主题自定义
- 图表定义中的变量替换
链接指标
Mermaid 表示法相同,但现在支持在“文本”中提供指标名称。
在双引号中指定指标名称(用于转义目的)。
指标组合
要反映单个节点上的多个指标及其阈值,请使用指标组合指定组合名称以及要为组合评估的指标。
将为每个指标评估序列/字段特定的覆盖,并将显示组合的“最差”状态。
在图表定义中评估组合名称。
例如,将两个序列“A-series”和“B-series”组合到名为“xyz”的单个组合中,可以使用以下方法
当接收到每个序列的数据时,将评估阈值以查找“最差”阈值级别,并且指标和颜色值将在图表中“xyz”组合中反映。
以下是在实际操作中组合的示例
此图表具有“xyz”节点,序列 A 和 B 的阈值均为“全绿色”
此图表包含“xyz”节点,其中A系列为绿色,但B系列为黄色。图表节点显示黄色,以及对应的值。
此图表包含“xyz”节点,其中A系列为绿色,但B系列为红色。图表节点显示红色,以及对应的值。
此图表包含“xyz”节点,其中A系列为黄色,B系列为绿色。图表节点显示黄色,以及对应的值。
值或范围到文本映射
值和范围映射可用于将数值替换为人类可读的文本。
在图表中,匹配系列的值将映射到文本。
路线图
- 自定义字符替换
- 实现 Hash 前缀表示法处理器?
【新的字段映射可能替换此功能】 - 远程图表定义 URL
- 【建议一些内容】
开发
谢谢!
特别感谢 Mermaid 贡献者 -
https://github.com/mermaid-js/mermaid/graphs/contributors
https://mermaid-js.github.io/
以及 D3 贡献者 -
https://github.com/d3/d3/graphs/contributors
尤其感谢 Grafana 贡献者 -
https://github.com/grafana/grafana/graphs/contributors
http://grafana.org/
了解更多
- 构建面板插件教程
- Grafana 文档
- Grafana 教程 - Grafana 教程是分步指南,可帮助您充分利用 Grafana
- Grafana UI 库 - UI 组件,可帮助您使用 Grafana 设计系统构建界面
在 Grafana Cloud 上安装 Diagram
在 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 工具从命令行安装 Diagram
grafana-cli plugins install
插件将安装到您的 Grafana 插件目录中;默认目录为 /var/lib/grafana/plugins。有关 cli 工具的更多信息。
2. 将面板添加到仪表盘
已安装的面板会立即在 Grafana 主菜单的“仪表盘”部分中可用,并且可以像 Grafana 中的任何其他核心面板一样添加。
要查看已安装面板的列表,请点击主菜单中的“插件”项。核心面板和已安装的面板都将显示。
更改日志
此项目的所有重大更改都将记录在此文件中。
v1.0.0
初始版本