Alauda Container Platform
  • 简体中文

    • 将 MonitorDashboard 迁移到 Perses

    目录

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

    概述

    从 Alauda Container Platform 4.4 开始，Perses 监控面板与现有的 MonitorDashboard 功能并行提供。您可以将现有的 MonitorDashboard 资源迁移为 PersesDashboard 资源，并从 Operations Center > Monitor > Dashboards (Perses) 中进行查看。

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

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

    前提条件

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

    • 目标集群已安装 Alauda Container Platform Dashboard for Perses。
    • global 集群已安装 Alauda Container Platform Dashboard Essentials。
    • 您对源 MonitorDashboard 资源具有读取权限。
    • 您对目标 PersesDashboard 资源具有 create 或 write 权限。

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

    迁移监控面板

    通过向 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 图表类型，例如 Time Series Chart、Stat Chart、Gauge Chart、Bar Chart、Pie Chart 和 Table。不支持的图表类型会保留为占位 Markdown 面板。
    查询查询会被重写为使用平台指标查询网关 observe-api。该面板不暴露数据源选择。
    显示名称和元数据可用时，会保留显示名称、描述、标签和文件夹信息。
    即时查询即时值查询会转换为 ACP Courier Instant Query。

    导入 Grafana JSON

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

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

    迁移后

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

    相关操作