更新日期:2024年09月11日
参数说明
-U
运行GBase 8c 的用户名称。
取值范围:运行GBase 8c 的用户名称。
-L
本地执行。
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
72
-i
指定检查项。格式-i CheckXX 详细的检查项请参见表3-3。
-e
场景检查项。
默认的场景有inspect
(例行巡检)
、
upgrade
(升级前巡检)
、
binary_upgrade
(就地升级前巡检)、health(健康检查巡检)、install(安装)等,用户可以根据需求自己
编写场景,详见用户自定义场景。
-l
指定日志文件路径,指定路径时需添加.log 后缀。
-o
指定检查结果输出文件夹路径。
--skip-root-items
跳过需要root 权限执行的检查项。
--skip-items
跳过指定的检查项。
--format
设置结果报告的格式。
--set
修复支持设置的Abnormal 项。
--cid
检查ID,仅被内部check 进程使用。
--time-out
设置超时时间。单位为秒,默认为1500s,若用户自定义超时时间不得少于1500s。
--routing
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
73
指定业务IP 的网段,格式为IP 地址:子网掩码。
--disk-threshold=“PERCENT”
检查磁盘占用时可选指定告警阈值,可指定1-99 之间的整数,不输入则默认为90。检
查其他项时不需要该参数。
-?, --help
显示帮助信息。
-V, --version
显示版本号信息。
表3-3 GBase 8c 状态检查表
状态
巡检项
检查内容
是
否
支
持
--se
t
os
CheckCPU
(检查CPU
使用率)
检查主机CPU 占用率,如果idle 大于30%并且
iowait 小于30%。则检查项通过,否则检查项不
通过。
否
CheckFirewall(检查
防火墙状态)
检查主机防火墙状态,
如果防火墙关闭则检查项
通过,否则检查项不通过。
是
CheckTimeZone
(检查
时区一致性)
检查GBase 8c 内各节点时区,如果时区一致则
检查通过,否则检查项不通过。
否
CheckSysParams(检
查系统参数)
检查各节点操作系统参数,判断是否等于预期
值。检查项不满足warning 域则报warning,不
满足NG 域则检查项不通过,并打印不满足项。
是
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
74
状态
巡检项
检查内容
是
否
支
持
--se
t
CheckOSVer(检查操
作系统版本)
检查GBase 8c 内各个节点的操作系统版本信息,
如果满足版本兼容列表且GBase 8c 在同一混搭
列表中则检查通过,否则检查不通过。
否
CheckNTPD(检查
NTPD 服务)
检查系统NTPD 服务,
如果服务开启且各节点时
间误差在1 分钟以内则检查项通过,
否则检查项
不通过。
否
CheckTHP(检查THP
服务)
检查系统THP 服务,如果服务开启则检查项通
过,否则检查项不通过。
是
CheckSshdService(检
查sshd 服务是否已启
动)
检查系统是否存在sshd 服务,若存在则检查项
通过,否则检查项不通过。
否
CheckCrondService(
检查crontab 服务是
否已启动)
检查系统是否存在crontab 服务,若存在则检查
项通过,否则检查项不通过。
是
CheckCrontabLeft(检
查crontab 是否有残
留Gauss 相关信息)
检查crontab 是否残留Gauss 相关信息,若无该
信息则检查项通过,否则检查项不通过。
是
CheckDirLeft(检查文
件目录是否有残留)
检查文件目录(/home/gbase/data)是否存在。若
mount 目录包含此目录则忽略;若不存在则查项
通过,否则检查项不通过。
是
CheckProcessLeft(检
查进程是否有残留)
检查是否残留gaussdb 和omm 进程,若未残留
则检查项通过,否则检查项不通过。
是
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
75
状态
巡检项
检查内容
是
否
支
持
--se
t
CheckStack(栈深度检
查)
检查栈深度,若各个节点不一致则报warning ,
若大于等于3072 则检查项通过,否则不通过。
是
CheckOmmUserExist(
检查gbase 用户是否
存在)
检查是否存在gbase 用户,若不存在gbase 用户
则检查项通过,否则检查项不通过。
是
CheckPortConflict(检
查数据库节点端口是
否占用)
检查数据库节点端口是否已被占用,
若未占用则
检查项通过,否则检查项不通过。
是
CheckSysPortRange
(检查
ip_local_port_range 设
置范围)
检查ip_local_port_range 系统参数范围,若范围
在26000~65535 则检查项通过,
否则检查项不通
过。
是
CheckEtcHosts(检查
/etc/hosts 中是否有重
复地址以及localhost
配置)
检查/etc/hosts 没有配置localhost 检查项不通过,
存在带有#GBase 8c 注释的映射则检查项不通
过,相同IP 不同hostname 则检查项不通过,否
则通过,若hostname 相同,但ip 不同检查项不
通过。
否
CheckCpuCount
(检查
CPU 核数)
检查CPU 核心与可用CPU 不符检查项不通过,
相符但存在不可用信息Warning。所有节点CPU
信息不相同检查项不通过。
否
CheckHyperThread
(检查超线程是否打
开)
检查超线程,若打开则检查项通过,否则检查项
不通过。
否
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
76
状态
巡检项
检查内容
是
否
支
持
--se
t
CheckMemInfo(检查
内存总大小)
检查各节点总内存大小是否一致,
若检查结果一
致,则检查项通过,否则报warning。
否
CheckSshdConfig(检
查sshd 服务配置是否
正确)
检查/etc/ssh/sshd_config 文件,
(a)PasswordAuthentication=yes;
(b)MaxStartups=1000;
(c)UseDNS=no;
(d)ClientAliveInterval 大于10800 或者等于0
配置如上所示则检查项通过,若a、c 配置不正
确则报warning,b、d 配置不正确则检查项不通
过。
是
CheckMaxHandle(检
查句柄最大设置)
检查操作系统最大句柄值,如果该值大于等于
1000000 则检查项通过,否则检查项不通过。
是
CheckKernelVer
(检查
内核版本)
检查各节点系统内核版本信息,
如果版本信息一
致则检查项通过,否则报Warning。
否
CheckEncoding
(检查
编码格式)
检查GBase 8c 内各个节点的系统编码,如果编
码一致则检查项通过,否则检查项不通过。
否
CheckBootItems(检
查启动项)
检查是否有手动添加的启动项,
如果没有则检查
通过,否则检查不通过。
否
CheckDropCache(检
查DropCache 进程)
检查各节点是否有dropcache 进程在运行,若有
则检查通过,否则检查不通过。
否
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
77
状态
巡检项
检查内容
是
否
支
持
--se
t
CheckFilehandle(检
查文件句柄)
此检查项检查以下两项,两项都通过为通过,否
则为不通过:
检查每个gaussdb 进程打开的进程数是否超过80
万,不超过则检查通过,否则检查不通过。
检查是否有slave 进程使用的句柄数超过master
进程,如果没有则检查通过,否则检查不通过。
否
CheckKeyProAdj(检
查关键进程omm_adj
的值)
检查所有关键进程,如果所有关键进程的
omm_adj 值为0,则通过,否则不通过。
否
CheckMaxProcMemor
y(检查
max_process_memory
参数设置是否合理)
检查数据库节点的max_process_memory 值,判
断该参数的值是否大于1G,若不大于则检查项
通过,否则检查项不通过。
是
device
CheckSwapMemory
(检查交换内存)
检查交换内存和总内存大小,
若检查结果为0 则
检查项通过,
否则检查项报Warning 大于总内存
时检查项不通过。
是
CheckLogicalBlock
(检查磁盘逻辑块)
检查磁盘逻辑块大小,若为512 则检查项通过,
否则检查项不通过。
是
CheckIOrequestqueue
(检查IO 请求)
检查IO 值,如果该值为32768 则检查项通过,
否则检查项不通过。
是
CheckMaxAsyIOrequ
ests
(检查最大异步IO
请求)
获取当前异步IO 请求值,
当前异步IO 请求值大
于当前节点数据库实例数*1048576 和
104857600 则检查项通过,否则检查项不通过。
是
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
78
状态
巡检项
检查内容
是
否
支
持
--se
t
CheckIOConfigure
(检
查IO 配置)
检查IO 配置,如果是deadline 则检查项通过,
否则检查项不通过。
是
CheckBlockdev
(检查
磁盘预读块)
检查磁盘预读块大小,如果预读块大小为16384
则检查项通过,否则检查项不通过。
是
CheckDiskFormat(检
查磁盘格式参数)
检查磁盘XFS 格式信息,如果配置为
'rw,noatime,inode64,allocsize=16m' 则检查项通
过,否则报warning。
否
CheckInodeUsage(检
查磁盘inodes 使用
率)
GBase
8c
路
径
(GAUSSHOME/PGHOST/GPHOME/GAUSSL
OG/tmp 及实例目录)
检查以上指定目录使用率,如果使用率超过
warning 阈值(默认为60%)报warning 超过
NG 阈值(默认为80%)则检查项不通过,否则
通过。
否
CheckSpaceUsage
(检
查磁盘使用率)
GBase
8c
路
径
(GAUSSHOME/PGHOST/GPHOME/GAUSSL
OG/tmp 及实例目录)
检查磁盘以上指定目录(目录列表)使用率,如
果使用率超过warning 阈值(默认为70%)报
warning 超过NG 阈值(默认为90%)则检查项
不通过。GBase
8c
路径下检查
GAUSSHOME/PGHOST/GPHOME/GAUSSLOG
/tmp/data 路径的剩余空间,
不满足阈值则检查项
不通过,否则通过。
否
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
79
状态
巡检项
检查内容
是
否
支
持
--se
t
CheckDiskConfig(检
查磁盘空间大小一致
性)
检查磁盘名大小挂载点是否一致,
若一致则检查
项通过,否则报warning。
否
CheckXid(检查
CheckXid 数值)
查询xid 的数值,如果大于10 亿报Warning,大
于18 亿则检查项不通过。
否
CheckSysTabSize(检
查每个实例的系统表
容量)
如果每一块磁盘的剩余容量大于该磁盘上所有
实例的系统表容量总和则检查项通过,
否则检查
项不通过。
否
cluster
CheckClusterState
(检
查GBase 8c 状态)
检查fencedUDF 状态,如果fencedUDF 状态为
down 则报warning;检查GBase 8c 状态,如果
GBase 8c 状态为Normal 则检查项通过,否则检
查项不通过。
否
CheckDBParams(检
查GBase 8c 参数)
检查数据库主节点检查共享缓冲区大小和Sem
参数。
数据库节点检查共享缓冲区大小和最大连接数。
共享缓冲区需要大于128KB 且大于shmmax 且
大于shmall*PAGESIZE
若存在数据库主节点,则Sem 值需大于(数据库
节点最大连接数+150)/16 向上取整。
以上项完全满足则检查项通过,
否则检查项不通
过。
是
CheckDebugSwitch
(检查日志级别)
在各节点检查各实例的配置文件中
log_min_messages 参数的值,为空则认为是
是
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
80
状态
巡检项
检查内容
是
否
支
持
--se
t
Warning,
判断日志级别非waring,
则报warning。
CheckUpVer(检查升
级版本是否一致)
检查GBase 8c 各个节点上升级包的版本,如果
一致则检查项通过,
否则检查项不通过。
使用时,
需指定升级软件包路径。
否
CheckDirPermissions
(检查目录权限)
检查节点目录
(实例Xlog 路径、
GAUSSHOME、
GPHOME、PGHOST、GAUSSLOG)权限,如
果目录有写入权限且不大于750 则检查项通过,
否则检查项不通过。
是
CheckEnvProfile(检
查环境变量)
检查节点环境变量($GAUSSHOME 、
$LD_LIBRARY_PATH 、$PATH ),检查
CMS/CMA/数据库节点进程的环境变量。
如果环
境变量存在并配置正确,
进程的环境变量存在则
检查项通过,否则检查项不通过。
否
CheckGaussVer
(检查
进程版本)
检查各个节点进程版本是否一致,
如果版本一致
则检查项通过,否则检查项不通过。
否
CheckPortRange(检
查端口范围)
若ip_local_port_range 的范围在阈值范围内(默
认是26000 65535 ),并且实例端口不在
ip_local_port_range 范围内则检查项通过,否则
检查项不通过。
否
CheckReadonlyMode
(检查只读模式)
检
查
GBase
8c
数
据
库
主
节
点
default_transaction_read_only值若为off则检查通
过,否则不通过。
否
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
81
状态
巡检项
检查内容
是
否
支
持
--se
t
CheckCatchup(检查
Catchup)
检查gaussdb 进程堆栈是否能搜索到
CatchupMain 函数,若搜索不到则检查项通过,
否则检查项不通过。
否
CheckProcessStatus
(检查gaussdb 进程
属主)
检查'gaussdb 进程属主,若不存在gbase 以外的
属主则检查项通过,否则检查项不通过。
否
CheckSpecialFile(特
殊文件检查)
检查tmp 目录(PGHOST)、OM 目录(GPHOME)、
日志目录(GAUSSLOG)、data 目录、程序目录
(GAUSSHOME)下文件是否存在特殊字符以及
非gbase 用户的文件,若不存在则检查项通过,
否则检查项不通过。
否
CheckCollector(检查
GBase 8c 的信息收
集)
在output 目录下查看信息收集是否成功,
若收集
成功则检查项通过,否则检查项不通过。
否
CheckLargeFile
(检查
数据目录大文件)
检查各个数据库节点目录是否存在超过4G 的文
件。任一数据库节点目录及其子目录有超过4G
的单个文件,则检查不通过,否则检查通过。
否
CheckProStartTime
(关键进程启动时间
检测)
检查关键进程启动时间是否间隔超过5 分钟,
超
过则检查不通过,否则检查通过。
否
CheckDilateSysTab
(检查系统表膨胀)
检查系统表是否膨胀,若膨胀则不通过,否则检
查通过。
是
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
82
状态
巡检项
检查内容
是
否
支
持
--se
t
CheckMpprcFile(检
测环境变量分离文件
改动)
检查是否存在对环境变量分离文件的改动,
若存
在则检查不通过,否则检查通过。
否
databa
se
CheckLockNum
(检查
锁数量)
检查数据库锁数量,查询成功检查项通过。
否
CheckArchiveParamet
er(检查归档参数)
检查数据库归档参数,
如果未打开或打开且在数
据库节点下则检查项通过,打开且不在数据库
主节点目录下则检查项不通过。
是
CheckCurConnCount(
检查当前连接数)
检查数据库连接数,
如果连接数小于最大连接数
的90%则检查项通过,否则检查项不通过。
否
CheckCursorNum(检
查当前游标数)
检查数据库的游标数,检查成功则检查项通过,
否则检查项不通过。
否
CheckMaxDatanode(
检查
comm_max_datanode
参数值范围小于数据
库节点个数)
检查最大数据库节点数,
若最大数据库节点数小
于xml 配置的节点数*数据库节点数(默认值为
90*5)报warning,否则检查项通过。
是
CheckPgPreparedXact
s(检查残留两阶段事
务)
检查pgxc_prepared_xacts 参数,
如果不存在二阶
段事务则检查项通过,否则检查项不通过。
是
CheckPgxcgroup(检
查pgxc_group 表中需
检查pgxc_group 表中需要重分布的个数,检查
结果为0 则通过,否则不通过。
否
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
83
状态
巡检项
检查内容
是
否
支
持
--se
t
要重分布的个数)
CheckLockState(GBas
e 8c 是否被锁)
检查GBase 8c 是否被锁,若GBase 8c 被锁则不
通过,否则检查项通过。
否
CheckIdleSession(检
查业务停止)
检查非空闲会话数,如果数量为0 则检查项通
过,否则检查项不通过。
否
CheckDBConnection(
检查数据库连接)
检查能否连接数据库,
如果连接成功则检查项通
过,否则检查项不通过。
否
CheckGUCValue(GU
C 参数检查)
检
查
(max_connections
+
max_prepared_transactions)
*
max_locks_per_transaction 的值,若该值大于等
于1000000 则检查项通过,否则检查项不通过。
是
CheckPMKData(检查
PMK 异常数据)
检查数据库PMK schema 是否包含有异常数据,
如果不存在异常数据则检查项通过,
否则检查项
不通过。
是
CheckSysTable(检查
系统表)
检查系统表,检查成功则检查项通过。
否
CheckSysTabSize(检
查每个实例的系统表
容量)
如果每一块磁盘的剩余容量大于该磁盘上所有
实例的系统表容量总和则检查项通过,
否则检查
项不通过。
否
CheckTableSpace(检
查表空间路径)
表空间路径和GBase 8c 路径之间不能存在嵌套
且表空间路径相互不能存在嵌套,则检查项通
否
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
84
状态
巡检项
检查内容
是
否
支
持
--se
t
过,否则检查项不通过。
CheckTableSkew(检
查表级别数据倾斜)
若存在表在GBase 8c 各数据库节点上的数据分
布不均衡,
且分布数据最多的数据库节点比最低
的数据库节点所分布的数据多100000 条以上,
则检查不通过,否则检查通过。
否
CheckDNSkew(检查
数据库节点级别数据
分布倾斜)
检查数据库节点级别的表倾斜数据,
若分布数据
最高的数据库节点比分布数据最低的数据库节
点数据量高于5%,则检查不通过,否则检查通
过。
否
CheckUnAnalyzeTabl
e(检查未做analyze
的表)
若存在未做analyze 的表,并且表中至少包含一
条数据,则检查不通过,否则检查通过。
是
CheckCreateView(创
建视图检查)
创建视图时,如果查询语句中含有子查询,并且
子查询结果查询解析和重写之后存在别名重复,
检查不通过,否则检查通过。
否
CheckHashIndex
(hash index 语法检
查)
如果存在hash index 则检查不通过,否则检查通
过。
否
CheckNextvalInDefau
lt(检查Default 表达
式中包含nextval
(sequence))
检查
Default
表达式中是否包含
nextval(sequence),若包含则不通过,否则通过。
否
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
85
状态
巡检项
检查内容
是
否
支
持
--se
t
CheckNodeGroupNa
me(Node group 编码
格式检查)
存在非SQL_ASCII 字符的Node Group 名称则检
查不通过,不存在则检查通过。
是
CheckPgxcRedistb
(检
查重分布残留的临时
表)
检查数据库中是否存在重分布残留的临时表,
若
不存在则检查通过,否则检查不通过。
否
CheckReturnType(用
户自定义函数返回值
类型检查)
检查用户自定义函数是否包含非法返回类型,
若
包含则检查不通过,否则检查通过。
否
CheckSysadminUser
(检查sysadmin 用
户)
检查除gbase 属主外是否存在数据库管理员用
户,若存在则不通过,否则检查通过。
否
CheckTDDate
(TD 数
据库中orc 表date 类
型列检查)
检查TD 模式数据库下的orc 表中是否包含date
类型的列,若包含检查不通过,否则检查通过。
否
CheckDropColumn
(drop column 检查)
如果存在drop column 的表,则检查不通过,否
则检查通过。
否
CheckDiskFailure(检
查磁盘故障)
对GBase 8c 中的所有数据做全量查询,若存在
查询错误则检查不通过,否则检查通过。
否
networ
k
CheckPing(检查网络
通畅)
检查GBase 8c 内所有节点的互通性,如果各节
点所有IP 均可ping 通则检查项通过,否则检查
项不通过。
否
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
86
状态
巡检项
检查内容
是
否
支
持
--se
t
CheckRXTX(检查网
卡RXTX 值)
检查节点backIP 的RX/TX 值,
如果该值为4096
则检查项通过,否则检查项不通过。
是
CheckMTU(检查网卡
MTU 值)
检查节点backIP 对应的网卡MTU 值(bond 后
的物理网卡要确保一致),如果该值不是8192
或1500 报warning 若openGaussMTU 值一致则
检查项通过,否则检查项不通过。
是
CheckNetWorkDrop(
检查网络掉包率)
检查各IP1 分钟内网络掉包率,如果不超过1%
则检查项通过,否则检查项不通过。
否
CheckBond(检查网卡
绑定模式)
检查是否有配置
BONDING_OPTS
或
BONDING_MODULE_OPTS,若没有配置则报
warning。检查各节点bond 模式是否一致,如果
同时满足则检查项通过,否则检查项不通过。
是
CheckMultiQueue(检
查网卡多队列)
检查cat /proc/interrupts,判断是否开启网卡多队
列且绑定不同CPU,
如果满足则检查项通过,
否
则检查项不通过。
是
CheckUsedPort(检查
随机端口使用数量)
检查net.ipv4.ip_local_port_range,范围大于等于
OS 默认值通过(32768-61000);
检查TCP 协议随机端口数,小于总随机端口数
的80%通过。
否
CheckNICModel(网
卡型号和驱动版本一
致性检查)
检查各个节点的网卡型号以及驱动版本是否一
致,一致则通过,否则报warning。
否
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
87
状态
巡检项
检查内容
是
否
支
持
--se
t
CheckRouting(本地
路由表检查)
检查各节点在业务IP 网段的IP 个数,超过1 个
则报warning,否则检查通过。
否
CheckNetSpeed(检查
网卡接收带宽,ping
值,丢包率)
网络满载时,
检查网卡平均接收带宽大于600MB
通过;
网络满载时,检查网络ping 值,小于1 秒通过;
网络满载时,检查网卡丢包率,小于1%通过。
否
other
CheckDataDiskUsage(
检查数据库节点磁盘
空间使用率)
检查磁盘数据库节点目录使用率,
如果使用率低
于90%则检查项通过,否则检查项不通过。
否
CheckNetSpeed 检查项:
CheckNetSpeed 不支持-L 本地检查模式,-L 模式无法构造网络压力,检查的结果
不准确。
在节点数小于6 时,speed_test 构造的网络压力可能无法跑满带宽,可能会造成检
查结果不准确。