Panel

概述

参考：
官方文档，面板与可视化
官方文档，面板与可视化 - 面板编辑器

当我们开始创建一个新的 Panel 时，可以看到下图所示的界面，这个界面分为三大部分，分别用三种颜色的框体括起来

Header(标题), 绿色部分 # 左边是面板的名称，右侧有 4 个按钮，分别是设置整个 Dashboard、放弃、保存、应用
Visualization preview(可视化的预览), 蓝色部分 # 在数据处理与面板样式处理两部分设置的内容将会反应在这个预览部分
Data section(数据处理), 红色部分 # 通过数据查询语句来获取数据，以便在面板展示
Panel dispaly options(面板显示选项), 黄色部分 # 用来配置面板的信息。包括面板类型、面板名称、展示效果等等

标题部分列出了面板所在的仪表板的名称和一些仪表板命令。您还可以单击返回箭头以返回仪表板。

标题的右侧是以下选项：

⚙齿轮图标(设置) - 单击以访问仪表板设置。
Discard(放弃) - 放弃自上次保存仪表板以来对面板所做的所有更改。
Save(保存) - 保存仪表板，包括您在面板编辑器中所做的所有更改。
Apply(应用) - 应用您所做的更改，然后关闭面板编辑器，将您返回到仪表板。您必须保存仪表板以保留应用的更改。

Visualization preview

https://grafana.com/docs/grafana/latest/panels-visualizations/panel-editor-overview/#visualization-preview

在可视化的预览部分，可以图像的形式查看从数据源获取到的数据。包含如下几个部分

Axes 横、纵坐标轴
- 横轴是时间
- 纵轴是值。即该时间点上，数据源中的值。
Panel title 面板标题
Legend 图例(即图片的文字说明)
时间范围控件

在左上角是 Grafana 模板

在没有配置 Grafana 变量时，这一块是空白的。详见 [模板与变量](/docs/6.可观测性/Grafana/Panel(面板)%20 与%20Dashboard(仪表盘)/Panel(面板)%20 配置详解/Templates%20and%20Variables(模板与变量).md 配置详解/Templates and Variables(模板与变量).md)

在右上角可以控制部分显示效果

Table view(表格视图) # 将可视化预览区域转换为表格，以便查看数据。常用来故障排除
Fill(填充) # 可视化预览将填充预览部分中的可用空间。如果您更改侧窗格的宽度或底部窗格的高度，则可视化将适应以填充任何可用空间。
Fit(适合) # 可视化预览将填充其中的可用空间，但保留面板的纵横比。
Exact(确切) # 可视化预览的大小将与仪表板上的大小完全相同。如果没有足够的可用空间，则可视化将按比例缩小以保留宽高比。
Time range controls(时间范围控件) # 有关更多信息，请参阅时间范围控件。

Data section

https://grafana.com/docs/grafana/latest/panels-visualizations/panel-editor-overview/#data-section

该部分包含一些 tab(标签)，可以在其中输入查询，转换数据以及创建警报规则(如果适用)。

Query tab(查询标签) # 选择数据源并通过查询语句获取数据。参考：Queries
Transform tab(转换标签) # 将 Query 中获取到的数据进行转换。参考：Transformations
Alert tab(告警标签)# 配置告警规则。参考：Create alerts

Query(查询)

在查询标签中，可以配置 Grafana 与数据源并获取可视化数据的方式。

Query 标签的页面由一下几个元素组成

Data source selector(数据源选择器)
Query options(查询选项)
Query inspector button(查询检查器按钮)
Query editor list(查询编辑器)
Expressions(表达式)

可以输入数据源的查询语句，查询结果将会实时展现在面板上，比如，从 Prometheus 中获取了节点内存使用率的数据：

Query 详解见 Query(查询)

Transform(转换)

Transform(转换) 用于将查询结果在面板展示之前进行处理。Transform 可以重命名字段、将单独的时间序列连接在一起、在查询中进行数学运算等等。常用于 Table 类型的面板

官方文档称为 Tranformations

Transformations process the result set of a query before it’s passed on for visualization. They allow you to rename fields, join separate time series together, do math across queries, and more. For users, with numerous dashboards or with a large volume of queries, the ability to reuse the query result from one panel in another panel can be a huge performance gain.

[!Attention] 转换是 Grafana 7.0 测试版的特性。官方文档的内容会在开发者们研究该特性时经常更新。

Transformations sometimes result in data that cannot be graphed. When that happens, Grafana displays a suggestion on the visualization that you can click to switch to table visualization. This often helps you better understand what the transformation is doing to your data

Transform 的用法详见：Transformations(转换)