Alauda Container Platform
  • 简体中文

    • 将 MonitorDashboard 迁移到 Perses

    目录

    概述前提条件迁移监控面板转换规则导入 Grafana JSON迁移后相关操作

    概述

    从 Alauda Container Platform 4.4 开始，除了现有的 MonitorDashboard 功能外，还可以使用 Perses 监控监控面板。您可以将现有的 MonitorDashboard 资源迁移为 PersesDashboard 资源，并在 Operations Center > Monitor > Dashboards (Perses) 中查看。

    迁移会将 Grafana 风格的 MonitorDashboard 模型转换为 PersesDashboard 模型。源 MonitorDashboard 会保留，并且仍可通过现有的监控监控面板入口访问。

    迁移是选择性的。您可以选择要迁移的 MonitorDashboard 资源，并通过添加迁移标签 kubectl 触发转换。

    前提条件

    迁移监控面板前，请确保满足以下要求：

    • 目标集群已安装 Alauda Container Platform Dashboard。
    • global 集群已安装 Alauda Container Platform Dashboard Essentials。
    • 您拥有源 MonitorDashboard 资源的读取权限。
    • 您拥有目标 PersesDashboard 资源的创建或写入权限。

    有关组件安装，请参阅安装。

    迁移监控面板

    通过向 MonitorDashboard 资源添加 cpaas.io/migrate-to-perses=true 标签来触发迁移。

    1. 列出 MonitorDashboard 资源，并确定要迁移的监控面板。

      kubectl get monitordashboards.ait.alauda.io -A

    2. 向 MonitorDashboard 资源添加迁移标签。

      kubectl label monitordashboards.ait.alauda.io <name> -n <namespace> cpaas.io/migrate-to-perses=true

    3. 验证是否已生成 PersesDashboard 资源。

      生成的 PersesDashboard 名称为 <source-monitor-dashboard-name>-pd。

      kubectl get persesdashboards.perses.dev <name>-pd -n <namespace>

    4. 在控制台中，转到 Operations Center > Monitor > Dashboards (Perses)，确认列表中显示了已迁移的监控面板，并且可以打开。

    INFO
    • 要迁移多个监控面板，请对每个监控面板运行标签命令。您可以批量迁移监控面板。
    • 迁移不会删除或修改源 MonitorDashboard。原始监控面板及其入口仍可访问。
    • 运行该命令的用户必须拥有读取 MonitorDashboard 资源和写入 PersesDashboard 资源的权限。

    转换规则

    迁移工具会将 MonitorDashboard 内容转换为 PersesDashboard 模型。

    转换项描述
    图表类型Grafana 风格的图表类型会映射为 Perses 图表类型，例如时间序列图表、统计图表、仪表盘图表、条形图表、饼图表和表格。不支持的图表类型会保留为占位 Markdown 面板。
    查询查询会被重写为使用平台指标查询网关 observe-api。监控面板不会公开数据源选择。
    显示名称和元数据在可用时，会保留显示名称、描述、标签和文件夹信息。
    即时查询即时值查询会转换为 ACP Courier Instant Query。

    导入 Grafana JSON

    如果您拥有 Grafana 监控面板 JSON，而不是 MonitorDashboard 资源，可以从 Perses Monitoring Dashboards 导入。在 Perses Monitoring Dashboards 中打开 Create 下拉菜单，选择 Import dashboard，然后提供 JSON 内容。

    Grafana JSON 导入使用有损的 Grafana 到 Perses 转换。只有当前平台版本支持的图表类型和函数会被保留。

    迁移后

    • 生成的 Perses 监控面板是可编辑的自定义监控面板。
    • 您仍可通过现有的监控面板入口访问源 MonitorDashboard。
    • 如果源监控面板不包含 cpaas.io/display-name 注解，迁移后的监控面板列表中可能会显示 Kubernetes 资源名称。这不会影响渲染或指标查询。

    相关操作