#监控面板管理

#功能概述

平台提供强大的面板管理功能，旨在替代传统的 Grafana 工具，为用户带来更全面、更灵活的监控体验。该功能汇聚平台内的各类监控数据，呈现统一的监控视图，显著提升您的配置效率。

#主要功能

• 支持为业务视图和平台视图配置自定义监控面板。
• 支持在业务视图中查看平台视图中配置的公共共享面板，数据根据业务所属的命名空间进行隔离。
• 支持面板的管理，允许用户添加、删除、修改面板，支持面板的放大缩小及拖拽移动。
• 支持在面板中设置自定义变量，用于过滤查询数据。
• 支持在面板中配置分组，用于管理面板。分组可基于自定义变量进行重复显示。
• 支持的面板类型包括：趋势图、阶梯折线图、柱状图、水平柱状图、柱状仪表图、仪表图、表格、统计图、XY 图、饼图、文本。
• 支持一键导入 Grafana 面板。

#优势

• 支持用户自定义监控场景，不受预定义模板限制，真正实现个性化监控体验。
• 提供丰富的可视化选项，包括折线图、柱状图、饼图，以及灵活的布局和样式配置。
• 与平台的角色权限无缝集成，允许业务视图定义自己的监控面板，同时确保数据隔离。
• 深度集成容器平台的各项功能，支持即时访问容器、网络、存储等监控数据，为用户提供全面的性能观察和故障诊断。
• 完全兼容 Grafana 面板 JSON，方便从 Grafana 迁移并继续使用。

#使用场景

• IT 运维管理：作为 IT 运维团队成员，您可以使用监控面板统一展示和管理容器平台的各类性能指标，如 CPU、内存、网络流量等。通过自定义监控报表和告警规则，及时发现并定位系统问题，提高运维效率。
• 应用性能分析：对于应用开发和测试人员，监控面板提供多样化的可视化选项，直观展示应用运行状态和资源消耗。您可以定制针对不同应用场景的专属监控视图，深入分析应用性能瓶颈，为优化提供依据。
• 多集群管理：对于管理多个容器集群的用户，监控面板可聚合不同集群的监控数据，帮助您一目了然地掌握系统整体运行状况。
• 故障诊断：当系统出现问题时，监控面板为您提供全面的性能数据和分析工具，快速定位问题根因。您可以根据告警信息迅速查看相关监控指标的波动，进行深入故障分析。

#前置条件

目前，监控面板仅支持查看平台中安装的监控组件采集的监控数据。因此，在配置监控面板前，您需做好以下准备：

• 确保要配置监控面板的集群已安装监控组件，具体为 ACP Monitor with Prometheus 或 ACP Monitor with VictoriaMetrics 插件。
• 确保您希望在面板中展示的数据已被监控组件采集。

#监控面板与监控组件的关系

• 监控面板资源存储于 Kubernetes 集群中，您可通过顶部的 Cluster 标签切换不同集群视图。
• 监控面板依赖集群中的监控组件查询数据源，因此使用前请确保当前集群已成功安装监控组件且运行正常。
• 监控面板默认向对应集群请求监控数据。如果您在集群中以代理模式安装了 VictoriaMetrics 插件，平台将自动请求存储集群查询该集群对应的数据，无需特殊配置。

#管理面板

面板是由一个或多个图表组成的集合，按行组织排列，提供清晰的相关信息视图。这些图表可从数据源查询原始数据，并转换为平台支持的一系列可视化效果。

#创建面板

1. 点击 创建面板，参考以下说明配置相关参数。

2. 添加完成后，点击 创建 完成面板创建。接下来需 添加变量、添加图表 和 添加分组，完成整体布局设计。

#导入面板

平台支持直接导入 Grafana JSON，将其转换为监控面板进行展示。

• 目前仅支持 Grafana JSON V8+ 版本，低版本禁止导入。
• 导入面板中若包含平台不支持的图表类型，可能显示为 不支持的面板类型，但可通过修改图表设置实现正常显示。
• 导入后可像普通面板一样进行管理操作，与平台创建的面板无异。

#添加变量

1. 在变量表单区域，点击 添加。

查询型变量

查询型变量允许基于时间序列的特征维度过滤数据，可指定查询表达式动态计算生成查询结果。

常量变量

常量变量是固定值的静态变量，在整个面板中保持不变，常用于存储环境标识、固定阈值或需跨多个图表引用但不作为筛选选项显示的配置参数。

自定义变量

自定义变量允许用户定义预设的静态选项列表，作为面板的下拉筛选，常用于手动选择特定服务、团队或类别，无需动态数据查询。

文本框变量

文本框变量允许用户直接输入文本，常用于指定不需动态查询的特定值或参数。

2. 点击 确定 添加一个或多个变量。

#添加图表

向当前创建的监控面板添加多个图表，展示不同资源的数据。

提示：可点击图表右下角自定义大小；点击图表任意位置可调整图表顺序。

1. 点击 添加图表，参考以下说明配置相关参数。

• 图表预览：动态显示添加指标对应的数据。

• 添加指标：配置图表标题和监控指标。

• 添加方式：支持使用内置指标或原生自定义指标，两者取并集同时生效。

  • 内置指标：选择平台内置的常用指标和图例参数，展示当前图表下的数据。
    • 注意：所有添加到图表的指标必须单位统一，不能在同一图表添加多单位指标。
  • 原生：自定义指标单位、指标表达式和图例参数。指标表达式遵循 PromQL 语法，详情请参考 PromQL 官方文档。

• 图例参数：控制图表中曲线对应的名称，可使用文本或模板：

  • 规则：输入值必须为 {{.xxxx}} 格式，例如 {{.hostname}} 会替换为表达式返回的 hostname 标签对应的值。
  • 提示：若输入格式错误，图表中曲线名称将按原格式显示。

• 即时切换：开启 即时 开关时，通过 Prometheus 的 Query 接口查询即时值并排序，适用于统计图和仪表图；关闭时使用 query_range 方式计算，查询特定时间段内的一系列数据。

• 图表设置：支持选择不同图表类型展示指标数据。详见 管理图表。

2. 点击 保存 完成图表添加。

3. 可在面板内添加一个或多个图表。

4. 添加图表后，可通过以下操作确保图表显示和大小符合预期：

   • 点击图表右下角自定义大小。
   • 点击图表任意位置调整图表顺序。
   • 点击 编辑 按钮修改图表设置。
   • 点击 删除 按钮删除图表。
   • 点击 复制 按钮复制图表。

5. 调整完成后，点击面板页面的 保存 按钮保存修改。

#添加分组

分组是面板内的逻辑分隔符，可将图表归类管理。

1. 点击 添加图表 下拉菜单 > 添加分组，参考以下说明配置相关参数。

• 分组：分组名称。
• 重复：支持禁用重复或选择当前图表的变量。
  • 禁用重复：不选择变量，使用默认创建的分组。
  • 参数变量：选择当前图表创建的变量，监控面板会为变量的每个对应值生成一行相同的子分组。子分组不支持修改、删除或移动图表。

2. 添加分组后，可对分组进行以下操作，管理面板在面板中的显示：
   • 分组可折叠或展开，隐藏部分面板内容。折叠的分组内图表不会发送查询。
   • 将图表移动到分组内，使该图表由该分组管理。分组管理其与下一个分组之间的所有图表。
   • 分组折叠时，也可整体移动该分组管理的所有图表。
   • 分组的折叠与展开也视为对面板的调整，若希望下次打开面板时保持该状态，请点击 保存。

#切换面板

将已创建的自定义监控面板设为主面板。再次进入监控面板功能时，默认显示主面板数据。

1. 在左侧导航栏点击 运维中心 > 监控 > 监控面板。

2. 默认进入主监控面板，点击 切换面板。

3. 可通过标签筛选或名称搜索查找面板，通过 主面板 开关切换主面板。

#其他操作

可点击面板页面右侧的操作按钮，根据需要对面板执行操作。

#管理图表

平台提供多种可视化方式，支持不同使用场景。以下章节主要介绍这些图表类型、配置选项及使用方法。

#图表说明

#图表配置说明

#通用参数

#图表特殊参数

#通过 CLI 创建监控面板

1. 新建 YAML 配置文件，命名为 example-dashboard.yaml。

2. 在 YAML 文件中添加 MonitorDashboard 资源并提交，以下示例创建名为 demo-v2-dashboard1 的监控面板：

   kind: MonitorDashboard
   apiVersion: ait.alauda.io/v1alpha2
   metadata:
     annotations:
       cpaas.io/dashboard.version: '3'
       cpaas.io/description: '{"zh":"描述信息","en":""}' # 描述字段
       cpaas.io/operator: admin
     labels:
       cpaas.io/dashboard.folder: demo-v2-folder1 # 文件夹
       cpaas.io/dashboard.is.home.dashboard: 'False' # 是否为主面板？
     name: demo-v2-dashboard1 # 名称
     namespace: cpaas-system # 命名空间（所有管理视图创建均在此 ns）
   spec:
     body: # 所有信息字段
       titleZh: 更新显示名称 # 中文显示名称内置字段（该字段在中文语言下创建）
       title: english_display_name # 英文显示名称内置字段（该字段在英文语言下创建）内置面板可设置双语翻译。
       templating: # 自定义变量
         list:
           - hide: 0 # 0 表示不隐藏；1 表示仅隐藏标签；2 表示标签和值均隐藏
             label: 集群 # 内置变量显示名称（标签根据语言设置为对应名称，如英文为 cluster）
             name: cluster # 内置变量名称（唯一）
             options: # 定义下拉选项；若查询获取数据则使用请求数据，否则使用 options。可设置默认值（一般仅用于设置默认值）
               - selected: false # 是否默认选中
                 text: global
                 value: global
             type: custom # 自定义变量类型；目前仅支持内置（custom）和查询（query）（导入 Grafana 会支持常量自定义区间（导入后会变为自定义变量，不支持自动））
   
           - allValue: '' # 选择全部，传递格式为 xxx|xxx|xxx 的选项；可设置 allValue 进行转换（Grafana 获取当前变量所有数据为 xxx|xxx|xxx，调整后保证一致）
             current: null # 变量当前值，未设置时默认列表第一个
             definition: query_result(kube_namespace_labels) # 查询表达式
             hide: 0 # 0 表示不隐藏；1 表示仅隐藏标签；2 表示标签和值均隐藏
             includeAll: true # 是否选择全部
             label: ns # 内置变量显示名称
             multi: true # 是否允许多选
             name: ns # 变量名称（唯一）
             options: []
             query: ''
             regex: /.*namespace=\"(.*?)\".*/ # 用于提取变量值的正则表达式
             sort: 2 # 排序：1 - 升序字母；2 - 降序字母（暂仅支持这两种）；3 - 升序数字；4 - 降序数字
             type: query # 自定义变量类型
       time: # 面板时间
         from: now-30m # 起始时间
         to: now # 结束时间
       repeat: '' # 行重复配置；选择自定义变量
       collapsed: 'false' # 行折叠或展开配置
       description: '123' # 描述（标题后的提示）
       targets: # 数据源
         - indicator: cluster.node.ready # 指标
           expr: sum (cpaas_pod_number{cluster=\"\"}>0) # PromQL 表达式
           instant: false # 查询模式 true 表示查询某一时刻数据
           legendFormat: '' # 图例
           range: true # 查询数据时默认查询范围
           refId: 指标1 # 数据源显示名称唯一标识
       gridPos: # 面板位置信息
         h: 8 # 高度
         w: 12 # 宽度（宽度对应 24 个网格单位）
         x: 0 # 水平位置
         y: 0 # 垂直位置
       panels: # 图表数据
         title: 图表标题tab # 图表名称
         type: table # 图表类型；当前支持 timeseries、barchart、stat、gauge、table、bargauge、row、text、pie（阶梯图、散点图、柱状图通过 drawStyle 属性配置）
         id: a2239830-492f-4d27-98f3-cb7ecb77c56f # 唯一标识
         links: # 链接
           - targetBlank: true # 新标签页打开
             title: '1' # 名称
             url: '1' # URL 地址
         transformations: # 数据转换
           - id: 'organize' # 类型 organize；用于排序、调整顺序、显示字段、是否显示
             options:
               excludeByName: # 隐藏字段
                 cluster_cpu_utilization: true
               indexByName: # 排序
                 cluster_cpu_utilization: 0,
                 Time: 1
               renameByName: # 重命名
                 Time: ''
                 cluster_cpu_utilization: '222'
           - id: 'merge' # 合并数据
             options:
         fieldConfig: # 定义图表属性和外观
           defaults: # 默认配置
             custom: # 自定义图形属性
               align: 'left' # 表格对齐方式：left、center、right
               cellOptions: # 表格阈值配置
                 type: color-text # 阈值颜色设置仅支持文本
               spanNulls: false # true 连接 null 值；false 不连接；数字 == 0 按 0 连接 null 值
               drawStyle: line # 图表类型：line，bars 为柱状图，points 为点图
               fillOpacity: 20 # drawStyle 为 area 时存在（当前不支持配置，area 默认 20）
               thresholdsStyle: # 配置阈值显示方式（当前仅支持线）
                 mode: line # 阈值显示格式（area 当前不支持）
               lineInterpolation: 'stepBefore' # 阶梯图配置；默认仅支持 stepBefore（后续支持 stepAfter）
             decimals: 3 # 小数点位数
             min: 0 # 最小值（页面配置当前不支持，仅支持已适配导入）
             max: 1 # 最大值（页面配置仅 stat gauge barGauge pie 适用）
             unit: '%' # 单位
             mappings: # 数值映射配置（当前仅支持值和范围类型；特殊类型支持数据）
               - options: # 值映射规则
                   '1': # 对应值
                     index: 0
                     text: 'Running' # 值为 1 时显示 Running
                 type: value # 值映射类型
               - options: # 范围映射规则
                   from: 2 # 范围起始值
                   to: 3 # 范围结束值
                   result: # 映射结果
                     index: 1
                     text: 'Error' # 2 到 3 之间的值显示 Error
                 type: range # 范围映射类型
               - type: special # 特殊场景映射类型
                 options:
                   match: null # nan null null+nan empty true false
                   result:
                     text: xxx
                     index: 2
             thresholds: # 阈值配置
               mode: absolute # 阈值配置模式，绝对值模式（当前仅支持绝对值和百分比模式；百分比模式暂不支持）
               steps: # 阈值步骤
                 - color: '#a7772f' # 阈值颜色
                   value: '2' # 阈值值
                 - color: '#007AF5' # 默认值无值为基准
           overrides: # 覆盖配置
             - matcher:
                 id: byName # 按字段名匹配
                 options: node # 对应名称
               properties: # 覆盖配置；id 当前仅支持 displayName unit
                 - id: displayName # 显示名覆盖
                   value: '1' # 覆盖显示名
                 - id: unit # 单位覆盖
                   value: GB/s # 单位值
                 - id: noValue # 无值显示
                   value: 无值显示
         options:
           orientation: horizontal # 控制图表布局方向；适用于 gauge 和 barGauge（stat 后续支持）
           legend: # 图例配置
             calcs: # 计算方法（仅图例位置在右侧时显示）
               - latest # 当前仅支持最新值
             placement: right # 图例位置（right 或 bottom，默认 bottom）
             placementRightTop: '' # 右上角配置
             showLegend: true # 是否显示图例
           tooltip: # 提示信息
             mode: multi # 模式双选（仅支持多模式）鼠标悬停时显示所有数据
             sort: asc # 排序：asc 或 desc
           reduceOptions: # 数值计算方法（用于聚合数据）
             calcs: # 计算方法（latest、minimum、maximum、average、sum）
               - latest
             limit: 3 # 饼图限制切片数
           textMode: 'value' # 统计图配置；定义指标值显示样式；选项有 auto、value、value_and_name、name、none（页面配置暂不支持，导入支持）
           colorMode: 'value' # 统计图配置；定义指标值显示颜色模式；选项有 none、value、background（默认 value；页面配置不支持，导入适配）
           displayLabels: ['name', 'value', 'percent'] # 饼图标签显示字段
           pieType: 'pie' # 饼图类型；选项 pie 和 donut
           mode: 'html' # 文本图类型模式；选项 html 和 richText
           content: '<div>xxx</div>' # 文本图内容
           footer:
             enablePagination: true # 表格启用分页

#常用函数和变量

#常用函数

定义查询设置时，除使用 PromQL 设置查询外，平台还提供以下常用函数供自定义查询设置参考。

#常用变量

定义查询设置时，可结合常用函数定义变量，快速定义自定义变量。以下为常用变量定义，供参考：

#变量使用示例一

使用 query_result(query) 函数查询 node_load5 值，并提取 IP。

1. 在 查询设置 中填写 query_result(node_load5)。

2. 在 变量值预览 区域，预览示例为 node_load5{container="node-exporter",endpoint="metrics",host_ip="192.168.178.182",instance="192.168.178.182:9100"}。

3. 在 正则表达式 中填写 /.*instance="(.*?):.*/ 过滤值。

4. 在 变量值预览 区域，预览示例为 192.168.176.163。

#变量使用示例二

1. 添加第一个变量：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 等。

2. 添加第二个变量：deployment，引用前面创建的变量：

   • 查询设置：kube_deployment_spec_replicas{namespace=~"$namespace"}。
   • 正则表达式：/.+deployment="(.*?)",.*/。

3. 向当前面板添加图表，引用之前添加的变量，例如：

   • 指标名称：计算组件下 Pod 内存使用。
   • 键值对：kind: Deployment，name: $deployment，namespace: $namespace。

4. 添加图表并保存后，可在面板首页查看对应图表信息。

#使用内置指标时注意事项

• 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