附录 A. insights-client的命令选项


作为具有 root 特权的系统管理员,您可以使用 insights-client 命令及其选项来控制系统上的 Insights 客户端操作。因为 insights-client.rpm 的更新频率比 Insights for Red Hat Enterprise Linux 中的独立组件更新,所以手册页可能不包括 insights-client 的最新信息。

每次输入 insights-client 命令时,客户端都会收集数据并将其发送到 Insights for Red Hat Enterprise Linux。

注意

使用 insights-client --display-name 命令设置显示名称可立即生效,但不运行 Insights 客户端。

A.1. Insights 客户端的选项

表 A.1. insights-client user 命令选项
选项描述

--help

-h

显示帮助信息

--register

使用 /etc/hostname 中的信息,将主机注册到 Insights for Red Hat Enterprise Linux。将自动启用每日 cron 任务,除非设置了 --disable-schedule

--unregister

从 Insights for Red Hat Enterprise Linux 中取消注册主机。

--display-name=DISPLAY_NAME

在 GUI 中设置或更改主机显示名称。如果要使用与 /etc/hostname 中指定的名称不同的名称,使用 with- register 设置 display_name 的值。您也可以在注册后使用 --display-name 选项来覆盖 Insights 清单中为这个主机显示的名称。

--group=GROUP

在注册期间将主机添加到 GROUP。组名称在 /etc/insights-client/tags.yaml 中定义。

--retry=RETRIES

设置重试上传的次数。默认值为 1。重试间隔为 180 秒,这是 Insights 客户端在重试上传前等待的时间。

注意:在调度程序中,重试次数为 3。

--validate

验证 /etc/insights-client/remove.conf/etc/insights-client/tags.yaml 文件。

--quiet

仅将错误消息记录到控制台。

--silent

不记录控制台。

--enable-schedule

启用作业调度。默认情况下,Insights 客户端每天、或接近午夜运行。

注意:如果您使用 Client 1.x,请使用 --register 选项启用调度。

--disable-schedule

禁用每日作业调度。

--conf=CONF

-c=CONF

使用自定义配置文件 CONF,而不是默认的 /etc/insights-client/insights-client.conf 文件。

--no-upload

运行客户端,但不将存档上传到 Red Hat Insights。归档存储在 /var/tmp/ 目录中。当 insights-client 命令完成后,会显示文件名。

--offline

在不使用网络功能的情况下运行客户端。表示 --no-upload

--logging-file=LOGFILE

将日志数据输出到指定的日志文件(LOGFILE)。默认日志文件为 /var/log/insights-client/insights-client.log

--diagnosis

从 API 获取诊断信息。您需要确保系统已经注册并至少上传一次,然后才能使用 -诊断。

--compliance

使用 OpenSCAP 扫描系统并上传报告。

--compliance-policies

列出系统可分配给的所有策略,并在输出表中提供以下类别的有用信息:

  • assigned 将策略的状态列为 False (系统没有分配策略)或 True (系统已分配策略)
  • id : 列出策略的唯一 ID (UUID)。
  • title : 列出您可以添加系统的安全内容自动化协议(SCAP)策略的名称。

--compliance-assign

使用 insights-client --compliance-policies 输出的 ID 将系统分配给策略。

--compliance-unassign

使用 insights-client --compliance-policies 输出的 ID 从策略取消分配系统。

--payload=PAYLOAD

将特定的归档有效负载文件上传到 Red Hat Enterprise Linux 的 Red Hat Insights。设置 requires-content-type

--content-type=TYPE

设置 PAYLOAD 的内容类型。type 可以是 gzbz2xznoneTYPE 的值必须与与有效负载文件一起使用的- compressor 匹配。

--show-results

显示 --check-results 获取的分析结果。

--output-dir=DIR

将集合写入指定的目录,而不是上传。

--output-file=FILE

将集合写入指定的存档,而不是上传。

--ansible-host=ANSIBLE_HOST

在 Red Hat Insights 清单中设置或更改 Ansible 主机名。当您要设置与 /etc/hostname 或配置文件中指定的名称不同的名称时,在注册过程中使用这个选项。您还可以使用这个选项覆盖注入以 Red Hat Insights 修复生成的此主机作为 playbook 的主机名。

--list-specs

显示 insights-client 集合规格。

--build-packagecache

刷新系统软件包管理器缓存。

--manifest=MANIFEST

定义 Insights Core 应该收集的指定清单 YAML 文件。

--checkin

执行轻量级检查,而不是完整上传。

--collector=APP

运行指定的应用程序并上传其结果存档。

例如,指定:

  • --collector malware-detection 使用 Red Hat Insights 来帮助检测恶意软件是否存在。如需更多信息,请参阅附加资源部分
  • --collector 合规性,指示 Red Hat Insights 使用 OpenSCAP 扫描系统并上传报告。也可以使用'-compliance' 选项来实现这个操作。

另外,在需要调试 Insights 客户端操作时,使用以下 insights-client 命令选项:

表 A.2. insights-client 调试选项
选项描述

--version

输出 insights-client 客户端和 Core 的版本。

--test-connection

测试到 Red Hat Insights for Red Hat Enterprise Linux 服务的连接。

--verbose

将所有调试输出记录到控制台。

--no-upload

运行客户端,但不会上传存档。归档存储在 /var/tmp/ 目录中。当 insights-client 完成后会显示文件名。

--keep-archive

上传后,将存档存储在 /var/cache/insights-client/ 目录中。

--support

为支持生成诊断日志。

--status

显示主机注册状态。

--net-debug

记录对控制台的网络调用。

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.