服务端工具gs_collector的部分解读

背景信息

当openGauss发生故障时，使用此工具收集OS信息、日志信息以及配置文件等信息，来定位问题。可以使用-C参数，指定收集不同的信息内容，具体支持收集的内容信息。

前提条件

日志收集工具依赖操作系统工具，例如gstack为其中一种，如果未安装该工具，则提示错误后，跳过该收集项。

语法

• 日志收集（非root用户）

gs_collector --begin-time="BEGINTIME" --end-time="ENDTIME" [-h HOSTNAME | -f HOSTFILE] [--
keyword=KEYWORD] [--speed-limit=SPEED] [-o OUTPUT] [-l LOGFILE] [-C CONFIGFILE]

• 显示帮助信息

gs_collector -? | --help

• 显示版本号信息

gs_collector -V | --version

参数说明

• -h
  收集信息的主机名称。
  取值范围：主机名称，如果不指定则默认收集所有主机的信息。
• -f
  主机名称列表文件。该文件为纯文本格式。
• -o
  将收集日志以压缩包形式输出到指定的文件夹。
  不指定则将检查结果以压缩包形式输出到配置文件中tmpMppdbPath选项所指定的目录中。
  若配置文件中未配置tmpMppdbPath选项，则默认将检查结果以压缩包形式输出到“/tmp/用户名_mppdb/”目录中。
• -l
  指定的日志文件以及存放路径。
• -C
  指定待收集内容的配置文件，利用TypeName指定需要收集的信息类型，利用Content指定每一类信息的具体内容，利用Count指定此类信息收集的次数，利用Interval指定收集间隔，单位为秒。TypeName和Content不允许缺失或者内容为空。Interval和Count可以不指定，如果没有指定Count，则默认收集一次。如果没有指定Interval则表示间隔为0秒，Interval和Count的值不能小于0。如果不指定则使用默认的配置文件。
• –keyword=KEYWORD
  包含关键字KEYWORD的日志文件。
  若关键字KEYWORD中含有空格，需要使用双引号包围。
• –begin-time
  日志的开始时间。输入格式为“yyyymmdd hh:mm”。
• –end-time
  日志的结束时间。输入格式为“yyyymmdd hh:mm”。
• –speed-limit
  日志收集时的收集速率，输入格式为非负整数，单位为MB/s。该参数主要是为了防止日志收集过程中产生过高的磁盘或网络IO，导致数据库节点故障（如果它们与$GAUSSLOG/$PGHOST部署在同一个磁盘上）。该值应当不超过openGauss内上述磁盘IO与网络IO速率的最小值的1/3。
• -?, --help
  显示帮助信息。
• -V, --version
  显示版本号信息。

示例

执行如下命令收集OS信息和日志信息。

gs_collector --begin-time="20180131 23:00" --end-time="20180201 20:00" -h plat1 
Successfully parsed the configuration file.
create Dir.
Successfully create dir.
do system check interval 0 : count 1
Collecting OS information.
Successfully collected OS information.
do database check interval 0 : count 1
Collecting catalog statistics.
Successfully collected catalog statistics.
do log check interval 0 : count 1
Collecting Log files.
Successfully collected Log files.
do Config check 0:1
Collecting Config files.
Successfully collected Config files.
Collecting files.
Successfully collected files.
All results are stored in $PGHOST/collector_20200624_134541.tar.gz.