第 5 章 合并和下载报告
运行扫描后,您可以下载该扫描的报告,以查看该扫描期间收集并处理的数据。
如果您选择将 IT 基础架构的扫描任务分成多个离散扫描,您可以将这些扫描的输出合并到单个报告中。合并报告也会在合并时下载。
了解更多
要了解更多有关下载报告的信息,请查看以下信息:
要了解更多有关合并两个或多个报告并下载合并结果的信息,请查看以下信息:
5.1. 下载报告 复制链接链接已复制到粘贴板!
运行扫描后,您可以下载该扫描的报告,以查看该扫描期间收集并处理的数据。
扫描的报告有两种格式:以逗号分隔的变量(CSV)格式和 JavaScript 对象表示法(JSON)格式。它们也可以在两种内容类型中找到,即扫描的原始输出作为详细报告,并作为部署报告处理内容。
提供了第三个报告,即 Insights 报告,但此报告只能通过发现命令行界面生成。下载 insights 报告提供了 .tar.gz 文件,您可以在 cloud.redhat.com 传送到混合云控制台。传输此文件允许在 Red Hat Insights 清单服务和订阅服务中使用报告数据。
了解更多
要了解更多有关合并和下载报告的信息,请查看以下信息:
要了解更多有关如何创建报告的信息,请查看以下信息。此信息包括报告生成进程的时序。这些进程将详情报告的原始事实改为指纹数据,然后将指纹数据改为部署报告的重复数据删除和合并的数据。此信息还包括部分指纹示例,用于显示用于创建发现报告的数据类型。
5.1.1. 下载报告 复制链接链接已复制到粘贴板!
在 Scans 视图中,您可以选择一个或多个报告,并下载它们来查看报告数据。
先决条件
如果要下载扫描的报告,该扫描的最新扫描作业必须成功完成。
流程
- 在 Scans 视图中,导航到您要下载报告的扫描行。
- 点 Download 对该扫描。
验证步骤
下载的报告以 .tar.gz 文件形式保存到浏览器的下载位置,例如 report_id_224_20190702_173309.tar.gz。文件名格式为 report_id_ID_DATE_TIME.tar.gz,其中 ID 是服务器分配的唯一报告 ID,DATE 是 yyyymmdd 格式的日期,TIME 是 hhmmss 格式的时间,它基于 24 小时系统。日期和时间数据由运行客户端与服务器 API 的浏览器的交互决定。
要查看报告,请将 .tar.gz 文件解压缩到 report_id_ID 目录中。未压缩的报告捆绑包包含四个报告文件:CSV 和 JSON 格式的两个详细信息报告,以及 CSV 和 JSON 格式的两个部署报告。
虽然您可以将这些报告的输出用于您自己的内部进程,但发现文档不提供任何信息来帮助您解释报告结果。此外,虽然红帽支持可以提供一些与安装和使用发现相关的基本帮助,但支持团队不提供帮助您了解报告的任何帮助。报告及其格式设计为由红帽订阅人员和感知计划(SEAP)团队在客户和其他红帽内部流程期间使用,如向各种混合云控制台服务提供数据。
5.1.2. 如何创建报告 复制链接链接已复制到粘贴板!
扫描过程用于发现您的 IT 基础架构中的系统,来检查和收集有关这些系统的性质和内容的信息,并从检查每个系统期间收集的信息创建报告。
系统 是通过 SSH 连接、vCenter 服务器数据、Satellite 服务器 API 或 Red Hat OpenShift 集群 API 检查任务的任何实体。因此,系统可以是机器,如物理或虚拟,也可以是不同类型的实体,如容器或集群。
5.1.2.1. 事实和指纹 复制链接链接已复制到粘贴板!
在扫描过程中,会为包含在每个源中的每个系统收集一组事实。事实是 有关系统的单个数据,如操作系统的版本、CPU 内核数或红帽产品使用的权利。
处理事实以为每个系统创建一组汇总的数据,称为指纹的数据。指纹 是一组事实,用于识别唯一系统及其特征,包括架构、操作系统、在该系统上安装的不同产品以及该系统上使用的权利等。
在运行扫描作业时会生成 Fingerprinting 数据,但数据仅用于创建一种类型的报告。当您请求详情报告时,您会收到该扫描的原始事实,而无需任何指纹。当您请求部署报告时,您会收到包括重复数据删除、合并和后处理过程中结果的指纹数据。这些步骤包括从原始事实识别已安装的产品和版本,查找使用的权利、从不同来源查找和合并重复产品实例,以及查找在非默认位置安装的产品,以及其他步骤。
5.1.2.2. 系统重复数据删除和合并 复制链接链接已复制到粘贴板!
在扫描过程中在多个源中找到单个系统。例如,vCenter 服务器上的虚拟机可以运行由 Satellite 管理的 Red Hat Enterprise Linux 操作系统安装。如果您构建包含每种源、vcenter、satellite 和网络的扫描,则扫描过程中所有三种源都会报告该单个系统。
目前,您无法将 OpenShift 源与扫描中的任何其他源合并,因此重复数据删除和合并进程不适用于 OpenShift 扫描。
要解决这个问题并构建准确的指纹,请将扫描中未处理的系统事实发现到指纹引擎。指纹引擎使用重复数据删除和合并过程,匹配并合并在多个源中找到的系统的数据。
5.1.2.2.1. 系统重复数据删除 复制链接链接已复制到粘贴板!
系统重复数据删除过程使用系统的具体事实来识别重复的系统。此过程分为几个阶段,使用这些事实将重复的系统合并在连续更广泛的数据集中:
-
来自网络源的所有系统都合并到单一网络系统集中。如果系统对
subscription_manager_id或bios_uuid事实的值相同,则系统被视为是重复的。 -
来自 vcenter 源的所有系统都合并到单个 vcenter 系统集中。如果系统对
vm_uuid事实的值相同,则被视为是重复的。 -
来自 satellite 源的所有系统都合并到一个 satellite 系统集中。如果系统对
subscription_manager_id事实的值相同,则被视为是重复的。 -
网络系统集与 satellite 系统集合并,以形成单一网络 Satellite 系统集。如果系统对
subscription_manager事实的值相同,或者与mac_addresses事实中的 MAC 地址值相同,则系统被视为是重复的。 -
network-satellite 系统集与 vcenter 系统集合并,以形成完整的系统集。如果系统在
mac_addresses事实中具有匹配的 MAC 地址值,或者vm_uuid事实的 vcenter 值与bios_uuid事实的网络值匹配,则被视为是重复的。
5.1.2.2.2. 系统合并 复制链接链接已复制到粘贴板!
在去除重复数据过程后,下一步是执行这两个系统的组合。合并的系统有来自每个源的系统事实。当合并在两个系统中出现的事实时,合并过程会按照以下优先级顺序来合并该事实,从最高到最低:
- 网络源事实
- Satellite 源事实
- vCenter 源事实
系统指纹包含一个 元数据 字典,用于捕获该系统每个事实的原始来源。
5.1.2.3. 系统后处理 复制链接链接已复制到粘贴板!
重复数据删除和合并完成后,有一个处理后阶段来创建派生的系统事实。派生的系统事实 是从评估多个系统事实而生成的事实。大多数派生的系统事实与产品识别数据相关,如存在特定产品及其版本。
以下示例演示了如何创建派生的系统事实 system_creation_date。
system_creation_date 事实是一个派生的系统事实,其中包含实际系统创建时间。此事实的值由评估以下事实决定。每个事实的值会按照以下优先级顺序进行检查,其优先级顺序由与实际系统创建时间匹配的准确性决定。最高非空值用于决定 system_creation_date 事实的值。
-
date_machine_id -
registration_time -
date_anaconda_log -
date_filesystem_create -
date_yum_history
5.1.2.4. 报告创建 复制链接链接已复制到粘贴板!
完成报告数据的处理后,报告创建过程以两种不同的格式构建两个报告:JavaScript Object Notation (JSON)和以逗号分隔的变量(CSV)。每个格式 的详情 报告都包含没有处理的原始事实,每个格式的 部署 报告包含在原始事实通过指纹、重复数据删除、合并和后处理进程后的输出。
报告格式设计为由红帽订阅参与和感知计划(SEAP)团队在客户和其他红帽内部流程期间使用。
虽然您可以将这些报告的输出用于您自己的内部进程,但发现文档不提供任何信息来帮助您解释报告结果。此外,虽然红帽支持可以提供一些与安装和使用发现相关的基本帮助,但支持团队不提供帮助您了解报告的任何帮助。报告及其格式设计为由红帽订阅人员和感知计划(SEAP)团队在客户和其他红帽内部流程期间使用,如向各种混合云控制台服务提供数据。
5.1.2.5. 指纹示例 复制链接链接已复制到粘贴板!
除了该系统上产品、权利、源和元数据的事实外,还包含有关单个系统的一组指纹。以下示例显示了指纹数据。单个系统的指纹(即使在其上安装了非常少的红帽产品)可能有很多。因此,本例中只使用部分指纹。
示例
指纹的前几行显示有关系统的事实,包括操作系统和 CPU 的事实。在本例中,OS _release 事实描述了安装的操作系统,并将发布为 Red Hat Enterprise Linux Atomic Host 7.4。
接下来,指纹会在 products 部分列出已安装的产品。产品具有名称、版本、存在和元数据字段。在 JBoss EAP 部分中,presence 字段显示 absent 作为值,因此本例中的系统没有安装 Red Hat JBoss Enterprise Application Platform。
指纹还在授权部分列出该系统的消耗 权利。列表中的每个权利都有一个名称、ID 和元数据,用于描述该事实的原始源。在示例指纹中,系统具有 Satellite Tools 6.3 权利。
除了 产品和 权利 部分的元数据字段外,指纹还包含用于系统事实 元数据 的元数据部分。对于每个系统事实,指纹的 metadata 部分都有一个对应的条目,用于标识该系统事实的原始源。在示例中,在 Satellite 源扫描过程中,在 Satellite 服务器中找到 os_release 事实。
最后,指纹会在 sources 部分列出包含此系统的 源。系统可以包含多个源。例如,对于包含网络源和 satellite 源的扫描,可在扫描的两个部分找到单个系统。