> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siflow.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 管理监控看板

> 在人工智能平台中创建、更新、删除 PromQL 监控看板，并将看板用于训练、推理等模块的指标查看。

监控看板用于将 PromQL 查询配置为可复用图表，并挂载到训练、推理等支持看板的业务模块中。创建完成后，您可以在对应业务模块详情页查看自定义指标。

## 使用建议

* 先确认图表要挂载到哪个业务模块、子模块和分类，再配置指标查询。
* PromQL 应匹配目标模块的监控指标和变量；变量名称、标签口径和可用范围以控制台提示为准。
* 图例建议使用稳定的变量或指标维度，便于对比多条曲线或多个实例。

## 创建看板

看板图表需要同时配置挂载位置、展示方式和指标查询。挂载位置由模块、子模块和分类共同决定；指标查询由图例和 PromQL 组成。

1. 进入 **配置管理 > 看板管理**。
2. 选择区域。
3. 单击 **新建**。
4. 选择创建方式并填写看板配置。

<Tabs>
  <Tab title="Form">
    Form 适合按控制台字段逐项填写配置。

    | 配置项    | 说明                                        |
    | ------ | ----------------------------------------- |
    | 模块     | 选择看板挂载的业务模块。                              |
    | 子模块    | 选择模块下的具体位置。                               |
    | 分类     | 选择图表所属分类。                                 |
    | 图表类型   | 选择指标展示方式，例如 **Timeseries** 或 **HeatMap**。 |
    | 标题     | 图表展示标题。                                   |
    | 描述     | 图表说明。                                     |
    | 图例     | 指标曲线或序列的展示名称，可使用变量组合。                     |
    | PromQL | 指标查询表达式。表达式需要匹配目标模块的监控指标和变量，避免图表无数据或查询失败。 |

    如需展示多个指标，单击 **添加 Metric** 并继续配置。
  </Tab>

  <Tab title="JSON">
    JSON 适合复用已有配置、批量维护或精确编辑看板定义。以下为示例：

    ```json theme={null}
    {
      "module": "llm-inference",
      "subModule": "Vllm",
      "class": "By Instance",
      "format": "TimeSeries",
      "title": "vLLM 请求成功数",
      "description": "按服务统计最近 1 分钟内的成功请求数。",
      "metrics": [
        {
          "legend": "{{service}}",
          "query": "sum by (service) (increase(vllm:request_success_total{service=\"$service_name\",cluster=\"$cluster\"}[1m]))"
        }
      ]
    }
    ```
  </Tab>
</Tabs>

5. 单击 **新建**。

创建完成后，前往对应业务模块详情页确认图表展示和数据返回是否符合预期。

## 管理看板

在 **配置管理 > 看板管理** 中选择区域，找到目标看板后，可以在 **操作** 列更新或删除看板。

* **更新**：修改图表挂载位置、展示配置或 PromQL。更新后，请在对应业务模块详情页确认图表展示和数据返回是否符合预期。
* **删除**：删除不再需要的看板。删除前，请确认团队不再依赖该图表进行监控或排障。

## 相关文档

* [训练任务高级配置](../training/advanced-training-task-configuration)
* [推理服务高级运维](../inference/advanced-inference-service-operations)