Prometheus

前提条件

连接的数据源已创建，如何创建请参见Prometheus数据源。

创建Prometheus数据集

1. 参考登录AstroCanvas界面中操作，登录AstroCanvas界面。
2. 在主菜单中，选择“数据中心”。
3. 在左侧导航栏中，选择“数据集 > 全部”。
4. 在数据集管理页面，单击“新建数据集”。
5. 在新增数据集页面，设置数据集名称、选择数据类型、数据源和目录，单击“保存”。
   图1 新建数据集
   
   • 数据集名称：新建数据集的名称，用于标识该数据集。长度为1~60个字符，可包括中文、字母、数字及下划线。
   • 数据类型：选择“Prometheus”。
   • 数据源：选择Prometheus数据源中，创建的数据源。
   • 目录：设置数据集的存放目录，配置为（可选）新建目录中新建的目录，也可以直接单击“新增目录”，新建一个目录。
   • 责任人：数据集的创建人。
   • 描述：新建数据集的描述信息，通常设置为数据集的功能。

6. 配置数据集参数。
   图2 配置数据集参数
   
   • 查询类型：设置查询数据的类型，如查询时间范围内的数据或瞬时数据。
   • 查询周期：设置查询时间的周期，某一个时间段内或某个时间点。
   • 最大采样点数：设置查询数据的个数，取值范围为[1, 10000]。假设，查询周期设置为过去的3小时，最大采样点数设置为100，则每108秒（3小时*60分*60秒/100）返回1个数据点。
     图3 查询过去三小时的数据
     
   • 最小时间间隔：每个数据点之间最小的时间间隔，取值范围为[1, 40000000]。
   • 查询配置：单击“新增查询”，可增加promQL查询，最多只支持添加8条，支持设置变量。
   • 测试API接口：用于测试该接口，单击“测试API接口”，“样例报文”中会显示输出结果。
   • 样例报文：对应API接口的响应样例报文数据格式，数据集的元数据结构由该样例报文经转换器处理后的数据结构确定。

     单击“格式化”，可对样例报文进行格式化处理。

   • 转换器：建议使用系统预置的“PromAPI预置连接器”，用于对数据进行转换处理。

7. 单击“保存”，完成Prometheus数据集的创建。

在组件中使用数据集

1. 返回AstroCanvas项目列表页面。
2. 进入大屏应用开发页面，拖拽所需组件（如多折线图）到画布中。
   图4 拖拽多折线图到画布中
   

3. 选中该组件，单击组件上方的，进入组件数据页面。
4. 在“数据类型”下拉框中，选择“数据集”，选择创建Prometheus数据集中创建的数据集。
5. 配置全局变量。

   全局变量可以理解为参数变量，用于控制组件之间参数的传递，从而达到交互的目的，例如图表联动、自定义字段等功能。如何使用全局变量，可参考如何基于页面级的全局变量实现组件交互~如何通过全局变量，实现组件数据的动态变化。本示例不做配置。

6. 在组件预览中，选择要展示的表字段，即从左边栏中拖入到右边栏中，单击“保存”。
   图5 拖拽字段到坐标轴
   
   • 表格字段：展示创建Prometheus数据集中，获取的数据。
   • 配置：从表格字段中，拖拽所需的字段到X轴数据、Y轴数据和系列中。
   • 刷新周期：每隔多少秒从HTTP连接器中读取一次数据，默认配置为“0”，表示只获取一次。
   • 共享数据：是否共享数据。勾选后，如果多个组件调用了相同的桥接器URL请求，不会各自只调用，而是共享结果数据。

7. 单击页面上方的，保存设置页面。
8. 单击，进入预览页面，预览效果。