监控面板管理
目录
功能概述主要功能优势使用场景前置条件监控面板与监控组件的关系管理面板创建面板导入面板添加变量添加图表添加分组切换面板其他操作管理图表图表说明图表配置说明通用参数图表特殊参数通过 CLI 创建监控面板常用函数和变量常用函数常用变量变量使用示例一变量使用示例二使用内置指标时注意事项功能概述
平台提供强大的面板管理功能，旨在替代传统的 Grafana 工具，为用户带来更全面、更灵活的监控体验。该功能汇聚平台内的各类监控数据，呈现统一的监控视图，显著提升您的配置效率。
主要功能
- 支持为业务视图和平台视图配置自定义监控面板。
- 支持在业务视图中查看平台视图中配置的公共共享面板，数据根据业务所属的命名空间进行隔离。
- 支持管理面板内的图表，允许用户添加、删除、修改面板，支持面板的放大缩小及拖拽移动。
- 支持在面板中设置自定义变量，用于过滤查询数据。
- 支持在面板中配置分组，用于管理面板。分组可基于自定义变量重复展示。
- 支持的面板类型包括：趋势图、阶梯折线图、柱状图、水平柱状图、柱状仪表盘、仪表盘、表格、统计图、XY 图、饼图、文本。
- 支持一键导入 Grafana 面板。
优势
- 支持用户自定义监控场景，不受预设模板限制，真正实现个性化监控体验。
- 提供丰富的可视化选项，包括折线图、柱状图、饼图，布局和样式灵活多样。
- 与平台角色权限无缝集成，业务视图可定义自己的监控面板，同时保证数据隔离。
- 深度集成容器平台各项功能，支持即时访问容器、网络、存储等监控数据，为用户提供全面的性能观察和故障诊断。
- 完全兼容 Grafana 面板 JSON，方便从 Grafana 迁移继续使用。
使用场景
- IT 运维管理：作为 IT 运维团队成员，您可以使用监控面板统一展示和管理容器平台的各类性能指标，如 CPU、内存、网络流量等。通过自定义监控报表和告警规则，及时发现并定位系统问题，提高运维效率。
- 应用性能分析：对于应用开发和测试人员，监控面板提供丰富的可视化选项，直观展示应用运行状态和资源消耗。您可以针对不同应用场景定制专属监控视图，深入分析应用性能瓶颈，提供优化依据。
- 多集群管理：对于管理多个容器集群的用户，监控面板可汇聚不同集群的监控数据，帮助您一目了然掌握系统整体运行状况。
- 故障诊断：当系统出现问题时，监控面板为您提供全面的性能数据和分析工具，快速定位问题根因。您可以根据告警信息迅速查看相关监控指标波动，进行深入故障分析。
前置条件
目前监控面板仅支持查看平台中安装的监控组件采集的监控数据。因此，在配置监控面板前，请做好以下准备：
- 确保您要配置监控面板的集群已安装监控组件，具体为 ACP Monitor with Prometheus 或 ACP Monitor with VictoriaMetrics 插件。
- 确保您希望在面板中展示的数据已被监控组件采集。
监控面板与监控组件的关系
- 监控面板资源存储于 Kubernetes 集群中，您可通过顶部的 Cluster 标签切换不同集群视图。
- 监控面板依赖集群中的监控组件查询数据源，使用前请确保当前集群已成功安装监控组件且运行正常。
- 监控面板默认请求对应集群的监控数据。如果您在集群中以代理模式安装了 VictoriaMetrics 插件，平台会自动请求存储集群查询该集群对应的数据，无需额外配置。
管理面板
面板是由一个或多个图表组成的集合，按一行或多行组织排列，提供清晰的相关信息视图。这些图表可从数据源查询原始数据，并转换为平台支持的一系列可视化效果。
创建面板
- 点击 创建面板，参考以下说明配置相关参数。
- 添加完成后，点击 创建 完成面板创建。接下来需要 添加变量、添加图表 和 添加分组，完成整体布局设计。
导入面板
平台支持直接导入 Grafana JSON，将其转换为监控面板进行展示。
- 目前仅支持 Grafana JSON V8+ 版本，低版本禁止导入。
- 导入面板中若存在平台不支持的图表类型，可能显示为 不支持的面板类型，但可通过修改图表设置实现正常展示。
- 导入后可像普通面板一样进行管理操作，与平台创建的面板无异。
添加变量
- 在变量表单区域，点击 添加。
查询型变量
查询型变量允许基于时间序列的特征维度过滤数据。可指定查询表达式动态计算生成查询结果。
常量变量
常量变量是静态变量，值固定不变，常用于存储环境标识、固定阈值或需跨多个图表引用但不作为过滤选项展示的配置参数。
自定义变量
自定义变量允许用户定义预设的静态选项列表，作为面板上的下拉过滤器，常用于手动选择特定服务、团队或类别，无需动态数据查询。
文本框变量
文本框变量允许用户直接输入文本，常用于指定不需动态查询的特定值或参数。
- 点击 确定 添加一个或多个变量。
添加图表
向当前创建的监控面板添加多个图表，用于展示不同资源的数据。
提示：可点击图表右下角自定义图表大小；点击图表任意位置可调整图表顺序。
- 点击 添加图表，参考以下说明配置相关参数。
-
图表预览：动态展示所添加指标对应的数据。
-
添加指标：配置图表标题和监控指标。
-
添加方式：支持使用内置指标或原生自定义指标，两者取并集同时生效。
- 内置指标：选择平台内置的常用指标和图例参数，展示当前图表下的数据。
- 注意：添加到图表的所有指标必须单位统一，不能在同一图表添加多单位指标。
- 原生：自定义指标单位、指标表达式和图例参数。指标表达式遵循 PromQL 语法，详情请参考 PromQL 官方文档。
- 内置指标：选择平台内置的常用指标和图例参数，展示当前图表下的数据。
-
图例参数：控制图表中曲线对应的名称，可使用文本或模板：
- 规则：输入值必须为
{{.xxxx}}格式，例如{{.hostname}}会替换为表达式返回的 hostname 标签对应的值。 - 提示：若输入格式错误，图表中曲线名称将按原格式显示。
- 规则：输入值必须为
-
即时切换：开启 即时 开关时，通过 Prometheus 的 Query 接口查询即时值并排序，适用于统计图和仪表盘图表。关闭时使用
query_range方法计算，查询指定时间段内的一系列数据。 -
图表设置：支持选择不同图表类型可视化指标数据。详见 管理图表。
-
点击 保存 完成图表添加。
-
可在面板内添加一个或多个图表。
-
添加图表后，可通过以下操作确保图表显示和大小符合预期：
- 点击图表右下角自定义大小。
- 点击图表任意位置调整图表顺序。
- 点击 编辑 按钮修改图表设置。
- 点击 删除 按钮删除图表。
- 点击 复制 按钮复制图表。
-
调整完成后，点击面板页面的 保存 按钮保存修改。
添加分组
分组是面板内的逻辑划分，可将图表归类管理。
- 点击 添加图表 下拉菜单 > 添加分组，参考以下说明配置相关参数。
- 分组：分组名称。
- 重复：支持禁用重复或选择当前图表的变量。
- 禁用重复：不选择变量，使用默认创建的分组。
- 参数变量：选择当前图表中创建的变量，监控面板会为变量的每个对应值生成一行相同的子分组。子分组不支持修改、删除或移动图表。
- 添加分组后，可对分组执行以下操作管理面板显示：
- 分组可折叠或展开，隐藏面板部分内容。折叠分组内的图表不会发送查询。
- 将图表移动到分组内，使该图表由该分组管理。分组管理其与下一个分组之间的所有图表。
- 分组折叠时，也可整体移动该分组管理的所有图表。
- 分组的折叠与展开也属于面板调整，若希望下次打开面板时保持该状态，请点击 保存 按钮。
切换面板
将创建的自定义监控面板设置为主面板。再次进入监控面板功能时，默认展示主面板数据。
-
在左侧导航栏点击 运营中心 > 监控 > 监控面板。
-
默认进入主监控面板，点击 切换面板。
-
可通过标签筛选或名称搜索查找面板，并通过 主面板 开关切换主面板。
其他操作
您可以点击面板页面右侧的操作按钮，根据需要对面板执行操作。
管理图表
平台提供多种可视化方式，支持不同使用场景。本章主要介绍这些图表类型、配置选项及使用方法。
图表说明
图表配置说明
通用参数
图表特殊参数
通过 CLI 创建监控面板
-
新建 YAML 配置文件，命名为
example-dashboard.yaml。 -
在 YAML 文件中添加 MonitorDashboard 资源并提交，以下示例创建名为 demo-v2-dashboard1 的监控面板：
常用函数和变量
常用函数
定义查询设置时，除使用 PromQL 设置查询外，平台还提供以下常用函数供自定义查询设置参考。
常用变量
定义查询设置时，可将常用函数组合成变量，快速定义自定义变量。以下为部分常用变量定义，供参考：
变量使用示例一
使用 query_result(query) 函数查询值：node_load5，并提取 IP。
-
在 查询设置 中填写
query_result(node_load5)。 -
在 变量值预览 区域，预览示例为
node_load5{container="node-exporter",endpoint="metrics",host_ip="192.168.178.182",instance="192.168.178.182:9100"}。 -
在 正则表达式 中填写
/.*instance="(.*?):.*/过滤值。 -
在 变量值预览 区域，预览示例为
192.168.176.163。
变量使用示例二
-
添加第一个变量：namespace，使用 query_result(query) 函数查询值：
kube_namespace_labels，并提取命名空间。- 查询设置：
query_result(kube_namespace_labels)。 - 变量值预览：
kube_namespace_labels{container="exporter-kube-state", endpoint="kube-state-metrics", instance="12.3.188.121:8080", job="kube-state", label_cpaas_io_project="cpaas-system", namespace="cert-manager", pod="kube-prometheus-exporter-kube-state-55bb6bc67f-lpgtx", project="cpaas-system", service="kube-prometheus-exporter-kube-state"}。 - 正则表达式：
/.+namespace=\"(.*?)\".*/。 - 在 变量值预览 区域，预览示例包含多个命名空间，如
argocd、cpaas-system等。
- 查询设置：
-
添加第二个变量：deployment，引用前面创建的变量：
- 查询设置：
kube_deployment_spec_replicas{namespace=~"$namespace"}。 - 正则表达式：
/.+deployment="(.*?)",.*/。
- 查询设置：
-
向当前面板添加图表，引用前面添加的变量，例如：
- 指标名称：计算组件下 Pod 内存使用。
- 键值对：
kind：Deployment，name：$deployment，namespace：$namespace。
-
添加图表并保存后，可在面板首页查看对应图表信息。
使用内置指标时注意事项
以下指标使用自定义变量 namespace、name 和 kind，不支持 多选 和选择 全部。
namespace仅支持选择具体命名空间；name仅支持三类计算组件：deployment、daemonset、statefulset；kind仅支持指定类型之一：Deployment、DaemonSet、StatefulSet。
-
workload.cpu.utilization -
workload.memory.utilization -
workload.network.receive.bytes.rate -
workload.network.transmit.bytes.rate -
workload.gpu.utilization -
workload.gpu.memory.utilization -
workload.vgpu.utilization -
workload.vgpu.memory.utilization