59 lines
2.5 KiB
Markdown
59 lines
2.5 KiB
Markdown
本文介绍如何在 K8s 集群中为 PolarDB-X 数据库开启监控功能。
|
||
## 安装 PolarDB-X Monitor
|
||
PolarDB-X 通过 Prometheus 和 Grafana 来监控 PolarDB-X 集群。PolarDB-X Monitor 集成了 [kube-promethus](https://github.com/prometheus-operator/kube-prometheus) 组件栈，通过安装 PolarDB-X Monitor 即可一键部署监控所需的资源和组件。
|
||
### 前置要求
|
||
|
||
1. 已经准备了一个运行中的 K8s 集群，并确保集群版本 >= 1.18.0
|
||
2. 已经安装了 [Helm 3](https://helm.sh/docs/intro/install/)
|
||
3. 已经安装 PolarDB-X Operator 1.2.0 及以上的版本
|
||
|
||
### Helm 包安装
|
||
首先创建一个名为 polardbx-monitor 的命名空间:
|
||
|
||
```bash
|
||
kubectl create namespace polardbx-monitor
|
||
```
|
||
|
||
安装 PolarDBXMonitor CRD:
|
||
> 注意：如果您的 PolarDB-X Operator 1.2.0及以上 是通过 helm install 直接安装的，PolarDBXMonitor 的 CRD 会默认安装，可以跳过这步。如果您的 PolarDB-X Operator 是 从1.1.0 及以下的低版本通过 helm upgrade 升级而来，需要执行如下命令手工安装：
|
||
|
||
```bash
|
||
kubectl apply -f https://raw.githubusercontent.com/polardb/polardbx-operator/v1.4.0/charts/polardbx-operator/crds/polardbx.aliyun.com_polardbxmonitors.yaml
|
||
```
|
||
|
||
执行如下命令安装 PolarDB-X Monitor：
|
||
|
||
```bash
|
||
helm install --namespace polardbx-monitor polardbx-monitor polardbx-monitor-1.4.0.tgz
|
||
```
|
||
|
||
您也可以通过 PolarDB-X 的 Helm Chart 仓库安装:
|
||
|
||
```bash
|
||
helm repo add polardbx https://polardbx-charts.oss-cn-beijing.aliyuncs.com
|
||
helm install --namespace polardbx-monitor polardbx-monitor polardbx/polardbx-monitor
|
||
```
|
||
|
||
> 注：通过这种方式安装 Prometheus 和 Grafana 采用的都是默认配置便于快速体验。如果部署在生产集群，你可以参考: [配置 Prometheus + Grafana](./4-prom-config.md)
|
||
>
|
||
> 注：如果您是在 minikube 上安装 PolarDB-X Monitor, 可能会因为资源不够导致组件无法创建，可以参考: [配置 Prometheus + Grafana](./4-prom-config.md)
|
||
|
||
|
||
期望看到如下输出：
|
||
|
||
```shell
|
||
polardbx-operator monitor plugin is installed. Please check the status of components:
|
||
|
||
kubectl get pods --namespace {{ .Release.Namespace }}
|
||
|
||
Now start to monitor your polardbx cluster.
|
||
```
|
||
|
||
PolarDB-X Monitor 安装完成后，会在您 K8s 集群的 polardbx-monitor 命名空间下创建 prometheus 和 grafana 等组件，以此来监控 K8s 内的 PolarDB-X，通过如下命令检查相关组件是否正常，确认所有的 pod 都处于 Running 状态。
|
||
|
||
```bash
|
||
kubectl get pods -n polardbx-monitor
|
||
```
|
||
|
||
|