图表配置

本小节将对夜莺仪表盘的功能进行详细介绍,这里以时序值为例,介绍下图表是否配置。创建好一个仪表盘之后,进去仪表盘编辑页面,点击右上角的 添加图标 按钮,弹出图表编辑视图,如下图

image-20230427173825299

图表配置主要分三个区域,左上是预览图区域,展示了图表配置的最终效果,左下是数据筛选区,可以设置展示哪些数据,右边是图表的各种样式配置

左下是数据筛选部分

夜莺的仪表盘也支持配置变量,如果仪表盘配置了变量,可以写 promql 时使用 $+变量名 的方式配置,这样后续再查询大盘的时候,可以通过切换变量快速查看不同对象的多个监控图表。

除了自定义的大盘变量,还有些内置变量,以获取大盘时间间隔为例,可以用$__interval,例如 cpu_usage_active[$__interval], 另外文本卡片暂不支持内置变量。

可用的内置变量如下:

  1. { name: '__from', value: from },
  2. { name: '__from_date_seconds', value: fromDateSeconds },
  3. { name: '__from_date_iso', value: fromDateISO },
  4. { name: '__from_date', value: fromDateISO },
  5. { name: '__to', value: to },
  6. { name: '__to_date_seconds', value: toDateSeconds },
  7. { name: '__to_date_iso', value: toDateISO },
  8. { name: '__to_date', value: toDateISO },
  9. { name: '__interval', value: `${interval}s` },
  10. { name: '__interval_ms', value: `${interval * 1000}ms` },
  11. { name: '__rate_interval', value: `${interval * 4}s` },
  12. { name: '__range', value: `${toDateSeconds - fromDateSeconds}s` },
  13. { name: '__range_s', value: `${toDateSeconds - fromDateSeconds}s` },
  14. { name: '__range_ms', value: `${(toDateSeconds - fromDateSeconds) * 1000}ms` }

右边是样式配置参数

  • 标题:每个图表可以配置一个标题,方便更直观地知道图表的用途
  • 链接:有的场景我们可以先配置一个总览的图表,比如某个应用的健康度,当健康度异常时,点击点击这里配置的链接,进入另一个仪表盘,查看更详细的信息
  • 备注:对图表更详细的说明
  • Tooltip 模式: 设置为 Single 时,鼠标移动到图表上时显示单个图例,All 时显示全部的图例
  • Legand: 图例展示设置,提供了表格、列表、隐藏三种
  • 图表样式:可以配置折线图、柱状图、颜色是否渐变、是否堆叠、透明度、曲线宽度等
  • 高级配置:可以配置Y轴的上界和下界、数值的单位等
  • 阈值:可以在Y轴的某个位置标记红线阈值

通过上面这些配置,可以灵活的配置出用户想要的图表效果,除了时序值,夜莺图表还支持指标值、表格、饼图、蜂窝图、排行榜、文字卡片、仪表盘、内嵌文档等多种图表,未来还会继续支持更多图表类型。

大盘变量

大盘变量是夜莺仪表板中的一种动态元素,通过使用大盘变量,用户可以根据所选变量值快速查看和比较数据,增加仪表板的灵活性和易维护性。

举个具体的例子,当我们需要配置多个 MySQL 实例的仪表盘时,通过创建一个查询变量,从数据源中获取所有可用的 MySQL 实例名称。我们可以在仪表板中轻松选择所需实例,查看其性能指标、资源使用情况等。例如,使用以下 PromQL 查询作为变量来源:label_values(mysql_global_status_threads_connected, instance) ,可以把 instance 作为变量,在仪表板中,用户可以根据 instance(实例名称)快速切换,查看每个实例的连接数、查询速率、缓冲池使用情况等指标。

image-20230427231741585