22.4.2. ovirt-log-collector 命令的语法
日志收集器命令的基本语法为:
# ovirt-log-collector options list all|clusters|datacenters # ovirt-log-collector options collect
两种支持的操作模式是 列出
并收集
。
-
list
参数列出了附加到 Red Hat Virtualization Manager 的主机、集群或数据中心。您可以基于列出的对象过滤日志集合。 -
collect
参数从 Red Hat Virtualization Manager 执行日志集合。收集的日志放置在 /tmp/logcollector 目录下的存档文件中。ovirt-log-collector
命令为每个日志分配一个特定文件名。
除非指定了另一个参数,否则默认操作是将可用的主机与它们所属的数据中心和集群一起列出。系统会提示您输入用户名和密码来检索某些日志。
有大量参数可以进一步优化 ovirt-log-collector
命令。
常规选项
--version
- 显示使用的命令的版本号,并返回提示符。
-h
,--help
- 显示命令用法信息,并返回到提示符。
--conf-file=PATH
- 将 PATH 设置为工具要使用的配置文件。
--local-tmp=PATH
- 将 PATH 设置为保存日志的目录。默认目录为 /tmp/logcollector。
--ticket-number=TICKET
- 将 TICKET 设置为 ticket 或问题单号,以与 SOS 报告关联。
--upload=FTP_SERVER
设置 FTP_SERVER 作为检索日志的目的地,以使用 FTP 发送。
除非被红帽支持代表建议,否则不要使用这个选项。
--log-file=PATH
- 将 PATH 设置为命令用于日志输出的特定文件名。
--quiet
- 设置静默模式,将控制台输出减小到最低限度。静默模式默认为关闭。
-v
,--verbose
- 设置详细模式,提供更多的控制台输出。详细模式默认为关闭。
--time-only
- 仅显示主机间时间差异的信息,而不生成完整的 SOS 报告。
Red Hat Virtualization Manager 选项
这些选项过滤日志集合,并指定 Red Hat Virtualization Manager 的身份验证详情。
这些参数可以合并用于特定命令。例如,ovirt-log-collector --user=admin@internal --cluster ClusterA,ClusterB --hosts "SalesHost"*
将用户指定为 admin@internal
,并将日志集合限制为仅限在 A
和 B
中的 SalesHost
主机。
--no-hypervisors
- 从日志集合中省略虚拟化主机。
--one-hypervisor-per-cluster
- 从每个集群中收集一个主机的日志(如果有 SPM)。
-u USER
,--user=USER
- 设置登录的用户名。USER 的格式为 user@domain,其中 user 是用户名,domain 是使用的目录服务域。用户必须存在于目录服务中,且对 Red Hat Virtualization Manager 所知。
-r FQDN
,--rhevm=FQDN
-
设置从中收集日志的 Red Hat Virtualization Manager 的完全限定域名,其中 FQDN 替换为 Manager 的完全限定域名。假设日志收集器正在与 Red Hat Virtualization Manager 相同的本地主机上运行,默认值为
localhost
。 -c CLUSTER
,--cluster=CLUSTER
- 除了来自 Red Hat Virtualization Manager 的日志外,还从 nominated CLUSTER 中的虚拟化主机收集日志。包含的集群必须使用逗号分隔的集群名称列表或匹配模式指定。
-d DATACENTER
,--data-center=DATACENTER
- 除了 Red Hat Virtualization Manager 日志外,还需要从 nominated DATACENTER 中的虚拟化主机收集日志。包含的数据中心必须使用逗号分隔的数据中心名称或匹配模式指定。
-H HOSTS_LIST
,--hosts=HOSTS_LIST
- 除了 Red Hat Virtualization Manager 日志外,还需要从 nominated HOSTS_LIST 中的虚拟化主机收集日志。包含的主机必须在主机名、完全限定域名或 IP 地址的逗号分隔列表中指定。匹配模式也有效。
SSH 配置
--ssh-port=PORT
- 将 PORT 设置为用于与虚拟化主机 SSH 连接的端口。
-k KEYFILE
,--key-file=KEYFILE
- 将 KEYFILE 设置为用于访问虚拟化主机的公共 SSH 密钥。
--max-connections=MAX_CONNECTIONS
-
设置 MAX_CONNECTIONS 作为虚拟化主机日志的最大并发 SSH 连接。默认值为
10
。
PostgreSQL 数据库选项
必须指定数据库用户名和数据库名称,如果使用 pg-user
和 dbname
参数(如果从默认值更改了)
如果数据库不在本地主机上,则使用 pg-dbhost
参数。使用可选的 pg-host-key
参数来收集远程日志。必须在数据库服务器上安装 PostgreSQL SOS 插件,才能远程日志收集才能成功。
--no-postgresql
-
禁用数据库集合。日志收集器将连接到 Red Hat Virtualization Manager PostgreSQL 数据库,并在日志中包括数据,除非指定了
--no-postgresql
参数。 --pg-user=USER
- 将 USER 设置为用于与数据库服务器的连接的用户名。默认值为 postgres。
--pg-dbname=DBNAME
- 将 DBNAME 设置为用于连接数据库服务器的数据库名称。默认值为 rhevm。
--pg-dbhost=DBHOST
- 将 DBHOST 设置为数据库服务器的主机名。默认值为 localhost。
--pg-host-key=KEYFILE
- 将 KEYFILE 设置为数据库服务器的公共身份文件(私钥)。默认情况下不设置这个值;只需要本地主机上不存在数据库的位置。