Grafana 监控

YMatrix 提供原生的基于 Grafana 的图形化监控工具，本文档描述了部署监控组件和管理使用的步骤。YMatrix 提供了一个缺省的监控面板，可监控下列信息。用户也可以根据系统收集的数据，在 Grafana 中创建新的面板自定义需要的监控项目。

集群状态、版本、当前连接数、启动时间、数据节点（Segment）状态
磁盘空间：主节点（Master）和 Segment 服务器的当前磁盘使用状况
数据库日志：浏览近期数据库上的日志，可以按警告、错误、严重、危重等级别过滤
可以查看近期数据库服务器的负载情况，包括：CPU、内存、磁盘 I/O、网络 I/O、进程数等
- 可以自由选定全部或部分主机进行查看
- 可以自由选定时间日期范围和自动刷新时间

部署后的效果图如下。从 4.4 版本开始，监控被分成了两个面板，分别为 MatrixDB Dashboard 和 MatrixDB Database。

MatrixDB Dashboard： MatrixDB Database：

并且为较难理解的面板增加了描述，鼠标悬停在面板左上角的图标即可获取： Panel Desc

1 部署

监控相关组件已包含在 YMatrix 的安装包中，在 YMatrix 部署后，通过指标采集激活和 Grafana 安装与配置两步，完成监控部署。

1.1 激活指标采集

通过下述操作可以激活对 YMatrix 和系统资源使用的指标采集，并将采集的数据存储到 YMatrix 新创建的数据库 matrixmgr 中。以下示例中 Master 为 mdw。

切换到 mxadmin 用户

[<普通用户>@mdw ~]$ sudo su - mxadmin

连接到 matrixmgr 数据库并激活指标采集

[mxadmin@mdw ~]$ psql -d matrixmgr
matrixmgr=# SELECT mxmgr_init_local();

成功后，可以观察到 matrixmgr 数据库下出现了名为 “local” 的新模式。该模式下的表和视图包含了集群的监控和配置信息。请勿自行更改这些表和视图的定义及内容。

1.2 Grafana 安装与配置

准备一台可以同时访问到 Master 和外网的主机，可以是 Master 或者 Standby Master 节点，也可以是一台单独的机器（Linux、MacOS、Windows 等系统均可）。

安装 Grafana 软件，建议 7.3 或更高版本。官方下载安装链接为 https://grafana.com/grafana/download。

下文的命令以 CentOS 7 为例描述操作方法，其他操作系统的命令请参考对应操作系统使用指南。

注意！
YMatrix 支持离线安装 Grafana，具体步骤请见监控告警 FAQ。

下载和安装 Grafana

wget https://dl.grafana.com/oss/release/grafana-7.3.6-1.x86_64.rpm
sudo yum install grafana-7.3.6-1.x86_64.rpm

启动 Grafana

[mxadmin@mdw ~]$ sudo systemctl daemon-reload
[mxadmin@mdw ~]$ sudo systemctl start grafana-server
[mxadmin@mdw ~]$ sudo systemctl status grafana-server
[mxadmin@mdw ~]$ sudo systemctl enable grafana-server

注意!
1） CentOS 7 中 yum 提供的 Grafana 版本通常比较旧（6.x），因此不推荐直接 sudo yum install grafana。
2）完整的官方安装配置流程参见如下链接 https://grafana.com/docs/grafana/latest/installation/rpm

安装完成后，使用浏览器访问下述 URL，可以看到 Grafana 首页。这里 3000 为 Grafana 默认访问端口，用户可以修改。使用默认的用户名和密码（admin / admin）登录。为确保安全，请自行更改密码，可在登陆后点击左下角的用户头像图标看到修改界面。

http://<安装节点的IP或者域名>:3000

配置监控面板

在 Grafana 安装就绪后，需要添加 YMatrix 中的 matrixmgr 数据库作为一个数据源，并导入预定义的监控面板。

添加数据源的步骤如下：添加数据源1 添加数据源2 添加数据源3

在导入预定义的报警面板进行部署配置之前，你需要先把 dashboard.json 和 database.json 文件拷贝到本地，思路为：首先在服务器上找到该文件，然后进行复制操作，最后在本地导入上传。具体步骤如下：

首先登陆服务器，切换至 mxadmin 用户，在图片所示路径处查找到 dashboard.json 和 database.json 文件。你可以使用 cd 命令，也可以使用 find 命令，或是其它任何你擅长使用的方法。此处 find 命令以 database.json 文件为例。

[mxadmin@mdw ~]$ cd /opt/ymatrix/matrixdb5/share/doc/postgresql/extension

##or

[mxadmin@mdw ~]$ find /opt/ymatrix/matrixdb5/share/doc/postgresql/extension -name database.json

其次，使用 scp 命令将文件复制到本地，此处可能会涉及到权限问题，可以考虑先将文件复制到公用区域 /tmp/ ，再从 /tmp/ 将文件复制到本地。此处以 database.json 文件为例。

注意！
将文件从 /tmp/ 复制到本地时要注意切换用户，以避免权限问题。

[mxadmin@mdw]$ scp mxadmin@< 服务器IP地址 >:/opt/ymatrix/matrixdb5/share/doc/postgresql/extension/"database.json" mxadmin@< 服务器IP地址 >:/tmp/

~ scp waq@< 服务器IP地址 >:/tmp/"database.json" /Users/akkepler/workplace/Grafana

最后直接点开本地文件夹，或者用命令行检查文件是否复制成功。成功后，在Grafana界面导入上传文件即可。

注意！
如果不能导入成功，请增加以下修改变量步骤。

将 dashboard.json 文件中所有 ${cluster} 修改为 local ，且 $host 为实际的全部主机名，意思即假如你现在拥有集群 master + 2 segment，名称分别叫做 mdw,sdw1,sdw2，那么你需要将你的 dashboard.json 文件中的所有 $host 均改为 'mdw','sdw1','sdw2' 。database.json 只需修改前者，修改完毕在Grafana界面导入上传文件即可。

添加数据源1

点击 Upload JSON file 按钮选择要导入的 dashboard.json 以及 database.json 文件。这两个文件均文件默认位于 /opt/ymatrix/matrixdb5/share/doc/postgresql/extension 目录下。

添加数据源3

2 管理

激活了集群状态采集后，每个主机都会运行采集服务，相关日志保存在 /var/log/matrixdb 目录下。

如果重启 YMatrix，或者重启服务器后再启动 YMatrix，数据采集服务也会自动启动，无需人工干预。

如需终止数据采集服务，可连接到 matrixmgr 数据库并执行 mxmgr_remove_all 命令，终止后已采集的数据会继续保留：

[mxadmin@mdw ~]$ psql -d matrixmgr

matrixmgr=# SELECT mxmgr_remove_all('local');

如人工终止数据采集服务或者 YMatrix 重新安装后，需要再次激活数据采集，可连接到 matrixmgr 数据库并执行 mxmgr_deploy 命令：

matrixmgr=# SELECT mxmgr_deploy('local');