# 内置指标视图

面向主机、容器和常见中间件的预置视图，以及怎么加自己的。

最后校对于 2026-10-10

这页办完你会得到：不写一行 PromQL，点着指标名就能看图；以及把团队自己的查询也录进 这个目录，让不熟 PromQL 的同事也能用。

## 这个页面解决什么[​](#这个页面解决什么 "这个页面解决什么的直接链接")

新接了一个组件，你知道数据进来了，但不知道**哪些指标值得看**。指标视图就是一本 指标目录册：按「组件类型 + 分类」组织，每条带指标名、单位、PromQL 和一句中文说明， 点一下就出图。

全新安装就带 1300 多条，覆盖 Linux、MySQL、Redis、Nginx、Kafka、ClickHouse、 Kubernetes 等常见组件。

它和[即时查询](https://n9e.github.io/zh/docs/query/metric-explorer.md)的分工：那边是写 PromQL 的人临时排障用的， 这边是给全员的例行巡检和「新组件有啥可看」用的。

**数据查询 → 指标 → 指标视图**（`/metrics-built-in`）。

## 1. 先配过滤条件，再点指标[​](#1-先配过滤条件再点指标 "1. 先配过滤条件，再点指标的直接链接")

![指标视图](https://n9e.github.io/zh/img/docs/query/metrics-built-in.zh.webp)![指标视图](https://n9e.github.io/zh/img/docs/query/metrics-built-in.zh.dark.webp)

左边那一栏叫「过滤条件」，作用是**在你点击一条指标查图时，自动给查询加上一组标签条件**。

界面上的原话：配置并选中 `{ident="n9e01"}` 之后，查 `cpu_usage_idle` 实际发起的是 `cpu_usage_idle{ident="n9e01"}`。

**强烈建议先配一条再点指标。** 不配的话，`cpu_usage_idle` 这种指标一点就是全环境几千条 曲线，浏览器直接卡住。

点左栏右上角的 + 新建一条：

| 字段     | 填什么                                   |
| -------- | ---------------------------------------- |
| 名称     | 起个名字，比如「Trading 生产机」         |
| 数据源   | 这组过滤条件对哪个数据源生效             |
| 过滤条件 | 标签条件，比如 `ident="n9e01"`           |
| 授权团队 | 哪些团队能用，以及是**读写**还是**只读** |

## 2. 找到你要的指标[​](#2-找到你要的指标 "2. 找到你要的指标的直接链接")

顶上四个筛选器：**组件类型**（Linux、MySQL、Kubernetes…）、**分类**（组件下的二级 分类，比如 Linux 下的 cpu / mem / disk）、**单位**、**关键字搜索**（在指标名、PromQL、 说明里模糊搜）。

表格默认显示五列：组件类型、分类、指标名称、单位、PromQL。右上角的 **显示列** 还能打开 表达式类型、指标类型、自定义字段、描述、更新人。

「指标名称」这一列显示的是这条指标的**说明**（可点），真正的表达式在 PromQL 列。 点说明就打开一个查询抽屉，直接出图；抽屉里还能 **添加面板** 叠几条一起比。

选中几行之后，**更多操作** 里可以导出指标（JSON）、导入指标、删除。

## 3. 加一条自己的指标[​](#3-加一条自己的指标 "3. 加一条自己的指标的直接链接")

点 **创建指标**：

| 字段       | 填什么                                                                |
| ---------- | --------------------------------------------------------------------- |
| 组件类型   | 选已有的，或者新建一个                                                |
| 分类       | 二级分类                                                              |
| 表达式类型 | **指标名称**（直接就是一个指标名）或 **PromQL**（带函数的完整表达式） |
| 指标类型   | Gauge / Counter / Histogram                                           |
| PromQL     | 实际的查询语句                                                        |
| 单位       | 展示时的单位换算                                                      |
| 自定义字段 | 名称 + 值，随你放业务信息                                             |
| 指标说明   | 按语言分别填**指标名称**（必填）和**描述**——列表里显示的就是这个      |

注意：**没有一个顶层的「名字」字段**，名字在「指标说明」里按语言各填一份。只填了中文的 指标，英文界面下会显示不出来。

创建、修改、删除分别受 `/builtin-metrics/add`、`/put`、`/del` 三个权限点控制。

## 目录是从哪儿来的[​](#目录是从哪儿来的 "目录是从哪儿来的的直接链接")

这一点决定了你该去哪儿改：

* 内置那 1300 多条来自后端 `integrations/<组件>/metrics/*.json`，**在 n9e-center 启动时 加载进来**，不是任何界面动作触发的，也不需要你去「导入」；
* 你在这个页面上建的指标存在数据库里。**同一条 PromQL 上，数据库里的那条盖过文件里的** ——所以内置指标改不动的时候，办法是照抄一条新建、PromQL 保持一样；
* 集成中心 → 模板中心里每个组件下也有一个「指标说明」页，那是同一批数据的另一个入口， 改哪边都一样。

这份目录还有两个消费方：即时查询输入框左边的「内置指标」按钮，以及设备列表里 [一键看指标](https://n9e.github.io/zh/docs/query/object-view.md)的那个抽屉。

## 下一步[​](#下一步 "下一步的直接链接")

* 自己写 PromQL：[即时查询](https://n9e.github.io/zh/docs/query/metric-explorer.md)
* 按机器看：[对象快捷视图](https://n9e.github.io/zh/docs/query/object-view.md)
* 组件模板还带什么：[导入仪表盘与规则](https://n9e.github.io/zh/docs/data/integrations/import.md)