#Perses 监控仪表板

#功能概述

Perses 监控仪表板在 Alauda Container Platform 4.4 中推出，是基于开源 Perses 渲染引擎的新型仪表板功能。您可以查看内置仪表板、创建自定义仪表板、导入仪表板 JSON，以及管理集群的指标图表。

Perses 监控仪表板与现有的 监控仪表板 功能并存。现有的 MonitorDashboard 条目和资源仍然可用。您可以在需要通过 Perses 仪表板条目进行渲染时，将现有的 MonitorDashboard 资源迁移到 PersesDashboard 资源。有关详细信息，请参阅将 MonitorDashboard 迁移到 Perses。

第一阶段侧重于指标仪表板：

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

#先决条件

使用 Perses 监控仪表板之前，请安装以下组件：

有关安装说明，请参阅安装。如果所选集群尚未安装 Alauda Container Platform Dashboard，Perses 仪表板页面将显示安装指南，而不是仪表板列表。

#访问 Perses 仪表板

1. 登录容器平台管理视图。
2. 在左侧导航栏中，前往 运营中心 > 监控 > 仪表板 (Perses)。
3. 使用页面顶部的 集群选择器，选择要查看其仪表板的集群。

#查看仪表板

#仪表板列表

仪表板列表会显示您可以访问所选集群中的 Perses 仪表板。

#仪表板视图

单击仪表板名称以打开仪表板视图。

在仪表板视图中，您可以：

• 查看按图表组组织的图表。
• 使用仪表板变量筛选图表数据。
• 选择时间范围和刷新间隔。
• 在仪表板支持下载时下载仪表板数据。
• 单击 {}，以只读模式打开 仪表板 JSON。
• 在图表中打开 查询查看器，以只读模式查看 PromQL 查询、图例和最小步长。

由于平台指标数据源固定，查询查看器不会显示数据源信息。

对于内置仪表板，仪表板视图中的 编辑和设置功能已禁用。

#创建和编辑仪表板

#创建仪表板

1. 在 Perses 仪表板列表页面上，单击 创建。

2. 配置仪表板信息。

   字段	必填	描述
   名称	是	仪表板显示名称。
   描述	否	仪表板描述。
   文件夹	是	用于组织仪表板的文件夹。
   标签	否	用于组织和搜索仪表板的标签。

3. 确认创建。平台将打开仪表板编辑器。

资源名称由后端生成。您只需在 UI 中提供仪表板显示名称。

#使用仪表板编辑器

仪表板编辑器提供以下主要操作：

#添加图表

1. 在仪表板编辑器中，单击 添加图表。

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

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

   字段	描述
   查询语言	使用原生 PromQL。指标名称和标签支持自动补全。
   查询类型	范围查询使用 ACP Courier Query，即时查询使用 ACP Courier Instant Query。Bar、Gauge 和 Stat 图表通常使用即时查询来显示当前值。
   添加查询	向一个图表添加多个查询。

4. 根据需要配置其他选项卡，例如 常规设置、查询设置、链接和 JSON。

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

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

#添加变量

在编辑器中使用 变量 添加仪表板变量。

#编辑仪表板 JSON

在编辑模式下，单击 {} 以打开 编辑仪表板 JSON。您可以直接编辑仪表板定义。

#图表类型

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

此阶段不支持日志、trace 和性能分析图表。

#导入仪表板

1. 在仪表板列表页面，打开 创建 下拉菜单，然后选择 导入仪表板。

2. 配置导入信息。

   字段	必填	描述
   名称	是	仪表板显示名称。
   描述	否	仪表板描述。
   文件夹	是	用于整理仪表板的文件夹。
   仪表板 JSON	是	Perses 或 Grafana 仪表板 JSON。您可以上传文件或粘贴 JSON 内容。

3. 确认导入。

可以直接导入 Perses JSON。导入时，Grafana JSON 会转换为 Perses 模型。此转换会丢失部分信息，仅保留当前版本支持的图表类型和函数。

#管理仪表板

#故障排除

#页面显示安装指南而不是仪表板

所选集群尚未安装 Alauda Container Platform Dashboard。请在该集群中安装此组件，然后重新打开 仪表板（Perses）。

#仪表板没有数据

检查以下项目：

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

#某些内置仪表板显示 xxx-pd 等资源名称

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

#相关操作

• 将 MonitorDashboard 迁移到 Perses
• 安装
• 监控仪表板