诊断工具 scrutinize 从 Vertica 群集中收集大量信息。它还支持一系列选项，这些选项可让您控制所收集数据的数量和类型。收集的数据可以包括但不限于：
主机诊断和配置数据
运行时状态（正常或故障节点数）
来自安装过程、数据库和管理工具的日志文件（例如，
vertica.log、dbLog、/opt/vertica/log/adminTools.log）
错误消息
数据库设计
系统表信息，如系统、资源、工作负载和性能
编录元数据，如系统配置参数
备份信息
scrutinize 要求将群集配置为支持管理工具实用程序。如果管理工具无法在发起主机上运行，则 scrutinize 也无法在该主机上运行。
可以使用以下命令运行 scrutinize：
$ /opt/vertica/bin/scrutinize
未限定的 scrutinize 会从所有群集节点中收集大量信息。它会将结果存储在 .tar 文件 (
VerticaScrutinize.NumericID.tar) 中，这可最大程度地减小对数据库性能的影响。 scrutinize 输出可以帮助诊断大多数问题，但通过省略细粒度的分析数据来减小上传大小。
scrutinize 旨在收集用于对数据库和群集进行故障排除的信息。根据您的系统配置，通过运行 scrutinize 生成的日志可能包含专有信息。如果您担心共享专有信息，请先将其从 .tar 文件中移除，然后再将其发送给 Vertica 客户支持以寻求帮助。
scrutinize 选项支持以下任务：
您必须具有数据库管理员 (dbadmin) 权限才能运行 scrutinize。如果在 dbadmin 用户存在时以 root 用户身份运行 scrutinize，Vertica 会返回错误。
scrutinize 需要临时磁盘空间，以便在发布最终的压缩 (.tar) 输出之前收集数据。空间量取决于多个变量，例如 Vertica 日志和所提取系统表的大小，以及用于限制信息收集范围的用户指定选项。在 scrutinize 运行之前，它会验证临时目录至少包含 1 GB 空间；但是，实际所需的空间量可能要高得多。
可以将 scrutinize 输出重定向到另一个目录。有关详细信息，请参阅重定向 scrutinize 输出。
如果在群集上定义了多个数据库，并且多个数据库处于活动状态，或者没有一个数据库处于活动状态，则必须使用以下选项之一运行 scrutinize：
$ /opt/vertica/bin/scrutinize {--database=database | -d database}
如果在满足这些条件时省略此选项，scrutinize 会返回错误。
scrutinize 支持两个不能与任何其他选项结合使用的信息选项：
‑‑version=> \!scrutinize --version
Scrutinize Version 10.0.1-20200426
‑‑help ‑h=> \! scrutinize -h
Usage: scrutinize [options]
Options:
--version show program's version number and exit
-h, --help show this help message and exit
-X LIST, --exclude-tasks=LIST
Skip tasks of a particular type. Provide a comma-
separated lists of types to skip. Types are case-
sensitive. Possible types are: Command, File,
VerticaLog, DC, SystemTable, CatalogObject, Query,
all.
...
默认情况下，scrutinize 在执行时使用临时目录 /opt/vertica/tmp 执行来编译输出。完成收集后，它会将收集内容保存到当前目录的 tar 文件中。可以使用以下两个选项重定向 scrutinize 输出：
‑‑tmpdir=path该目录必须至少具有 1 GB 的可用空间。
您必须对该目录具有写入权限。
‑‑output_dir=path‑o pathscrutinize 结果保存到 path 中的 tar 文件。例如：
$ scrutinize ‑‑output_dir="/my_diagnostics/"
scrutinize 可以指定用户名和密码，如下所示：
‑‑user=username‑U usernamescrutinize 使用调用用户的用户名。‑‑password=password
‑P passwordscrutinize 命令的实参。如果管理员帐户（默认为 dbadmin）具有密码身份验证，请使用此选项。如果在受密码保护的数据库上省略此选项，scrutinize 会返回警告，除非设置了环境变量
VSQL_PASSWORD。
带有特殊字符的密码必须用单引号括起来。例如：
$ scrutinize -P '@passWord**'
$ scrutinize --password='$password1*'
‑prompt‑password ‑Wscrutinize 选项可让您控制数据收集的范围。您可以根据以下条件指定数据收集的范围：
通过以下几个选项，可以限制 scrutinize 收集的数据量：
‑‑by‑second‑‑by‑minute=boolean‑value‑‑get‑files file‑list‑‑include_gzlogs=num‑files‑z num‑filesscrutinize 输出中包括 num‑files 个轮换日志文件 (vertica.log*.gz)，其中 num‑files 可以是以下值之一：
整数指定要收集的循环日志文件的数量。
all 指定收集所有轮换日志文件。
默认情况下，scrutinize 会包含三个滚动日志文件。
‑‑log-limit=limit‑l limitscrutinize 收集 1 GB 的日志数据。默认情况下，scrutinize 收集所有群集节点中的数据。您可以指定 scrutinize 通过以下两种方法在各个节点中收集：
‑‑local_diags ‑sscrutinize 的主机中收集诊断数据。要从群集中的多个节点收集数据，请使用 ‑‑hosts 选项。‑‑hosts=host‑list ‑n host‑list例如：
$ scrutinize --hosts=127.0.0.1,host_3,host_1
scrutinize 提供了几个选项，可用于指定要收集的数据的类型：
‑‑debug‑‑diag‑dump‑‑diagnostics‑‑include‑ros‑info‑‑no‑active‑queries ‑‑with‑active‑queriesscrutinize 收集此信息 (‑‑with‑active‑queries)。‑‑tasks=tasks -T tasks‑‑exclude 一起使用。
‑‑type=type -t typeprofiling：收集分析数据。
context：收集摘要信息。
‑‑with‑active‑queries‑‑no‑active‑queries。scrutinize 选项还允许您指定要从其收集中排除的数据的类型：
‑‑exclude=tasks ‑X tasksall：所有默认任务
DC：数据收集器表
File：来自安装过程、数据库和管理工具的日志文件，例如 vertica.log、dbLog 和 adminTools.log
VerticaLog：Vertica 日志
CatalogObject：Vertica 编录元数据，例如系统配置参数
SystemTable：包含有关系统、资源、工作负载和性能的信息的 Vertica 系统表
Query：使用 vsql 连接到数据库的 Vertica 元函数，例如 EXPORT_CATALOG()
Command：操作系统信息，例如节点已启动的时间长度
‑‑no‑active‑queriesscrutinize 始终会收集活动查询信息 (‑‑with‑active‑queries)。‑‑vsql-off ‑vQuery 和 SystemTable 任务。此选项可帮助您处理升级期间遇到的问题，并且通常在以下情况下使用：
Vertica 正在运行，但响应缓慢。
您尚未创建数据库，但需要帮助解决其他群集问题。
scrutinize 提供了将数据上传到 Vertica 客户支持的多个选项。
当使用上传选项时，scrutinize 不会将所有输出捆绑到单个 tar 文件中。相反，每个节点将其输出直接发布到指定的 URL，如下所示：
上传较小的上下文文件，使客户支持能够查看高层次信息。
完成 scrutinize 执行后，上传完整的诊断集合。
使用上传选项运行 scrutinize 之前：
在运行 scrutinize 的数据库管理员用户的路径中安装 cURL 程序。
确认群集中的各节点能否直接与 Internet 建立 HTTP 或 FTP 连接。
scrutinize 输出上传到 Vertica 支持提供的 URL 或 FTP 地址： ‑‑auth-upload 和 ‑‑url。每个选项对上传进行身份验证的方式有所不同，如下所述。
‑‑auth‑upload=url‑A url‑‑url=url‑u url‑‑message=message‑m messagescrutinize 输出的消息，其中 message 是文本字符串、文本文件的路径或用于打开要在其中编写消息的输入流的 PROMPT。 scrutinize 会读取输入，直至您另起一行键入句点 (.)。这会关闭输入流，并且 scrutinize 会将消息写入收集到的输出中。
消息会写入 output 目录中的 reason.txt。如果未指定消息，则 scrutinize 会生成默认消息 Unknown reason for collection。消息通常包括以下信息：
收集/提交诊断数据的原因。
支持人员提供的案例编号和其他特定于问题的信息，以帮助 Vertica 客户支持识别您的案例并分析问题。
‑‑auth‑upload 选项使用您的 Vertica 来标识您自己：
$ scrutinize -U username -P 'password' --auth-upload="support-provided-url"
‑‑url 选项在 URL 中包括支持人员提供的 FTP 用户名和密码：
$ scrutinize -U username -P 'password' --url='ftp://username/password@customers.vertica.com/'
您可以将消息以文本字符串或文本文件的形式提供：
$ scrutinize --message="re: case number #ABC-12345"
$ scrutinize --message="/path/to/msg.txt"
或者，您可以打开输入流并键入消息：
$ scrutinize --message=PROMPT Enter reason for collecting diagnostics; end with '.' on a line by itself:
Query performance degradation noticed around 9AM EST on Saturday
.
Vertica Scrutinize Report
-----------------------------
Result Dir: /home/dbadmin/VerticaScrutinize.20131126083311
...
本部分中的故障排除建议可帮助您解决在使用 scrutinize 时可能遇到的常见问题。
要缩短收集时间，运行 scrutinize 的实例时请忽略系统表。请注意，从更少的节点进行收集并不一定会加快收集过程。
输出大小取决于系统表大小和 Vertica 日志大小。
要创建更小的 scrutinize 输出，请忽略一些系统表或截断 Vertica 日志。有关详细信息，请参阅缩小 scrutinize 数据收集的范围。
对受密码保护的数据库运行 scrutinize 可能需要您提供用户名和密码：
$ scrutinize -U username -P 'password'