sdbmonitor 工具是一款由 shell 程序和 javascript 程序组成的脚本工具,主要目的是为了帮助用户快速检查 SequoiaDB 巨杉数据库的运行状况。
目前 sdbmonitor 工具支持监控 SequoiaDB 巨杉数据库以下内容:
- 数据库平均每秒数据读、数据写和数据索引读的数据
- 节点状态,包括协调节点、编目节点和数据节点
- 分区组状态
- Node 节点会话数
- 分区组内从节点与主节点的 LSN 差距
- Node 节点的各个 CollectionSpace 空间占用情况
- Node 节点慢操作,包括:Query、Update、Upsert、Count、Delete、LobQuery、LobInsert、LobDelete
sdbmonitor 工具的参数选项如下
./sdbmonitor --help
Usage: sdbmonitor [OPTIONS]
--hosts host addresses(hostname:svcname), separated by ',',
for example 'sdb1:11810,sdb2:11810,sdb3:11810',
default:'localhost:11810'
-u username, default:''
-w password, default:''
--cm-service sdbcm's service, default:'11790'
-h, --help print help info
参数介绍如下:
参数名 | 是否必填 | 默认值 | 说明 |
---|---|---|---|
--hosts | 否 | localhost:11810 | 连接 SequoiaDB 数据库的 IP:SERVICE |
-u | 否 | SequoiaDB 数据库的鉴权用户 | |
-w | 否 | SequoiaDB 数据库的鉴权密码 | |
--cm-service | 否 | 11790 | SequoiaDB sdbcm 节点的端口 |
-h --help | 否 | 打印帮助信息 |
conf/alarm.js 文件,采用 JavaScript 语言编写,允许用户灵活调整各个监控项的告警阈值。
告警阈值说明如下:
参数 | 默认值 | 说明 |
---|---|---|
alarmSessionNum | 500 | Node 节点会话数过多普通告警 |
seriousSessionNum | 800 | Node 节点会话数过多严重告警 |
alarmLsnPercent | 0.6 | Node 从节点与 Node 主节点 LSN 差距过大普通告警 |
seriousLsnPercent | 0.8 | Node 从节点与 Node 主节点 LSN 差距过大普通告警 |
alarmCsSizePercent | 0.6 | Node 节点的 CollectionSpace 占用空间过大普通告警 |
seriousCsSizePercent | 0.8 | Node 节点的 CollectionSpace 占用空间过大严重告警 |
maxAlarmRelativeTime | 1 | Node 节点执行任务超过告警阈值后进行普通告警,单位:秒 |
maxSeriousRelativeTime | 5 | Node 节点执行任务超过告警阈值后进行严重告警,单位:秒 |
Note :
由于每个分区组的最大 LSN 值由节点 logfilesz 和 logfilenum 两个配置参数决定,所以 alarmLsnPercent 和 seriousLsnPercent 设置的告警阈值将计算该分区组的最大 LSN 后,再与 NodePercent 相乘
每个 Node 节点的 CollectionSpace 最大空间上限为 2TB,所以 alarmCsSizePercent 和 seriousCsSizePercent 设置的百分比为 2TB * NodePercent
sdbmonitor 工具只支持运行于 Linux 系统,并且环境需要预先安装 SequoiaDB 巨杉数据库,因为 sdbmonitor 工具依赖 SequoiaDB 的 sdb client 客户端。
如果用户需要监控但前服务器的 SequoiaDB 巨杉数据库状态,可以执行
./sdbmonitor
coord|DATAREAD|null|1|11:45:41|null|0|null
coord|DATAWRITE|null|0|11:45:41|null|0|null
coord|INDEXREAD|null|1|11:45:41|null|0|null
sdb1:11810|SESSIONTIMEOUT|1|8|10:05:24|SESSIONID:10,GETCOUNT|2|ScanType:TBSCAN,Collection:foo.bar,Matcher:{"$and":[{"name":{"$et":"test"}},{"num":{"$et":123}}]}
如果用户系统监控远程 SequoiaDB 巨杉数据库状态,可以执行
./sdbmonitor --hosts "sdb1:11810,sdb2:11810,sdb3:11810" -u "sdbtest" -w "sdbtest"
Note:
支持 SequoiaDB 巨杉数据库
2.6
、2.8
、3.0
和3.2
版本。用户执行完 sdbmonitor 工具后,会在执行路径生成 output 和 tmp 目录。output 目录主要用于保存每次工具收集的监控信息,tmp 目录则是工具执行过程中的临时文件。
为了让 sdbmonitor 工具终端输出的告警信息尽可能简洁,所以对 SESSIONTIMEOUT 监控项的部分信息做了空格替换处理,如需查看原始信息,请查阅 output/alarm_last.csv 和 output/result_last.csv 文件。
当 SESSIONTIMEOUT 监控项收集到多个 Node 节点执行相同操作时,工具将自动将其合并,并且在终端上打印
协调节点
发出的操作请求。各个 Node 节点的 SESSIONTIMEOUT 监控信息可以通过 output/result_last.csv 文件获取。
sdbmonitor 工具输出格式如下:
Field1 | Field2 | Field3 | Field4 | Field5 | Field6 | Field7 | Field8 |
---|---|---|---|---|---|---|---|
HOSTNAME + SERVICE | 监控项 | 告警阈值 | 当前值 | 时间 | 描述信息1 | 警告标记 | 描述信息2 |
Note:
警告标记,当该值为 0 时,证明该监控项为正常状态;如果该值为 1 时,证明该监控项处于普通告警状态;如果该值为 2 时,证明该监控项处于严重告警状态。
sdbmonitor 监控项介绍说明
监控项 | 说明 |
---|---|
DATAREAD | 数据库集群每秒数据读 |
DATAWRITE | 数据库集群每秒数据写 |
INDEXREAD | 数据库集群每秒索引读 |
CATALOG_LSN | 编目分区组主从 LSN 差距 |
DATANODE_LSN | 数据分区组主从 LSN 差距 |
CSSIZE | Node 节点 CollectionSpace 占用空间 |
SESSIONNUM | Node 节点会话数 |
SESSIONTIMEOUT | Node 节点操作超时监控 |
GROUPSTATUS | 分区组状态 |
NODESTATUS | Node 节点状态 |
Note:
GROUPSTATUS 监控项中,SYSCoord 分区组只要存在一个节点失效,则警告标记设置为 alarm,如果所有 coord 节点均失效,则警告标记设置为 serious;CatalogGroup 和 DataGroup 分区组则是当分区组内存在失效节点,并且存活节点超过半数,则警告标记设置为 alarm,如果存活节点少于或者等于半数,则警告标记设置为 serious。
NODESTATUS 监控项,在 SequoiaDB 2.6 版本中,只能够监控该 Node 节点状态为 Normal、FullSync 和 Fault 三种状态;在 SequoiaDB 2.8 以后版本,则支持监控 Node 节点的 Normal、Fault、Rebuilding、FullSync、OfflineBackup 五种状态。
SESSIONTIMEOUT 监控项,在终端和 alarm_last.csv 中输出时,描述信息1中将以 COORD_SESSIONID,EXECTYPE 形式输出,例如:SESSIONID:10,GETCOUNT;
SESSIONTIMEOUT 监控项,如果在 result_last.csv 中输出时,描述信息1中将以 HOSTNAME:SERVICE:COORD_SESSIONID,EXECTYPE 形式输出,例如:sdb1:11810:10,GETCOUNT
SESSIONTIMEOUT 监控项,EXECTYPE 对应表格
EXCECTYPE | 说明 |
---|---|
GETCOUNT | 数据表 count 操作 |
GETMORE | 数据表查询操作 |
UPDATE | 数据表更新操作 |
DELETE | 数据表删除操作 |
LOB WRITE | 数据表大对象写入操作 |
LOB READ | 数据表大对象读取操作 |
Note:
目前监控工具暂时不对 INSERT 操作进行监控
sdbmonitor 监控工具执行后,将在本地路径生成 output 目录,该目录将归档保存每次执行收集到的监控信息。
output 的目录结构
|____backup
| |____alarm_20190408.095644.csv
| |____result_20190408.095644.csv
| |____alarm_20190408.114541.csv
| |____result_20190408.114541.csv
|____alarm_last.csv
|____result_last.csv
backup 目录用于保存归档的监控信息。
警告信息将保存在 alarm_last.csv 文件中,result_last.csv 文件则保存所有监控项统计、整理后的数据。
alarm_last.csv 和 result_last.csv 文件是每次执行 sdbmonitor 工具后的最新数据,格式为CSV格式,字段分隔符为 "|",记录分隔符为 "\n"。
alarm_last.csv 文件的 demo 内容
sdb1:11810|SESSIONTIMEOUT|1|8|10:05:24|SESSIONID:10,GETCOUNT|2|ScanType:TBSCAN,Collection:foo.bar,Matcher:{ "$and": [ { "name": { "$et": "test" } }, { "num": { "$et": 123 } } ] }
result_last.csv 文件的 demo 内容
coord|DATAREAD|null|190091|10:05:24|null|0|null
coord|DATAWRITE|null|0|10:05:24|null|0|null
coord|INDEXREAD|null|1|10:05:24|null|0|null
sdb1:11820|CATALOG_LSN|8527|0|10:05:24|masterNode|0|null
sdb1:11840|DATANODE_LSN|799917492|0|10:05:24|masterNode|0|null
sdb1:11830|DATANODE_LSN|798410724|0|10:05:24|masterNode|0|null
sdb1:11850|DATANODE_LSN|799659343|0|10:05:24|masterNode|0|null
sdb1:11840|CSSIZE|2638827906662|1228996608|10:05:24|SYSSTAT|0|null
sdb1:11840|CSSIZE|2638827906662|1228996608|10:05:24|foo|0|null
sdb1:11830|CSSIZE|2638827906662|1228996608|10:05:24|SYSSTAT|0|null
sdb1:11830|CSSIZE|2638827906662|1228996608|10:05:24|foo|0|null
sdb1:11850|CSSIZE|2638827906662|155254784|10:05:24|SYSSTAT|0|null
sdb1:11850|CSSIZE|2638827906662|155254784|10:05:24|foo|0|null
sdb1:11850|CSSIZE|2638827906662|155254784|10:05:24|test|0|null
sdb1:11840|SESSIONNUM|500|43|10:05:24|null|0|null
sdb1:11830|SESSIONNUM|500|43|10:05:24|null|0|null
sdb1:11850|SESSIONNUM|500|43|10:05:24|null|0|null
SYSCoord|GROUPSTATUS|null|null|10:05:24|null|0|GroupIsNormal
SYSCatalogGroup|GROUPSTATUS|null|null|10:05:24|null|0|GroupIsNormal
group2|GROUPSTATUS|null|null|10:05:24|null|0|GroupIsNormal
group1|GROUPSTATUS|null|null|10:05:24|null|0|GroupIsNormal
group3|GROUPSTATUS|null|null|10:05:24|null|0|GroupIsNormal
sdb1:11810|NODESTATUS|null|null|10:05:24|Group:SYSCoord|0|nodeIsNormal
sdb1:11820|NODESTATUS|null|null|10:05:24|Group:SYSCatalogGroup|0|nodeIsNormal
sdb1:11840|NODESTATUS|null|null|10:05:24|Group:group2|0|nodeIsNormal
sdb1:11830|NODESTATUS|null|null|10:05:24|Group:group1|0|nodeIsNormal
sdb1:11850|NODESTATUS|null|null|10:05:24|Group:group3|0|nodeIsNormal
sdb1:11840|SESSIONTIMEOUT|1|8|10:05:24|sdb1:11810:10,GETCOUNT|2|ScanType:TBSCAN,Collection:foo.bar,Matcher:{ "$and": [ { "name": { "$et": "test" } }, { "num": { "$et": 123 } } ] }
sdb1:11830|SESSIONTIMEOUT|1|8|10:05:24|sdb1:11810:10,GETCOUNT|2|ScanType:TBSCAN,Collection:foo.bar,Matcher:{ "$and": [ { "name": { "$et": "test" } }, { "num": { "$et": 123 } } ] }
sdb1:11850|SESSIONTIMEOUT|1|8|10:05:24|sdb1:11810:10,GETCOUNT|2|ScanType:TBSCAN,Collection:foo.bar,Matcher:{ "$and": [ { "name": { "$et": "test" } }, { "num": { "$et": 123 } } ] }
sdbmonitor 工具的目录结构如下
|____script
| |____nodeInfo.js
| |____csstatus.js
| |____session.js
| |____node_rw_info.js
| |____groupInfo.js
| |____splitInfo.js
| |____printClass.js
| |____main.js
| |____function.js
| |____context.js
|____sdbmonitor
|____conf
| |____alarm.js
各个文件的作用如下:
文件名 | 开发语言 | 说明 |
---|---|---|
script/nodeInfo.js | JavaScript | 数据库 Node 节点的相关信息类 |
script/csstatus.js | JavaScript | 数据库 CollectionSpace 的信息收集类 |
script/session.js | JavaScript | 数据库快照 Session 的信息收集类 |
script/node_rw_info.js | JavaScript | 数据库读、写数据库信息收集类 |
script/groupInfo.js | JavaScript | 数据库分区组信息收集类 |
script/splitInfo.js | JavaScript | 数据库读、写信息管理类 |
script/printClass.js | JavaScript | JavaScript 程序输出类 |
script/main.js | JavaScript | JavaScript 程序的 Main 方法 |
script/function.js | JavaScript | JavaScript 程序的方法文件 |
script/context.js | JavaScript | 数据库快照 Context 的信息收集类 |
sdbmonitor | Shell | 工具执行程序,包含了 JavaScript 程序调用逻辑 |
conf/alarm.js | JavaScript | 工具的告警阈值 |