#Perses 监控面板

#功能概述

Perses 监控面板在 Alauda Container Platform 4.4 中作为一项基于开源 Perses 渲染引擎的新监控面板能力引入。你可以查看内置监控面板、创建自定义监控面板、导入监控面板 JSON，以及管理集群的指标图表。

Perses 监控面板与现有的 Monitoring Dashboards 功能共存。现有的 MonitorDashboard 条目和资源仍然可用。当你希望在 Perses 监控面板条目中渲染现有监控面板时，可以将现有的 MonitorDashboard 资源迁移为 PersesDashboard 资源。更多信息请参见 将 MonitorDashboard 迁移到 Perses。

第一阶段聚焦于指标监控面板：

• 支持常见的指标图表类型。
• 平台指标数据源是固定的，不会在 UI 中暴露。
• 此阶段不支持日志、追踪和性能剖析可视化。

#前提条件

在使用 Perses 监控面板之前，请先安装以下组件：

安装说明请参见 Installation。如果所选集群尚未安装 Alauda Container Platform Dashboard for Perses，Perses 监控面板页面将显示安装指南，而不是监控面板列表。

#访问 Perses 监控面板

1. 登录到容器平台管理视图。
2. 在左侧导航栏中，进入 Operations Center > Monitor > Dashboards (Perses)。
3. 使用页面顶部的 Cluster 选择器，选择要查看其监控面板的集群。

#查看监控面板

#监控面板列表

监控面板列表会显示你在所选集群中可以访问的 Perses 监控面板。

#监控面板视图

点击监控面板名称以打开监控面板视图。

在监控面板视图中，你可以：

• 按图表组查看图表。
• 使用监控面板变量筛选图表数据。
• 选择时间范围和刷新间隔。
• 当监控面板支持时，下载监控面板数据。
• 点击 {} 以只读模式打开 Dashboard JSON。
• 从图表中打开 Query Viewer，以只读模式查看 PromQL 查询、图例和最小步长。

由于平台指标数据源是固定的，Query Viewer 不会显示数据源信息。

对于内置监控面板，监控面板视图中的 Edit 和 Settings 会被禁用。

#创建和编辑监控面板

#创建监控面板

1. 在 Perses 监控面板列表页面上，点击 Create。

2. 配置监控面板信息。

   字段	必填	描述
   Name	是	监控面板显示名称。
   Description	否	监控面板描述。
   Folder	是	用于组织监控面板的文件夹。
   Tags	否	用于组织和搜索监控面板的标签。

3. 确认创建。平台将打开监控面板编辑器。

资源名称由后端生成。你只需在 UI 中提供监控面板显示名称。

#使用监控面板编辑器

监控面板编辑器提供以下主要操作：

#添加图表

1. 在监控面板编辑器中，点击 Add Panel。

2. 在 Add Panel 抽屉中，配置图表名称、组、描述和图表类型。

3. 在 Query 选项卡中配置查询。

   字段	描述
   Query language	使用原生 PromQL。指标名称和标签支持自动补全。
   Query Type	对于范围查询，使用 ACP Courier Query；对于即时查询，使用 ACP Courier Instant Query。即时查询通常由 Bar、Gauge 和 Stat 图表用于当前值视图。
   Add Query	为一个图表添加多个查询。

4. 根据需要配置其他选项卡，例如 General Settings、Query Settings、Links 和 JSON。

5. 检查预览并保存图表。

查询区域会自动使用平台指标数据源，不会显示数据源选择器。

#添加变量

在编辑器中使用 Variables 来添加监控面板变量。

#编辑监控面板 JSON

在编辑模式下，点击 {} 打开 Edit Dashboard JSON。你可以直接编辑监控面板定义。

#图表类型

Perses 监控面板在此阶段支持以下指标图表类型：

此阶段不支持日志、追踪和性能剖析图表。

#导入监控面板

1. 在监控面板列表页面上，打开 Create 下拉菜单并选择 Import dashboard。

2. 配置导入信息。

   字段	必填	描述
   Name	是	监控面板显示名称。
   Description	否	监控面板描述。
   Folder	是	用于组织监控面板的文件夹。
   Dashboard JSON	是	Perses 或 Grafana 监控面板 JSON。你可以上传文件或粘贴 JSON 内容。

3. 确认导入。

可以直接导入 Perses JSON。Grafana JSON 会在导入过程中转换为 Perses 模型。该转换是有损的，只保留当前版本支持的图表类型和功能。

#管理监控面板

#故障排查

#页面显示安装指南而不是监控面板

所选集群尚未安装 Alauda Container Platform Dashboard for Perses。请在该集群中安装该组件，然后再次打开 Dashboards (Perses)。

#监控面板没有数据

请检查以下项目：

• Alauda Container Platform Dashboard Essentials 已在 global 集群中安装并运行。
• 所选集群中的监控数据采集和存储正常工作。
• 当前用户有权限查询目标集群、命名空间或项目的指标。

#某些内置监控面板显示诸如 xxx-pd 之类的资源名称

如果源监控面板不包含 cpaas.io/display-name 注解，某些迁移后的内置监控面板可能会显示 Kubernetes 资源名称而不是显示名称。这不会影响监控面板渲染或指标查询。

#相关操作

• 将 MonitorDashboard 迁移到 Perses
• Installation
• Monitoring Dashboards