数据收集范围

scrutinize 选项可让您控制数据收集的范围。您可以根据以下条件指定数据收集的范围:

您可以单独或组合使用这些选项,以实现所需的粒度级别。

收集的数据量

通过以下几个选项,可以限制 scrutinize 收集的数据量:

‑‑by‑second
每秒收集数据。这是从数据收集器表中收集时的最高粒度级别。
‑‑by‑minute=boolean‑value
每分钟(如果值为 true)或每小时(如果值为 false)收集数据。
‑‑get‑files file‑list
收集指定的附加文件(包括 Glob),其中 file‑list 是文件的分号分隔列表。
‑‑include_gzlogs=num‑files
‑z num‑files
scrutinize 输出中包括 num‑files 个轮换日志文件 (vertica.log*.gz),其中 num‑files 可以是以下值之一:
  • 整数指定要收集的循环日志文件的数量。

  • all 指定收集所有轮换日志文件。

默认情况下,scrutinize 会包含三个滚动日志文件。

‑‑log-limit=limit
‑l limit
从最近的日志条目开始,从 Vertica 日志中收集的数据量(以 GB 为单位)。默认情况下,scrutinize 收集 1 GB 的日志数据。

特定于节点的收集

默认情况下,scrutinize 收集所有群集节点中的数据。您可以指定 scrutinize 通过以下两种方法在各个节点中收集:

‑‑local_diags ‑s
仅从调用了 scrutinize 的主机中收集诊断数据。要从群集中的多个节点收集数据,请使用 ‑‑hosts 选项。
‑‑hosts=host‑list ‑n host‑list
仅从在 host-list 中指定的主机中收集诊断数据,host-list 是 IP 地址或主机名的逗号分隔列表。

例如:

$ scrutinize --hosts=127.0.0.1,host_3,host_1

要包括的数据的类型

scrutinize 提供了几个选项,可用于指定要收集的数据的类型:

‑‑debug
收集日志的调试信息。
‑‑diag‑dump
将收集的内容限制为数据库设计、系统表和数据收集器表。使用此选项可收集用于分析系统性能的数据。
‑‑diagnostics
将收集的内容限制为对 Vertica 及其主机系统运行的命令所产生的日志文件数据和输出。使用此选项可收集用于评估 Vertica 系统中意外行为的数据。
‑‑include‑ros‑info
包括来自系统表的 ROS 相关信息。
‑‑no‑active‑queries ‑‑with‑active‑queries
从系统表和数据收集器表中排除有关当前正在运行的查询的诊断信息。默认情况下,scrutinize 收集此信息 (‑‑with‑active‑queries)。
‑‑tasks=tasks -T tasks
收集文件或 JSON 列表中指定的一个或多个任务的诊断数据。此选项通常与 ‑‑exclude 一起使用。
‑‑type=type -t type
要执行的诊断数据收集的类型,包括以下选项之一:
  • profiling:收集分析数据。

  • context:收集摘要信息。

‑‑with‑active‑queries
默认设置,包括从系统表和数据收集器表中收集有关当前正在运行的查询的诊断信息。要省略此数据,请使用 ‑‑no‑active‑queries

要排除的数据的类型

scrutinize 选项还允许您指定要从其收集中排除的数据的类型:

‑‑exclude=tasks ‑X tasks
从诊断数据收集中排除一个或多个类型的任务,其中 tasks 是要排除的任务的逗号分隔列表。
  • all:所有默认任务

  • DC:数据收集器表

  • File:来自安装过程、数据库和管理工具的日志文件,例如 vertica.logdbLogadminTools.log

  • VerticaLog:Vertica 日志

  • CatalogObject:Vertica 编录元数据,例如系统配置参数

  • SystemTable:包含有关系统、资源、工作负载和性能的信息的 Vertica 系统表

  • Query:使用 vsql 连接到数据库的 Vertica 元函数,例如 EXPORT_CATALOG()

  • Command:操作系统信息,例如节点已启动的时间长度

‑‑no‑active‑queries
省略系统表和数据收集器表中有关当前正在运行的查询的诊断信息。默认情况下,scrutinize 始终会收集活动查询信息 (‑‑with‑active‑queries)。
‑‑vsql-off ‑v
排除用于连接到数据库的 QuerySystemTable 任务。此选项可帮助您处理升级期间遇到的问题,并且通常在以下情况下使用:
  • Vertica 正在运行,但响应缓慢。

  • 您尚未创建数据库,但需要帮助解决其他群集问题。