# 打开管理后台监控功能

URL: https://docs.ones.cn/deploy/configure/ones-admin/open-ones-admin-monitor

本文面向实施维护人员，说明如何打开 ONES 管理后台中的监控功能。

管理后台打开方式请参考： [打开管理后台](https://docs.ones.cn/deploy/configure/ones-admin/open-ones-admin/) 。

## 1. 功能说明

管理后台的 `监控告警` 页面会嵌入 Grafana，用于查看环境监控面板。

该功能依赖 `ones-telemetry` 组件。只打开管理后台还不够，还需要部署监控组件。

## 2. 进入操作容器

生产环境在部署机执行：

```sh
./ones-ai-k8s.sh
```

进入容器后切到部署目录：

```sh
cd /data/ones/ones-ai-k8s
```

## 3. 部署监控组件

执行：

```sh
make setup-ones-telemetry
```

该命令会部署管理后台监控功能依赖的 `ones-telemetry` 组件，包括管理后台内嵌使用的 Grafana 服务。

## 4. 检查部署结果

确认 `ones-telemetry` 命名空间下的 Pod 正常：

```sh
kubectl -n ones-telemetry get pods
```

重点确认以下服务存在：

```sh
kubectl -n ones-telemetry get svc ones-admin-grafana-service
```

如果服务存在，并且相关 Pod 都是 `Running` 或 `Completed` ，说明监控组件基本部署完成。

也可以在操作容器中验证 Grafana 健康检查：

```sh
kubectl -n ones-installer exec deploy/installer-api -- \
  curl -sS -o /dev/null -w "%{http_code}\n" \
  http://ones-admin-grafana-service.ones-telemetry:8080/healthz
```

返回 `200` 表示管理后台可以访问内嵌 Grafana 服务。

## 5. 页面验证

浏览器打开管理后台：

```text
http://<管理后台访问地址>/ones-admin/
```

登录后，在左侧菜单点击 `监控告警` 。

正常情况下页面会加载 Grafana 监控面板。页面右上角可以点击 `全屏` 查看更大的监控视图。

如果需要直接打开监控页，请使用：

```text
http://<管理后台访问地址>/ones-admin/#/monitor
```

不要直接访问 `/ones-admin/monitor` ，管理后台前端使用 `#/monitor` 这种页面路由。

## 6. 常见问题

### 监控告警页面为空或加载失败

先检查是否已经执行：

```sh
make setup-ones-telemetry
```

再检查：

```sh
kubectl -n ones-telemetry get pods
kubectl -n ones-telemetry get svc ones-admin-grafana-service
```

如果 `ones-admin-grafana-service` 不存在，说明监控组件未部署成功。

### 页面提示监控未启用

请确认管理后台已经按文档打开，并确认 `installer-api` 已经使用最新配置启动。

可以重启一次：

```sh
kubectl -n ones-installer rollout restart deploy/installer-api
kubectl -n ones-installer rollout status deploy/installer-api
```

### 页面一直转圈

常见原因：

- `ones-telemetry` 相关 Pod 还在启动中。
- Grafana 服务未就绪。
- 集群资源不足，导致监控组件启动慢。
可以等待几分钟后刷新页面，再查看 Pod 状态和日志。

### 如何确认管理后台代理是否正常

在操作容器中执行：

```sh
curl -sS -o /dev/null -w "%{http_code}\n" \
  http://<管理后台访问地址>/ones-admin/grafana/
```

返回 `200` 或 `302` 通常表示代理链路已经通了。