Red Hat Training
A Red Hat training course is available for Red Hat Virtualization
数据仓库指南
Red Hat Virtualization 4.1
如何使用 Red Hat Virtualization 的数据仓库功能
摘要
本书包含与 Red Hat Virtualization 数据仓库相关的信息和流程。
第 1 章 安装和配置数据仓库
1.1. 配置数据仓库概述
Red Hat Virtualization Manager 包括一个全面的管理历史数据库，可供任何应用程序用来在数据中心、集群和主机级别提取一系列信息。安装数据仓库将创建
ovirt_engine_history 数据库，管理器配置为记录用于报告的信息。
Red Hat Virtualization 需要数据仓库。它可以在与 Manager 相同的机器上安装和配置，也可以在可访问 Manager 的单独机器上安装和配置：
在 Manager 计算机上安装和配置数据仓库。
此配置只需要一台注册的计算机，而且是最简单的配置；但是，它会增加主机计算机上的需求。需要访问数据仓库服务的用户需要访问 Manager 机器本身。有关此配置的更多信息 ，请参阅安装指南中的配置 Red Hat Virtualization Manager。
安装和配置数据仓库独立计算机。
此配置需要两个注册的计算机。它减少了管理器机器上的负载，并避免在该机器上潜在的 CPU 和内存共享冲突。管理员还可以允许用户访问数据仓库计算机，而无需授予 Manager 计算机的访问权限。有关此配置的更多信息，请参阅 第 1.2 节 “在一个单独的计算机上安装和配置数据仓库”。
建议您将数据仓库部署中的所有机器的系统时区设置为 UTC。这样可确保数据收集不会因为您的本地时区的不同而中断：例如，从夏天的时间冬天时间的变化。
要计算
ovirt_engine_history 数据库将使用的空间和资源估算，请使用 RHV Manager History Database Size Calculator 工具。估计结果基于实体数量和您选择保留历史记录记录的时间长度。
重要
engine-setup 中预期的行为如下：
- 安装数据仓库软件包、运行 engine-setup，并回答
No以配置数据仓库：Configure Data Warehouse on this host (Yes, No) [Yes]: No
- 再次运行 engine-setup ；设置不再显示配置数据仓库的选项。
要强制 engine-setup 重新显示选项，请运行 engine-setup --reconfigure-optional-components。
要配置当前安装的数据仓库软件包，并阻止设置应用启用的存储库中找到的软件包更新，请添加
--offline 选项。
1.2. 在一个单独的计算机上安装和配置数据仓库
在安装了 Red Hat Virtualization Manager 的单独机器上安装和配置数据仓库。在单独的计算机上托管数据仓库服务有助于减少管理器计算机上的负载。
前提条件
- 您必须在单独的机器上安装并配置了 Manager。
- 要设置数据仓库机器，您必须有以下内容：
- 安装了 Red Hat Enterprise Linux 7 的虚拟机或物理机器。
- 订阅
Red Hat Enterprise Linux 服务器和Red Hat Virtualization订阅池。 - Manager 的
/etc/ovirt-engine/engine.conf.d/10-setup-database.conf文件中的密码。 - 允许从数据仓库计算机访问 Manager 数据库计算机的 TCP 端口 5432。
- 如果您选择使用远程数据仓库数据库，则必须在安装数据仓库服务前设置数据库。远程数据仓库数据库提供比本地数据库更好的性能。您必须包含有关数据库主机的以下信息：
- 主机的完全限定域名
- 可以访问数据库的端口（默认为5432）
- 数据库名称
- 数据库用户
- 数据库密码
- 您必须通过编辑
postgres.conf文件来手动授予访问权限。编辑/var/lib/pgsql/data/postgresql.conf文件并修改listen_addresses行，使其与以下内容匹配：listen_addresses = '*'
如果该行不存在或已被注释掉，请手动添加。如果数据库托管在 Manager 机器上，且是在 Red Hat Virtualization Manager 完全设置过程中配置的，则默认授予访问权限。
注意
如果要手动安装远程数据仓库数据库，请参阅安装指南中的 准备远程 PostgreSQL 数据库 。
过程 1.1. 在一个单独的计算机上安装和配置数据仓库
- 将您的系统订阅到所需的权利。如需更多信息，请参阅安装指南中的订阅所需权利。
- 确保当前安装的所有软件包都为最新版本：
# yum update
- 安装 ovirt-engine-dwh-setup 软件包：
# yum install ovirt-engine-dwh-setup
- 运行 engine-setup 命令并按照提示在机器上配置数据仓库：
# engine-setup Configure Data Warehouse on this host (Yes, No) [Yes]:
- 按 Enter 接受自动探测的主机名，或者输入备用主机名并按 Enter ：
Host fully qualified DNS name of this server [autodetected hostname]:
- 按 Enter 键自动配置防火墙，或者键入
No并按 Enter 来维护现有设置：Setup can automatically configure the firewall on this system. Note: automatic configuration of the firewall may overwrite current settings. Do you want Setup to configure the firewall? (Yes, No) [Yes]:
如果您选择自动配置防火墙，且没有防火墙管理器处于活动状态，系统会提示您从支持的选项列表中选择您所选的防火墙管理器。输入防火墙管理器的名称，然后按 Enter。即使只列出了一个选项，也是如此。 - 输入 Manager 机器的完全限定域名，然后按 Enter ：
Host fully qualified DNS name of the engine server []:
- 按 Enter 键允许设置通过 SSH 在 Manager 上签署证书：
Setup will need to do some actions on the remote engine server. Either automatically, using ssh as root to access it, or you will be prompted to manually perform each such action. Please choose one of the following: 1 - Access remote engine server using ssh as root 2 - Perform each action manually, use files to copy content around (1, 2) [1]:
- 按 Enter 接受默认 SSH 端口，或者输入替代端口号，然后按 Enter 键：
ssh port on remote engine server [22]:
- 输入 Manager 机器的 root 密码：
root password on remote engine server manager.example.com:
- 回答以下有关数据仓库数据库的问题：
Where is the DWH database located? (Local, Remote) [Local]: Setup can configure the local postgresql server automatically for the DWH to run. This may conflict with existing applications. Would you like Setup to automatically configure postgresql and create DWH database, or prefer to perform that manually? (Automatic, Manual) [Automatic]:
按 Enter 键选择突出显示的默认值，或者键入您的备选首选项，然后按 Enter 键。如果您选择Remote，系统会提示您提供有关远程数据库主机的详细信息。为预配置的远程数据库主机输入以下值：DWH database host []: dwh-db-fqdn DWH database port [5432]: DWH database secured connection (Yes, No) [No]: DWH database name [ovirt_engine_history]: DWH database user [ovirt_engine_history]: DWH database password: password
有关如何配置和迁移数据仓库数据库的更多信息，请参阅 第 1.3.1 节 “将数据仓库数据库迁移到独立机器”。 - 为 Manager 数据库机器输入完全限定域名和密码。按 Enter 接受其他字段中的默认值：
Engine database host []: engine-db-fqdn Engine database port [5432]: Engine database secured connection (Yes, No) [No]: Engine database name [engine]: Engine database user [engine]: Engine database password: password
- 选择数据仓库将保留所收集数据的时长：
Please choose Data Warehouse sampling scale: (1) Basic (2) Full (1, 2)[1]:
Full使用 第 2.4 节 “ovirt-engine-dwhd.conf 中的数据仓库服务的应用程序设置” 中列出的数据存储设置的默认值（当远程主机上安装数据仓库时，推荐使用它）。Basic会将DWH_TABLES_KEEP_HOURLY的值减小到720，DWH_TABLES_KEEP_DAILY的值降低为0，这可简化 Manager 机器上的负载（在同一机器上安装 Manager 和数据仓库时推荐的）。 - 确认安装设置：
Please confirm installation settings (OK, Cancel) [OK]:
- 在 Red Hat Virtualization Manager 中重启
ovirt-engine服务：# systemctl restart ovirt-engine.service
- （可选）使用中的说明将 SSL 设置为安全数据库连接 http://www.postgresql.org/docs/9.2/static/ssl-tcp.html#SSL-FILE-USAGE。
1.3. 将数据仓库迁移到独立机器
将数据仓库服务从 Red Hat Virtualization Manager 迁移到单独的机器。在单独的计算机上托管数据仓库服务可减少每台计算机的负载，并允许每个服务避免与其他进程共享 CPU 和内存导致的潜在冲突。
迁移数据仓库服务，并使用现有的
ovirt_engine_history 数据库连接它，或者选择性地将 ovirt_engine_history 数据库迁移到新的数据库计算机，然后再迁移数据仓库服务。如果 ovirt_engine_history 数据库托管在 Manager 上，在 Data Warehouse 服务之外迁移数据库也会进一步降低 Manager 计算机上资源的竞争。您可以将数据库迁移到将数据仓库服务迁移到与 Manager 机器和新数据仓库服务机器独立的机器上。
1.3.1. 将数据仓库数据库迁移到独立机器
（可选）在迁移数据仓库服务前迁移
ovirt_engine_history 数据库。使用 engine-backup 创建数据库备份，并在新数据库计算机上恢复它。有关 engine-backup 的更多信息，请运行 engine-backup --help。
将您的系统订阅到所需的权利。请参阅安装指南中的订阅所需 权利。
要只迁移数据仓库服务，请参阅 第 1.3.2 节 “将数据仓库服务迁移到独立机器”。
过程 1.2. 将数据仓库数据库迁移到独立机器
- 创建数据仓库数据库和配置文件的备份：
# engine-backup --mode=backup --scope=dwhdb --scope=files --file=file_name --log=log_file_name
- 将备份文件从 Manager 复制到新机器：
# scp /tmp/file_name root@new.dwh.server.com:/tmp
- 在新机器上安装 engine-backup ：
# yum install ovirt-engine-tools-backup
- 在新计算机上恢复数据仓库数据库。FILE_ NAME 是从 Manager 复制的备份文件。
# engine-backup --mode=restore --scope=files --scope=dwhdb --file=file_name --log=log_file_name --provision-dwh-db --no-restore-permissions
数据仓库数据库现在托管在与管理器托管的独立计算机上。继续 第 1.3.2 节 “将数据仓库服务迁移到独立机器” 以完成迁移。
1.3.2. 将数据仓库服务迁移到独立机器
将 Red Hat Virtualization Manager 上安装和配置的数据仓库服务迁移到专用主机机器中。在单独的计算机上托管数据仓库服务有助于减少管理器计算机上的负载。请注意，这个过程只迁移数据仓库服务；在迁移数据仓库服务前，要迁移数据仓库数据库（也称为
ovirt_engine_history 数据库），请参阅 第 1.3.1 节 “将数据仓库数据库迁移到独立机器”。
前提条件
确保您已完成以下先决条件：
- 您必须在同一台机器上安装并配置了管理器和数据仓库。
- 要设置新的数据仓库机器，您必须有以下内容：
- 安装了 Red Hat Enterprise Linux 7 的虚拟机或物理机器。
- 订阅
Red Hat Enterprise Linux 服务器和Red Hat Virtualization授权池。 - Manager 的
/etc/ovirt-engine/engine.conf.d/10-setup-database.conf文件中的密码。 - 允许从数据仓库计算机访问 Manager 数据库计算机的 TCP 端口 5432。
ovirt_engine_history数据库凭据来自 Manager 的/etc/ovirt-engine-dwh/ovirt-engine-dwhd.conf.d/10-setup-database.conf文件。如果您使用 第 1.3.1 节 “将数据仓库数据库迁移到独立机器” 迁移了ovirt_engine_history数据库，请检索您在该机器上的数据库设置中定义的凭据。
安装此场景需要四个步骤：
- 设置新的数据仓库：流程 1.3。设置新的数据仓库机器
- 在 Manager 机器上停止数据仓库服务：流程 1.4。在 Manager 机器上停止数据仓库服务
- 配置新的数据仓库：流程 1.5。配置新的数据仓库（Data Warehouse 机器）
- 在 Manager 计算机上禁用数据仓库服务：流程 1.6.在 Manager 机器上禁用数据仓库服务
过程 1.3. 设置新的数据仓库机器
- 将您的系统订阅到所需的权利。如需更多信息，请参阅安装指南中的订阅所需权利。
- 确保当前安装的所有软件包都为最新版本：
# yum update
- 安装 ovirt-engine-dwh-setup 软件包：
# yum install ovirt-engine-dwh-setup
过程 1.4. 在 Manager 机器上停止数据仓库服务
- 停止数据仓库服务：
# systemctl stop ovirt-engine-dwhd.service
- 如果数据库托管在远程计算机上，您必须通过编辑 postgres.conf 文件来手动授予访问权限。编辑
/var/lib/pgsql/data/postgresql.conf文件并修改 listen_addresses 行，使其与以下内容匹配：listen_addresses = '*'
如果该行不存在或已被注释掉，请手动添加。如果数据库托管在 Manager 机器上，且是在 Red Hat Virtualization Manager 完全设置过程中配置的，则默认授予访问权限。有关如何配置和迁移数据仓库数据库的更多信息，请参阅 第 1.3.1 节 “将数据仓库数据库迁移到独立机器”。 - 重启 postgresql 服务：
# systemctl restart postgresql.service
过程 1.5. 配置新的数据仓库（Data Warehouse 机器）
只有在您将
ovirt_engine_history 数据库迁移到一台机器和数据仓库服务到其他计算机时，才会显示此步骤中显示的问题。问题的顺序可能因您的环境而异。
- 如果您要同时将
ovirt_engine_history数据库和数据仓库服务迁移到 同一 计算机，请运行以下命令，否则继续下一步。# sed -i '/^ENGINE_DB_/d' \ /etc/ovirt-engine-dwh/ovirt-engine-dwhd.conf.d/10-setup-database.conf # sed -i \ -e 's;^\(OVESETUP_ENGINE_CORE/enable=bool\):True;\1:False;' \ -e '/^OVESETUP_CONFIG\/fqdn/d' \ /etc/ovirt-engine-setup.conf.d/20-setup-ovirt-post.conf - 运行 engine-setup 命令，开始在机器上配置数据仓库：
# engine-setup
- 按 Enter 键配置数据仓库：
Configure Data Warehouse on this host (Yes, No) [Yes]:
- 按 Enter 接受自动检测到的主机名，或者输入备用主机名并按 Enter ：
Host fully qualified DNS name of this server [autodetected host name]:
- 按 Enter 键自动配置防火墙，或者键入
No并按 Enter 来维护现有设置：Setup can automatically configure the firewall on this system. Note: automatic configuration of the firewall may overwrite current settings. Do you want Setup to configure the firewall? (Yes, No) [Yes]:
如果您选择自动配置防火墙，且没有防火墙管理器处于活动状态，系统会提示您从支持的选项列表中选择您所选的防火墙管理器。输入防火墙管理器的名称，然后按 Enter。即使只列出了一个选项，也是如此。 - 为 Manager 输入完全限定域名和密码。按 Enter 接受其他字段中的默认值：
Host fully qualified DNS name of the engine server []: engine-fqdn Setup will need to do some actions on the remote engine server. Either automatically, using ssh as root to access it, or you will be prompted to manually perform each such action. Please choose one of the following: 1 - Access remote engine server using ssh as root 2 - Perform each action manually, use files to copy content around (1, 2) [1]: ssh port on remote engine server [22]: root password on remote engine server engine-fqdn: password
- 回答以下有关
ovirt_engine_history数据库位置的问题：Where is the DWH database located? (Local, Remote) [Local]: Remote
按上文所示输入替代选项，然后按 Enter 键。 - 输入
ovirt_engine_history主机的完全限定域名和密码。按 Enter 接受其他字段中的默认值：DWH database host []: dwh-db-fqdn DWH database port [5432]: DWH database secured connection (Yes, No) [No]: DWH database name [ovirt_engine_history]: DWH database user [ovirt_engine_history]: DWH database password: password
有关如何配置和迁移数据仓库数据库的更多信息，请参阅 第 1.3.1 节 “将数据仓库数据库迁移到独立机器”。 - 为 Manager 数据库机器输入完全限定域名和密码。按 Enter 接受其他字段中的默认值：
Engine database host []: engine-db-fqdn Engine database port [5432]: Engine database secured connection (Yes, No) [No]: Engine database name [engine]: Engine database user [engine]: Engine database password: password
- 选择数据仓库将保留所收集数据的时长：
Please choose Data Warehouse sampling scale: (1) Basic (2) Full (1, 2)[1]:
Full使用 第 2.4 节 “ovirt-engine-dwhd.conf 中的数据仓库服务的应用程序设置” 中列出的数据存储设置的默认值（当远程主机上安装数据仓库时，推荐使用它）。注意如果您从Basic迁移到Full，则最初只提供现有的基本数据。Basic将DWH_TABLES_KEEP_HOURLY的值减少到720，DWH_TABLES_KEEP_DAILY的值降低为 0，但负载较低。 - 确认您要从 Manager 永久断开现有数据仓库服务：
Do you want to permanently disconnect this DWH from the engine? (Yes, No) [Yes]:
- 确认安装设置：
Please confirm installation settings (OK, Cancel) [OK]:
过程 1.6. 在 Manager 机器上禁用数据仓库服务
- 在 Manager 机器中重启 Manager：
# service ovirt-engine restart
控制面板正常工作需要这一步。 - 禁用数据仓库服务：
# systemctl disable ovirt-engine-dwhd.service
- 删除数据仓库文件：
# rm -f /etc/ovirt-engine-dwh/ovirt-engine-dwhd.conf.d/*.conf /var/lib/ovirt-engine-dwh/backups/*
数据仓库服务现在托管在与管理器托管的独立计算机上。
1.4. 更改数据仓库采样规模
Red Hat Virtualization 需要数据仓库。它可以在与 Manager 相同的机器上安装和配置，也可以在可访问 Manager 的单独机器上安装和配置。所有设置都不需要默认数据保留设置，因此 engine-setup 提供两个数据抽样扩展：
抽样扩展会在安装过程中由 engine-setup 配置：
Basic 和 Full。
Full使用默认值用于 第 2.4 节 “ovirt-engine-dwhd.conf 中的数据仓库服务的应用程序设置” 中列出的数据保留设置（当远程主机上安装 Data Warehouse 时推荐的设置）。Basic会将DWH_TABLES_KEEP_HOURLY的值减小到720，DWH_TABLES_KEEP_DAILY的值降低为0，这可简化 Manager 机器上的负载（在同一机器上安装 Manager 和数据仓库时推荐的）。
--== MISC CONFIGURATION ==--
Please choose Data Warehouse sampling scale:
(1) Basic
(2) Full
(1, 2)[1]:
您可以使用 --reconfigure-dwh-scale 选项再次运行 engine-setup，从而更改抽样扩展。
例 1.1. 更改数据仓库采样规模
# engine-setup --reconfigure-dwh-scale [...] Welcome to the RHEV 4.0 setup/upgrade. Please read the RHEV 4.0 install guide https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/4.1/html/Installation_Guide/index.html. Please refer to the RHEV Upgrade Helper application https://access.redhat.com/labs/rhevupgradehelper/ which will guide you in the upgrading process. Would you like to proceed? (Yes, No) [Yes]: [...] Setup can automatically configure the firewall on this system. Note: automatic configuration of the firewall may overwrite current settings. Do you want Setup to configure the firewall? (Yes, No) [Yes]: [...] Setup can backup the existing database. The time and space required for the database backup depend on its size. This process takes time, and in some cases (for instance, when the size is few GBs) may take several hours to complete. If you choose to not back up the database, and Setup later fails for some reason, it will not be able to restore the database and all DWH data will be lost. Would you like to backup the existing database before upgrading it? (Yes, No) [Yes]: [...] Please choose Data Warehouse sampling scale: (1) Basic (2) Full (1, 2)[1]: 2 [...] During execution engine service will be stopped (OK, Cancel) [OK]: [...] Please confirm installation settings (OK, Cancel) [OK]:
您还可以根据需要调整单个数据保留设置，如 第 2.4 节 “ovirt-engine-dwhd.conf 中的数据仓库服务的应用程序设置” 所述。
第 2 章 关于历史记录数据库
2.1. 历史记录数据库概述
Red Hat Virtualization 包括一个全面的管理历史数据库，可用于报告应用程序在数据中心、集群和主机级别生成报告。本章提供了用来设置对历史记录数据库的查询的信息。
Red Hat Virtualization Manager 使用 PostgreSQL 9.2.x 作为数据库平台来存储有关虚拟化环境状态、配置和性能的信息。在安装时，Red Hat Virtualization Manager 会创建一个名为 engine 的 PostgreSQL 数据库。
安装 ovirt-engine-dwh 软件包会创建一个名为 ovirt_engine_history 的第二个数据库，它包含从 引擎 操作数据库每分钟收集的历史配置信息和统计指标。跟踪对数据库的更改将提供有关数据库中对象的信息，让用户能够分析活动、提高性能和解决困难。
警告
ovirt_engine_history 数据库中数据的复制由 Red Hat Virtualization Manager Extract Transform Load Service, ovirt-engine-dwhd 执行。该服务基于 Talend Open Studio，是一种数据集成工具。此服务配置为在数据仓库软件包设置过程中自动启动。这是一个 Java 程序，负责从 engine 数据库提取数据，将数据转换为历史记录数据库标准，并将它加载到 ovirt_engine_history 数据库。
不得停止 ovirt-engine-dwhd 服务。
ovirt_engine_history 数据库架构随着时间而变化。数据库包括一组数据库视图，以提供受支持的版本化的 API，具有一致的结构。视图是包含数据库查询结果集的虚拟表。数据库以 SELECT 语句形式存储视图的定义。SELECT 语句的结果会填充视图返回的虚拟表。用户引用 PL/PGSQL 语句中的视图名称，其格式与引用表的方式相同。
2.2. 跟踪配置历史
Red Hat Virtualization History 数据库（称为
ovirt_engine_history）中的数据可用于跟踪引擎数据库。
ETL 服务
ovirt-engine-dwhd 跟踪三种类型的更改：
- 新实体被添加到引擎数据库中 - ETL Service 将更改复制到 ovirt_ engine _history 数据库作为新条目。
- 现有实体已更新 - ETL Service 会将更改复制到 ovirt_engine_history 数据库作为新条目。
- 实体从引擎数据库中删除 - ovirt_ engine _history 数据库中的新条目 将对应的实体标记为已删除。删除的实体仅标记为已删除。
ovirt_ engine _history 数据库中的配置表与引擎数据库中对应的表有多种方式的不同。最明显的区别是它们包含较少的 配置 列。这是因为，某些配置项目与其它配置项目相比并不重要，因此处于对数据库大小的考虑不会保存这些项。另外，引擎数据库中的几个表列会出现在 ovirt_ engine _history 的单个表中，并具有不同的列名称，使查看数据更方便和理解。所有配置表都包含：
- 用于指示实体配置版本的
history_id； - 用于指示何时在系统中添加实体的
create_date字段； - 用于指示实体何时更改的
update_date字段；以及 delete_date字段表示从系统中删除实体的日期。
2.3. 记录工资历史
ETL 服务每分钟将数据收集数据到统计表中。在过去 24 小时内，数据存储一次都会存储，但至少可以存储为 48 小时，具体取决于上次删除作业的时间。分钟以上的数据超过两小时，将汇总为每小时数据，并且存储两个月。超过 2 天的每小时数据聚合为每日数据，并且存储 5 年。
每小时数据和每日数据可在每小时和每日表中找到。
每个统计 datum 保存在其相应的聚合级别表中：示例、每小时和每日历史记录。所有历史记录表也包含一个 history_id 列，用于唯一标识行。表引用主机的配置版本，以便启用与过去配置相关的实体统计信息的报告。
2.4. ovirt-engine-dwhd.conf 中的数据仓库服务的应用程序设置
下表列出了为数据仓库服务配置应用设置的选项。这些选项位于
/usr/share/ovirt-engine-dwh/services/ovirt-engine-dwhd/ovirt-engine-dwhd.conf 文件中。在 /etc/ovirt-engine-dwh/ovirt-engine-dwhd.conf.d/ 下配置覆盖文件中的默认值。在保存更改后重启数据仓库服务。
表 2.1. ovirt-engine-dwhd.conf 应用程序设置变量
| 变量名称 | 默认值 | 备注 |
|---|---|---|
DWH_DELETE_JOB_HOUR | 3 | 运行删除作业的时间。指定一个 0 到 23 之间的值，其中 0 为午夜。 |
DWH_SAMPLING | 60 | 数据收集到统计表的时间间隔（以秒为单位）。 |
DWH_TABLES_KEEP_SAMPLES | 24 | 存储 DWH_SAMPLING 数据的小时数。超过 2 小时的数据会被汇总到每小时数据。 |
DWH_TABLES_KEEP_HOURLY | 1440 | 每小时数据存储的小时数。默认值为 60 天。超过 2 天的每小时数据将聚合到每日数据。 |
DWH_TABLES_KEEP_DAILY | 43800 | 每日数据存储的小时数。默认值为 5 年。 |
DWH_ERROR_EVENT_INTERVAL | 300000 | 最小间隔，以毫秒为单位，将错误推送到 Manager 的 audit.log 中。 |
2.5. 跟踪标签历史记录
ETL Service 每分钟会收集管理门户中显示的标签信息，并将这些数据存储在标签历史表中。ETL 服务跟踪五种更改：
- 在管理门户中创建了标签 - ETL Service 复制标签详细信息，与标签树中的其他对象定位。
- 实体连接到管理门户中的标签树 - ETL Service 复制添加到 ovirt_engine_history 数据库作为新条目。
- 标签被更新 - ETL Service 将标签详细信息的更改复制到 ovirt_engine_history 数据库作为新条目。
- 从管理门户中移除了实体或标签分支 - ovirt_engine_history 数据库会将对应的标签和关系标记为在新条目中删除。删除了的标签和关系仅标记为删除或分离。
- 标签分支被移动 - 对应的标签和关系会作为新条目进行更新。移动的标签和关系仅标记为更新。
2.6. 允许只读访问 History 数据库
要允许在不允许编辑的情况下访问历史记录数据库，您必须创建一个只读 PostgreSQL 用户，该用户可登录并从
ovirt_engine_history 数据库读取。这个过程必须在安装历史记录数据库的系统中执行。
过程 2.1. 允许只读访问 History 数据库
- 创建用户以对历史记录数据库具有只读访问权限：
# psql -U postgres -c "CREATE ROLE [user name] WITH LOGIN ENCRYPTED PASSWORD '[password]';" -d ovirt_engine_history
- 授予新创建的用户权限以连接到历史记录数据库：
# psql -U postgres -c "GRANT CONNECT ON DATABASE ovirt_engine_history TO [user name];"
- 授予新创建的用户使用
public模式：# psql -U postgres -c "GRANT USAGE ON SCHEMA public TO [user name];" ovirt_engine_history
- 生成授予新建用户的剩余权限，并将其保存到文件中：
# psql -U postgres -c "SELECT 'GRANT SELECT ON ' || relname || ' TO [user name];' FROM pg_class JOIN pg_namespace ON pg_namespace.oid = pg_class.relnamespace WHERE nspname = 'public' AND relkind IN ('r', 'v');" --pset=tuples_only=on ovirt_engine_history > grant.sql - 使用您在上一步中创建的文件为新创建的用户授予权限：
# psql -U postgres -f grant.sql ovirt_engine_history
- 删除您用来为新创建的用户授予权限的文件：
# rm grant.sql
- 为新创建的用户将以下行添加到
/var/lib/pgsql/data/pg_hba.conf文件中：# TYPE DATABASE USER ADDRESS METHOD host ovirt_engine_history [user name] 0.0.0.0/0 md5 host ovirt_engine_history [user name] ::0/0 md5
- 重新载入 PostgreSQL 服务：
# systemctl reload postgresql
- 您可以测试只读用户的访问权限：
# psql -U [user name] ovirt_engine_history -h localhost Password for user [user name]: psql (9.2.23) Type "help" for help. ovirt_engine_history=>
- 要退出
ovirt_engine_history数据库，请输入\q。
对于
ovirt_engine_history 数据库中的表格和视图，只读用户的 SELECT 语句会成功，而修改会失败。
2.7. 统计历史视图
统计数据数据
每小时、每天，以及示例视图。
要查询统计信息视图，请运行 SELECT * FROM view_name_[hourly|daily|samples];。例如：
# SELECT * FROM v4_1_statistics_hosts_resources_usage_daily;
要列出所有可用视图，请运行：
# \dv
2.7.1. 启用调试模式
您可以启用调试模式，在
/var/log/ovirt-engine-dwh/ovirt-engine-dwhd.log 文件中记录日志抽样、每小时和每日作业时间。这对于检查 ETL 进程非常有用。默认情况下禁用调试模式。
- 登录 Manager 机器并创建配置文件（例如，
/etc/ovirt-engine-dwh/ovirt-engine-dwhd.conf.d/logging.conf）。 - 在配置文件中添加以下行：
# DWH_AGGREGATION_DEBUG=true
- 重启
ovirt-engine-dwhd服务：# systemctl restart ovirt-engine-dwhd.service
要禁用调试模式，请删除配置文件并重启该服务。
2.7.2. Storage Domain Statistics Views
表 2.2. 系统中每个存储域的历史统计
| 名称 | 类型 | Description | 索引 |
|---|---|---|---|
| history_id | bigint | 表中此行的唯一 ID。 | 否 |
| history_datetime | date | 此历史记录行的时间戳（根据聚合级别，舍入到分钟、小时、天）。 | 是 |
| storage_domain_id | uuid | 系统中存储域的唯一 ID。 | 是 |
| storage_domain_status | smallint | 存储域状态。 | 否 |
| seconds_in_status | 整数 | 存储域处于状态的秒数，如聚合期间的状态列中所示。例如，如果存储域在一分钟内“活跃”了 55 秒，"不活跃" 5 秒，则在同一分钟的表中报告两行。一行是 Active（活跃）状态（seconds_in_status 为 55），另一个行是 Inactive（不活跃）状态（seconds_in_status 为 5）。 | 否 |
| minutes_in_status | numeric(7,2) | 存储域处于状态的分钟总数，如聚合期间的状态列中所示。例如，如果存储域在一小时内 55 分钟"活跃"，5 分钟"不活跃"，则在同一小时的表中将报告两行。一行为 Active 状态（minutes_in_status 为 55），另一行是 Inactive 状态（minutes_in_status 为 5）。 | 否 |
| available_disk_size_gb | 整数 | 磁盘上可用（未使用的）容量，以 GB 为单位表示。 | 否 |
| used_disk_size_gb | 整数 | 磁盘上使用的总容量，以 GB 为单位表示。 | 否 |
| storage_configuration_version | 整数 | 示例时存储域配置版本。这与 v4_1_configuration_history_storage_domains 视图中的 history_id 值相同，它可用于加入它们。 | 是 |
2.7.3. 主机统计信息视图
表 2.3. 系统中每个主机的历史统计
| 名称 | 类型 | Description | 索引 |
|---|---|---|---|
| history_id | bigint | 表中此行的唯一 ID。 | 否 |
| history_datetime | date | 此历史记录行的时间戳（根据聚合级别，舍入到分钟、小时、天）。 | 是 |
| host_id | uuid | 系统中主机的唯一 ID。 | 是 |
| host_status | smallint |
| 否 |
| seconds_in_status | 整数 | 主机处于聚合期间 status 列中显示的秒数。例如，如果主机在一分钟内有 55 秒在线，5 秒下线，则这分钟包括两个行。一个状态将为 Up seconds_in_status 为 55，另一个状态为 Down，seconds_in_status 为 5。 | 否 |
| minutes_in_status | numeric(7,2) | 主机处于聚合期间 status 列中显示的分钟数。例如，如果主机在一小时内为 55 分钟，并且停机 5 分钟，则两个行将显示为本小时。一个状态将为 Up minutes_in_status 为 55，另一个状态为 Down，minutes_in_status 为 5。 | 否 |
| memory_usage_percent | smallint | 主机上已用内存的百分比。 | 否 |
| max_memory_usage | smallint | 聚合期间的最大内存用量，以百分比表示。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| ksm_shared_memory_mb | bigint | 内核共享内存大小，以 MB(MB)表示主机使用。 | 否 |
| max_ksm_shared_memory_mb | bigint | 聚合周期内的最大 KSM 内存用量以 MB(MB)表示。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| cpu_usage_percent | smallint | 主机上使用的 CPU 百分比。 | 否 |
| max_cpu_usage | smallint | 聚合周期的最大 CPU 使用量，以百分比表示。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| ksm_cpu_percent | smallint | 主机上的 CPU 百分比 ksm 使用。 | 否 |
| max_ksm_cpu_percent | smallint | 聚合周期的最大 KSM 使用量，以百分比表示。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| active_vms | smallint | 这个聚合的活动虚拟机的平均数量。 | 否 |
| max_active_vms | smallint | 聚合期间内虚拟机的最大数量。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| total_vms | smallint | 此聚合主机上所有虚拟机的平均数量。 | 否 |
| max_total_vms | smallint | 聚合期间虚拟机的最大数量。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| total_vms_vcpus | 整数 | 分配给主机的 vCPU 总数。 | 否 |
| max_total_vms_vcpus | 整数 | 聚合期间的最大虚拟机 vCPU 数量。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| cpu_load | 整数 | 主机的 CPU 负载。 | 否 |
| max_cpu_load | 整数 | 聚合期间的最大 CPU 负载。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| system_cpu_usage_percent | smallint | 主机上使用的 CPU 百分比。 | 否 |
| max_system_cpu_usage_percent | smallint | 聚合周期的最大系统 CPU 使用量，以百分比表示。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| user_cpu_usage_percent | smallint | 在主机上使用了用户 CPU 百分比。 | 否 |
| max_user_cpu_usage_percent | smallint | 聚合周期的最大用户 CPU 使用量，以百分比表示。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| swap_used_mb | 整数 | 以 MB(MB)为单位使用主机的交换大小。 | 否 |
| max_swap_used_mb | 整数 | 以 MB(MB)表示的聚合周期内的最大用户交换大小使用主机，以百分比表示。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| host_configuration_version | 整数 | 示例时主机配置版本。这与 v4_1_configuration_history_hosts 视图中的 history_id 值相同，它可用于加入它们。 | 是 |
2.7.4. 主机接口统计信息视图
表 2.4. 系统中每个主机网络接口的历史统计
| 名称 | 类型 | Description | 索引 |
|---|---|---|---|
| history_id | bigint | 表中此行的唯一 ID。 | 否 |
| history_datetime | date | 此历史记录视图的时间戳（根据聚合级别，舍入为分钟、小时、天）。 | 是 |
| host_interface_id | uuid | 系统中接口的唯一标识符。 | 是 |
| receive_rate_percent | smallint | 在主机上使用的接收率百分比。 | 否 |
| max_receive_rate_percent | smallint | 聚合周期的最大接收率，以百分比表示。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| transmit_rate_percent | smallint | 在主机上使用传输率百分比。 | 否 |
| max_transmit_rate_percent | smallint | 聚合期间的最大传输率，以百分比表示。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| received_total_byte | bigint | 主机接收的字节数。 | 否 |
| transmitted_total_byte | bigint | 从主机传输的字节数。 | 否 |
| host_interface_configuration_version | 整数 | 示例时主机接口配置版本。这与 v4_1_configuration_history_hosts_interfaces 视图中的 history_id 值相同，它可用于加入它们。 | 是 |
2.7.5. 虚拟机统计视图
表 2.5. 系统中每个虚拟机的历史统计
| 名称 | 类型 | Description | 索引 |
|---|---|---|---|
| history_id | bigint | 表中此行的唯一 ID。 | 否 |
| history_datetime | date | 此历史记录行的时间戳（根据聚合级别，舍入到分钟、小时、天）。 | 是 |
| vm_id | uuid | 系统中虚拟机的唯一 ID。 | 是 |
| vm_status | smallint |
| 否 |
| seconds_in_status | 整数 | 虚拟机处于聚合期间 status 列中显示的秒数。例如，如果虚拟机在一分钟内 55 秒在线，5 秒下线，则这分钟会有两个行。一个状态将为 Up 和 seconds_in_status，另一个状态为 Down，seconds_in_status 为 5。 | 否 |
| minutes_in_status | numeric(7,2) | 虚拟机处于聚合期间状态中显示的分钟总数。例如，如果虚拟机在一小时内为 55 分钟上线，5 分钟下线，则这个小时会有两个行。一个状态将为 Up 和 minutes_in_status，另一个状态为 Down，minutes_in_status 为 5。 | 否 |
| cpu_usage_percent | smallint | 虚拟机使用的 CPU 的百分比。 | 否 |
| max_cpu_usage | smallint | 聚合周期的最大 CPU 使用量，以百分比表示。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| memory_usage_percent | smallint | 虚拟机中使用的内存百分比。必须在虚拟机上安装客户机工具，以便记录内存用量。 | 否 |
| max_memory_usage | smallint | 聚合期间的最大内存用量，以百分比表示。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。必须在虚拟机上安装客户机工具，以便记录内存用量。 | 否 |
| user_cpu_usage_percent | smallint | 在主机上使用了用户 CPU 百分比。 | 否 |
| max_user_cpu_usage_percent | smallint | 聚合周期的最大用户 CPU 使用量，以百分比表示。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| system_cpu_usage_percent | smallint | 在主机上使用的系统 CPU 百分比。 | 否 |
| max_system_cpu_usage_percent | smallint | 聚合周期的最大系统 CPU 使用量，以百分比表示。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| vm_ip | text | 第一个 NIC 的 IP 地址。仅在安装了客户机代理时才显示。 | 否 |
| currently_running_on_host | uuid | 虚拟机在其上运行的主机的唯一 ID。 | 否 |
| current_user_id | uuid | 如果安装了客户机代理，登录到虚拟机控制台的用户唯一 ID。 | 否 |
| disks_usage | text | 磁盘描述。文件系统类型、挂载点、总大小和使用的大小。 | 否 |
| vm_configuration_version | 整数 | 示例时虚拟机配置版本。这与 v4_1_configuration_history_vms 视图中的 history_id 值相同。 | 是 |
| current_host_configuration_version | 整数 | 示例时主机配置版本。这与 v4_1_configuration_history_hosts 视图中的 history_id 值相同，它可用于加入它们。 | 是 |
| memory_buffered_kb | bigint | 虚拟机上缓冲的内存量(KB)。 | 否 |
| memory_cached_kb | bigint | 虚拟机上缓存的内存量(KB)。 | 否 |
| max_memory_buffered_kb | bigint | 聚合周期的最大缓冲内存（以 KB 为单位）。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| max_memory_cached_kb | bigint | 聚合期间的最大缓存内存（以 KB 为单位）。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
2.7.6. 虚拟机接口统计信息视图
表 2.6. 系统中虚拟机网络接口的历史统计
| 名称 | 类型 | Description | 索引 |
|---|---|---|---|
| history_id | 整数 | 表中此行的唯一 ID。 | 否 |
| history_datetime | date | 此历史记录行的时间戳（根据聚合级别，舍入到分钟、小时、天）。 | 是 |
| vm_interface_id | uuid | 系统中接口的唯一 ID。 | 是 |
| receive_rate_percent | smallint | 在主机上使用的接收率百分比。 | 否 |
| max_receive_rate_percent | smallint | 聚合周期的最大接收率，以百分比表示。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| transmit_rate_percent | smallint | 在主机上使用传输率百分比。 | 否 |
| max_transmit_rate_percent | smallint | 聚合期间的最大传输率，以百分比表示。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时平均率上限。 | 否 |
| received_total_byte | bigint | 虚拟机接收的字节数。 | 否 |
| transmitted_total_byte | bigint | 从虚拟机传输的字节数。 | 否 |
| vm_interface_configuration_version | 整数 | 抽样时虚拟机接口配置版本。这与 v4_1_configuration_history_vms_interfaces 视图中的 history_id 值相同，它可用于加入它们。 | 是 |
2.7.7. 虚拟磁盘统计视图
表 2.7. 系统中虚拟磁盘的历史统计
| 名称 | 类型 | Description | 索引 |
|---|---|---|---|
| history_id | bigint | 表中此行的唯一 ID。 | 否 |
| history_datetime | date | 此历史记录行的时间戳（根据聚合级别，舍入到分钟、小时、天）。 | 是 |
| vm_disk_id | uuid | 系统中磁盘的唯一 ID。 | 是 |
| vm_disk_status | smallint |
| 否 |
| seconds_in_status | 整数 | 虚拟磁盘处于聚合期间 status 列中显示的秒数。例如，如果虚拟机在一分钟内 55 被锁定，5 秒正常，则这分钟会有两个行。一个状态将为 Locked seconds_in_status 为 55，另一个状态为 OK，seconds_in_status 为 5。 | 否 |
| minutes_in_status | numeric(7,2) | 虚拟磁盘处于聚合期间状态中显示的分钟总数。例如，如果虚拟磁盘在一小时内 55 分钟被锁定，5 分钟正常，则这小时会有两个行。一个状态将为 Locked minutes_in_status 为 55，另一个状态为 OK，minutes_in_status 为 5。 | 否 |
| vm_disk_actual_size_mb | 整数 | 分配给磁盘的实际大小。 | 否 |
| read_rate_bytes_per_second | 整数 | 磁盘读取率（以字节/秒为单位）。 | 否 |
| max_read_rate_bytes_per_second | 整数 | 聚合期间的最大读取率。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| read_latency_seconds | numeric(18,9) | 虚拟磁盘读取延迟（以秒为单位）。 | 否 |
| max_read_latency_seconds | numeric(18,9) | 聚合周期的最大读取延迟，单位为秒。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| write_rate_bytes_per_second | 整数 | 对磁盘的写入率（以字节/秒为单位）。 | 否 |
| max_write_rate_bytes_per_second | 整数 | 聚合期间的最大写入率。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| write_latency_seconds | numeric(18,9) | 虚拟磁盘写入延迟（以秒为单位）。 | 否 |
| max_write_latency_seconds | numeric(18,9) | 聚合期间的最大写入延迟（以秒为单位）。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| flush_latency_seconds | numeric(18,9) | 虚拟磁盘 flush 延迟（以秒为单位）。 | 否 |
| max_flush_latency_seconds | numeric(18,9) | 聚合周期的最大 flush 延迟（以秒为单位）。对于每小时聚合，这是收集最多的样本值。对于每日聚合，它是每小时的平均值最大值。 | 否 |
| vm_disk_configuration_version | 整数 | 抽样时的虚拟磁盘配置版本。这与 v4_1_configuration_history_vms_disks 视图中的 history_id 值相同，它可用于加入它们。 | 是 |
2.8. 配置历史视图
要查询配置视图，请运行 SELECT * FROM view_name;。例如：
# SELECT * FROM v4_1_configuration_history_datacenters;
要列出所有可用视图，请运行：
# \dv
注意
delete_date 不会显示在最新的视图中，因为这些视图提供了按照定义未被删除的最新实体配置。
2.8.1. 数据中心配置
下表显示了系统中数据中心的配置历史记录参数。
表 2.8. v4_1_configuration_history_datacenters
| 名称 | 类型 | Description | 索引 |
|---|---|---|---|
| history_id | 整数 | 历史记录数据库中配置版本的 ID。这与 v4_1_configuration_history_clusters 视图中的 datacenter_configuration_version 的值相同，它可用于加入它们。 | 否 |
| datacenter_id | uuid | 系统中数据中心的唯一 ID。 | 是 |
| datacenter_name | character varying(40) | 数据中心的名称，如编辑对话框中显示。 | 否 |
| datacenter_description | character varying(4000) | 数据中心的描述，如编辑对话框中显示。 | 否 |
| is_local_storage | 布尔值 | 指明数据中心是否使用本地存储的标志。 | 否 |
| create_date | 使用时区的时间戳 | 这个实体被添加到系统的日期。 | 否 |
| update_date | 使用时区的时间戳 | 这个实体已在系统中更改的日期。 | 否 |
| delete_date | 使用时区的时间戳 | 这个实体已从系统中删除的日期。 | 否 |
2.8.2. 数据中心存储域映射
下表显示了系统中存储域和数据中心之间的关系。
表 2.9. v4_1_map_history_datacenters_storage_domains
| 名称 | 类型 | Description | 索引 |
|---|---|---|---|
| history_id | 整数 | 历史记录数据库中配置版本的 ID。这与 v4_1_configuration_history_clusters 视图中的 datacenter_configuration_version 的值相同，它可用于加入它们。 | 否 |
| storage_domain_id | uuid | 系统中这个存储域的唯一 ID。这可以用于加入 v4_1_configuration_history_storage_domains 视图。 | 是 |
| datacenter_id | uuid | 系统中数据中心的唯一 ID。这可以用于加入 v4_1_configuration_history_datacenters 视图。 | 是 |
| attach_date | 使用时区的时间戳 | 存储域附加到数据中心的日期。 | 否 |
| detach_date | 使用时区的时间戳 | 存储域从数据中心分离的日期。 | 否 |
2.8.3. 存储域配置
下表显示了系统中存储域的配置历史记录参数。
表 2.10. v4_1_configuration_history_storage_domains
| 名称 | 类型 | Description | 索引 |
|---|---|---|---|
| history_id | 整数 | 历史记录数据库中配置版本的 ID。这与存储域统计视图中的 storage_configuration_version 值相同，并可用于加入它们。 | 否 |
| storage_domain_id | uuid | 系统中这个存储域的唯一 ID。 | 是 |
| storage_domain_name | character varying(250) | 存储域名称。 | 否 |
| storage_domain_type | smallint |
| 否 |
| storage_type | smallint |
| 否 |
| create_date | 使用时区的时间戳 | 这个实体被添加到系统的日期。 | 否 |
| update_date | 使用时区的时间戳 | 这个实体已在系统中更改的日期。 | 否 |
| delete_date | 使用时区的时间戳 | 这个实体已从系统中删除的日期。 | 否 |
2.8.4. 集群配置
下表显示了系统中集群的配置历史记录参数。
表 2.11. v4_1_configuration_history_clusters
| 名称 | 类型 | Description | 索引 |
|---|---|---|---|
| history_id | 整数 | 历史记录数据库中配置版本的 ID。这与 v4_1_configuration_history_hosts 和 v4_1_configuration_history_vms 视图中的 cluster_configuration_version 的值相同，它可用于加入它们。 | 否 |
| cluster_id | uuid | 此集群所在的数据中心的唯一标识符。 | 是 |
| cluster_name | character varying(40) | 集群名称，如编辑对话框中显示。 | 否 |
| cluster_description | character varying(4000) | 按照编辑对话框中所定义。 | 否 |
| datacenter_id | uuid | 此集群所在的数据中心的唯一标识符。 | 是 |
| cpu_name | character varying(255) | 如编辑对话框中所示。 | 否 |
| compatibility_version | character varying(40) | 如编辑对话框中所示。 | 否 |
| datacenter_configuration_version | 整数 | 在创建或更新时，数据中心配置版本。这与 v4_1_configuration_history_datacenters 视图中的 history_id 值相同，它可用于加入它们。 | 否 |
| create_date | 使用时区的时间戳 | 这个实体被添加到系统的日期。 | 否 |
| update_date | 使用时区的时间戳 | 这个实体已在系统中更改的日期。 | 否 |
| delete_date | 使用时区的时间戳 | 这个实体已从系统中删除的日期。 | 否 |
2.8.5. 主机配置
下表显示了系统中主机的配置历史记录参数。
表 2.12. v4_1_configuration_history_hosts
| 名称 | 类型 | Description | 索引 |
|---|---|---|---|
| history_id | 整数 | 历史记录数据库中配置版本的 ID。这与主机统计视图中的 host_configuration_version 的值相同，并可用于加入它们。 | 否 |
| host_id | uuid | 系统中主机的唯一 ID。 | 是 |
| host_unique_id | character varying(128) | 此字段是主机的物理 UUID 及其 MAC 地址之一的组合，用于检测系统中已注册的主机。 | 否 |
| host_name | character varying(255) | 主机的名称（与编辑对话框中相同）。 | 否 |
| cluster_id | uuid | 此主机所属集群的唯一 ID。 | 是 |
| host_type | smallint |
| 否 |
| fqdn_or_ip | character varying(255) | Red Hat Virtualization Manager 的 DNS 名称或 IP 地址与 （如编辑对话框中显示）进行通信。 | 否 |
| memory_size_mb | 整数 | 主机的物理内存容量，以 MB (MB)表示。 | 否 |
| swap_size_mb | 整数 | 主机 swap 分区大小。 | 否 |
| cpu_model | character varying(255) | 主机的 CPU 模型。 | 否 |
| number_of_cores | smallint | 主机上的 CPU 内核数。 | 否 |
| number_of_sockets | smallint | CPU 插槽总数。 | 否 |
| cpu_speed_mh | numeric(18,0) | 主机的 CPU 速度，以 megahertz (MHz)表示。 | 否 |
| host_os | character varying(255) | 主机的操作系统版本。 | 否 |
| kernel_version | character varying(255) | 主机的内核版本。 | 否 |
| kvm_version | character varying(255) | 主机的 KVM 版本。 | 否 |
| vdsm_version | character varying | 主机的 VDSM 版本。 | 否 |
| vdsm_port | 整数 | 如编辑对话框中所示。 | 否 |
| threads_per_core | smallint | 每个内核的线程总数。 | 否 |
| hardware_manufacturer | character varying(255) | 主机的硬件制造商。 | 否 |
| hardware_product_name | character varying(255) | 主机硬件的产品名称。 | 否 |
| hardware_version | character varying(255) | 主机硬件的版本。 | 否 |
| hardware_serial_number | character varying(255) | 主机硬件的序列号。 | 否 |
| cluster_configuration_version | 整数 | 创建或更新时的集群配置版本。这与 v4_1_configuration_history_clusters 视图中的 history_id 值相同，它可用于加入它们。 | 否 |
| create_date | 使用时区的时间戳 | 这个实体被添加到系统的日期。 | 否 |
| update_date | 使用时区的时间戳 | 这个实体已在系统中更改的日期。 | 否 |
| delete_date | 使用时区的时间戳 | 这个实体已从系统中删除的日期。 | 否 |
2.8.6. 主机接口配置
下表显示了系统中主机接口的配置历史记录参数。
表 2.13. v4_1_configuration_history_hosts_interfaces
| 名称 | 类型 | Description | 索引 |
|---|---|---|---|
| history_id | 整数 | 历史记录数据库中配置版本的 ID。这与主机接口统计视图中的 host_interface_configuration_version 的值相同，并可用于加入它们。 | 否 |
| host_interface_id | uuid | 系统中这个接口的唯一 ID。 | 是 |
| host_interface_name | character varying(50) | 主机报告的接口名称。 | 否 |
| host_id | uuid | 此接口所属的主机的唯一 ID。 | 是 |
| host_interface_type | smallint |
| 否 |
| host_interface_speed_bps | 整数 | 接口速度（以位/每秒表示）。 | 否 |
| mac_address | character varying(59) | 接口 MAC 地址。 | 否 |
| logical_network_name | character varying(50) | 与接口关联的逻辑网络。 | 否 |
| ip_address | character varying(20) | 如编辑对话框中所示。 | 否 |
| gateway | character varying(20) | 如编辑对话框中所示。 | 否 |
| bond | 布尔值 | 用于指示该接口是否为绑定接口的标志。 | 否 |
| bond_name | character varying(50) | 这个接口其中一部分的绑定的名称（如果属于绑定的一部分）。 | 否 |
| vlan_id | 整数 | 如编辑对话框中所示。 | 否 |
| host_configuration_version | 整数 | 在创建或更新时主机配置版本。这与 v4_1_configuration_history_hosts 视图中的 history_id 值相同，它可用于加入它们。 | 否 |
| create_date | 使用时区的时间戳 | 这个实体被添加到系统的日期。 | 否 |
| update_date | 使用时区的时间戳 | 这个实体已在系统中更改的日期。 | 否 |
| delete_date | 使用时区的时间戳 | 这个实体已从系统中删除的日期。 | 否 |
2.8.7. 虚拟机配置
下表显示了系统中虚拟机的配置历史记录参数。
表 2.14. v4_1_configuration_history_vms
| 名称 | 类型 | Description | 索引 |
|---|---|---|---|
| history_id | 整数 | 历史记录数据库中配置版本的 ID。这与虚拟机统计视图中的 vm_configuration_version 的值相同，并可用于加入它们。 | 否 |
| vm_id | uuid | 系统中此虚拟机的唯一 ID。 | 是 |
| vm_name | character varying(255) | 虚拟机的名称。 | 否 |
| vm_description | character varying(4000) | 如编辑对话框中所示。 | 否 |
| vm_type | smallint |
| 否 |
| cluster_id | uuid | 此虚拟机所属集群的唯一 ID。 | 是 |
| template_id | uuid | 此虚拟机派生的模板的唯一 ID。字段供以后使用，因为模板不会与此版本中的历史记录数据库同步。 | 否 |
| template_name | character varying(40) | 此虚拟机派生的模板的名称。 | 否 |
| cpu_per_socket | smallint | 每个插槽的虚拟 CPU. | 否 |
| number_of_sockets | smallint | 虚拟 CPU 插槽总数。 | 否 |
| memory_size_mb | 整数 | 分配给虚拟机的总内存，以兆字节(MB)表示。 | 否 |
| operating_system | smallint |
| 否 |
| default_host | uuid | 如编辑对话框中所示，系统中默认主机的 ID。 | 否 |
| high_availability | 布尔值 | 如编辑对话框中所示。 | 否 |
| 初始化 | 布尔值 | 用于指示此虚拟机至少为 Sysprep 初始化目的启动一次的标志。 | 否 |
| 无状态 | 布尔值 | 如编辑对话框中所示。 | 否 |
| fail_back | 布尔值 | 如编辑对话框中所示。 | 否 |
| usb_policy | smallint | 如编辑对话框中所示。 | 否 |
| time_zone | character varying(40) | 如编辑对话框中所示。 | 否 |
| vm_pool_id | uuid | 此虚拟机所属的池的 ID。 | 否 |
| vm_pool_name | character varying(255) | 虚拟机的名称。 | 否 |
| created_by_user_id | uuid | 创建此虚拟机的用户的 ID。 | 否 |
| cluster_configuration_version | 整数 | 创建或更新时的集群配置版本。这与 v4_1_configuration_history_clusters 视图中的 history_id 值相同，它可用于加入它们。 | 否 |
| default_host_configuration_version | 整数 | 在创建或更新时主机配置版本。这与 v4_1_configuration_history_hosts 视图中的 history_id 值相同，它可用于加入它们。 | 否 |
| create_date | 使用时区的时间戳 | 这个实体被添加到系统的日期。 | 否 |
| update_date | 使用时区的时间戳 | 这个实体已在系统中更改的日期。 | 否 |
| delete_date | 使用时区的时间戳 | 这个实体已从系统中删除的日期。 | 否 |
2.8.8. 虚拟机接口配置
下表显示了系统中虚拟接口的配置历史记录参数。
表 2.15. v4_1_configuration_history_vms_interfaces
| 名称 | 类型 | Description | 索引 |
|---|---|---|---|
| history_id | 整数 | 历史记录数据库中配置版本的 ID。这与虚拟机接口统计视图中的 vm_interface_configuration_version 的值相同，并可用于加入它们。 | 否 |
| vm_id | uuid | 系统中虚拟机的唯一 ID。 | 是 |
| vm_interface_id | uuid | 系统中这个接口的唯一 ID。 | 是 |
| vm_interface_name | character varying(50) | 如编辑对话框中所示。 | 否 |
| vm_interface_type | smallint |
虚拟接口的类型。
| 否 |
| vm_interface_speed_bps | 整数 | 在聚合期间接口平均速度（以每秒位数为单位）。 | 否 |
| mac_address | character varying(20) | 如编辑对话框中所示。 | 否 |
| logical_network_name | character varying(50) | 如编辑对话框中所示。 | 否 |
| vm_configuration_version | 整数 | 创建或更新时的虚拟机配置版本。这与 v4_1_configuration_history_vms 视图中的 history_id 值相同，它可用于加入它们。 | 否 |
| create_date | 使用时区的时间戳 | 这个实体被添加到系统的日期。 | 否 |
| update_date | 使用时区的时间戳 | 这个实体已在系统中更改的日期。 | 否 |
| delete_date | 使用时区的时间戳 | 这个实体已从系统中删除的日期。 | 否 |
2.8.9. 虚拟机设备配置
下表显示了虚拟机及其关联的设备之间的关系，包括磁盘和虚拟接口。
表 2.16. v4_1_configuration_history_vms_devices
| 名称 | 类型 | Description | 索引 |
|---|---|---|---|
| history_id | 整数 | 历史记录数据库中配置版本的 ID。 | 否 |
| vm_id | uuid | 系统中虚拟机的唯一 ID。 | 是 |
| device_id | uuid | 系统中设备的唯一 ID。 | 否 |
| type | character varying(30) | 虚拟机设备的类型。这可以是 "disk" 或 "interface"。 | 是 |
| address | character varying(255) | 设备的物理地址。 | 否 |
| is_managed | 布尔值 | 表示该设备是否由 Manager 管理的标记。 | 否 |
| is_plugged | 布尔值 | 表示该设备是否插入到虚拟机的标记。 | 否 |
| is_readonly | 布尔值 | 表示该设备是否只读的标记。 | 否 |
| vm_configuration_version | 整数 | 生成示例时的虚拟机配置版本。 | 否 |
| device_configuration_version | 整数 | 抽样时的设备配置版本。- 如果 type 字段的值被设置为 interface，则此字段与 v4_1_configuration_history_vms_interfaces 视图中的 history_id 字段连接。- 如果 type 字段的值被设置为 disk，则此字段与 v4_1_configuration_history_vms_disks 视图中的 history_id 字段连接。 | 否 |
| create_date | 使用时区的时间戳 | 这个实体被添加到系统的日期。 | 否 |
| update_date | 使用时区的时间戳 | 这个实体被添加到系统的日期。 | 否 |
| delete_date | 使用时区的时间戳 | 这个实体被添加到系统的日期。 | 否 |
2.8.10. 虚拟磁盘配置
下表显示了系统中虚拟磁盘的配置历史记录参数。
表 2.17. v4_1_configuration_history_vms_disks
| 名称 | 类型 | Description | 索引 |
|---|---|---|---|
| history_id | 整数 | 历史记录数据库中配置版本的 ID。这与虚拟磁盘统计视图中的 vm_disk_configuration_version 的值相同，并可用于加入它们。 | 否 |
| vm_disk_id | uuid | 系统中这个磁盘的唯一 ID。 | 是 |
| vm_disk_name | text | 虚拟磁盘的名称，如编辑对话框中显示。 | 否 |
| vm_disk_description | character varying(500) | 如编辑对话框中所示。 | 否 |
| image_id | uuid | 系统中镜像的唯一 ID。 | 否 |
| storage_domain_id | uuid | 此磁盘镜像所属存储域的 ID。 | 是 |
| vm_disk_size_mb | 整数 | 以 MB(MB)为单位定义的磁盘大小。 | 否 |
| vm_disk_type | smallint |
如编辑对话框中所示。当前只使用系统和数据。
| 否 |
| vm_disk_format | smallint |
如编辑对话框中所示。
| 否 |
| is_shared | 布尔值 | 表示虚拟机磁盘是否已共享的标记。 | 否 |
| create_date | 使用时区的时间戳 | 这个实体被添加到系统的日期。 | 否 |
| update_date | 使用时区的时间戳 | 这个实体已在系统中更改的日期。 | 否 |
| delete_date | 使用时区的时间戳 | 这个实体已从系统中删除的日期。 | 否 |
2.8.11. 用户详情历史
下表显示了系统中用户的配置历史记录参数。
表 2.18. v4_1_users_details_history
| 名称 | 类型 | Description |
|---|---|---|
| user_id | uuid | 系统中用户的唯一 ID，如 Manager 生成。 |
| first_name | character varying(255) | 用户的名字。 |
| last_name | character varying(255) | 用户的姓氏。 |
| domain | character varying(255) | 授权扩展的名称。 |
| 用户名 | character varying(255) | 帐户名称。 |
| department | character varying(255) | 用户所属的组织部门。 |
| user_role_title | character varying(255) | 组织中用户的标题或角色。 |
| character varying(255) | 组织中用户的电子邮件。 | |
| external_id | text | 来自外部系统的用户的唯一标识符。 |
| active | 布尔值 | 用于指示用户是否活跃的标记。这会每小时检查。如果用户可以在授权扩展名中找到，则它将保持活动状态。用户在成功登录后变为活动状态。 |
| create_date | 使用时区的时间戳 | 这个实体被添加到系统的日期。 |
| update_date | 使用时区的时间戳 | 这个实体已在系统中更改的日期。 |
| delete_date | 使用时区的时间戳 | 这个实体已从系统中删除的日期。 |
