Red Hat Training

A Red Hat training course is available for Red Hat Virtualization

附录 E. 使用搜索、书签和标签

E.1. 搜索

E.1.1. 在 Red Hat Virtualization 中执行搜索

管理门户支持管理数千种资源，如虚拟机、主机、用户等。 要执行搜索，请在搜索栏中输入搜索查询（自由文本或语法）。搜索查询可以保存为书签以供以后重复使用，因此您不必在每次需要特定搜索结果时重新设置搜索查询。搜索不区分大小写。

E.1.2. 搜索语法和示例

对 Red Hat Virtualization 资源的搜索查询的语法如下：
结果类型：{criteria} [sortby sort_spec]

语法示例

以下示例描述了如何使用搜索查询并帮助您了解 Red Hat Virtualization 如何协助构建搜索查询。

表 E.1. 搜索查询示例

Example 结果
hosts: Vms.status = up 显示所有运行状态为 up 的虚拟机的主机的列表。
虚拟机：domain = qa.company.com 显示在指定域中运行的所有虚拟机的列表。
vm: users.name = Mary 显示属于用户名为 Mary 的所有虚拟机的列表。
Events: severity > normal sortby time 显示所有严重性高于 Normal 的事件的列表，按时间排序。

E.1.3. 搜索自动完成

管理门户提供了自动完成功能，以帮助您创建有效、强大的搜索查询。当您输入搜索查询的每个部分时，搜索的下一部分的下拉列表会在搜索栏下打开。您可以从列表中选择，然后继续键入/选择搜索的下一部分，或者忽略选项并继续手动输入查询。
下表指定管理门户自动完成如何协助构建查询的示例：
Hosts: Vms.status = down

表 E.2. 使用 Auto-Completion 的搜索查询示例

输入 列出已显示的项目 操作
h Hosts (仅 1 个选项)
选择 Hosts 或;
type Hosts
Hosts:
所有主机属性
type v
Hosts: v 以 v开头的主机属性 选择 Vms 或 type Vms
Hosts: Vms 所有虚拟机属性 type s
Hosts: Vms.s 所有以 s开头的虚拟机属性 选择 状态 或类型 status
Hosts: Vms.status
=
=!
选择或类型 =
Hosts: Vms.status = 所有状态值 选择或类型 down

E.1.4. 搜索结果类型选项

结果类型允许您搜索以下类型的资源：
  • vms 虚拟机列表
  • Host 主机列表
  • 池列表
  • Template 模板列表
  • event 列表
  • Users 用户列表
  • Cluster 集群列表
  • DataCenter 数据中心 列表
  • Storage 存储域列表
由于每种资源类型都有一组唯一的属性，以及与之关联的其他资源类型集合，每种搜索类型都有一组有效的语法组合。您还可以使用自动完成功能轻松创建有效的查询。

E.1.5. 搜索标准

您可以在查询中的冒号后指定搜索条件。{criteria} 的语法如下：
<prop><operator><value>
或者
<obj-type><prop><operator><value>

例子

下表描述了语法的部分：

表 E.3. 搜索标准示例

Part Description 值 Example 备注
prop search-for 资源的属性。也可以是资源类型的属性（请参阅 obj-type）或 tag （自定义标签）。 使用特定属性将搜索限制为对象。例如，搜索具有 status 属性的对象。 状态 N/A
obj-type 可以与 search-for 资源关联的资源类型。 这些是系统对象，如数据中心和虚拟机。 用户 N/A
operator 比较运算符。
=
!= (not equal)
>
<
>=
<=
N/A 值选项取决于 obj-type。
值 将表达式与.
字符串
整数
等级
日期（根据区域设置格式化）
jones
256
normal
  • 通配符可以在字符串中使用。
  • "" （两个一组没有空格的引号），可用于表示未初始化（空字符串）字符串。
  • 双引号应该在包含空格的字符串或日期后面使用

E.1.6. 搜索：多个标准和通配符

通配符可以在字符串的语法的 <value > 部分中使用。例如，要查找以 m 开头的所有用户，请输入 m*。
您可以使用布尔值运算符 AND 和 或 执行具有两个条件的 搜索。例如：
Vms: users.name = m* AND status = Up
此查询会返回所有运行的虚拟机，适用于名称以"m"开头的用户。
Vms: users.name = m* AND tag = "paris-loc"
对于名称以"m"开头的用户，此查询会返回带有"paris-loc"标记的所有虚拟机。
在没有使用 AND 或 OR 的情况下指定了两个条件，代表 AND。AND 的优先级高于 OR，OR 的优先级高于没有明确指定的 AND。

E.1.7. 搜索：确定搜索顺序

您可以使用 sortby 确定返回的信息的排序顺序。可以包括排序方向（asc 代表升序，desc 代表降序）。
例如：
events: severity > normal sortby time desc
此查询会返回所有严重性高于 Normal 的事件，按时间排序（降序）。

E.1.8. 搜索数据中心

下表描述了数据中心的所有搜索选项。

表 E.4. 搜索数据中心

属性（资源或资源类型） 类型 描述（参考）
Clusters.clusters-prop 取决于属性类型 与数据中心关联的集群的属性。
name 字符串 数据中心的名称。
description 字符串 数据中心的描述。
type 字符串 数据中心的类型。
status list 数据中心的可用性。
sortby list 将返回的结果按照其中一个资源属性对结果进行排序。
page 整数 要显示的结果数。

Example

Datacenter: type = nfs and status != up

这个示例返回带有以下内容的数据中心列表：
  • 存储类型为 NFS 和状态

E.1.9. 搜索集群

下表描述了集群的所有搜索选项。

表 E.5. 搜索集群

属性（资源或资源类型） 类型 描述（参考）
Datacenter.datacenter-prop 取决于属性类型 与集群关联的数据中心的属性。
Datacenter 字符串 集群所属的数据中心。
name 字符串 标识网络上的集群的唯一名称。
description 字符串 集群的描述。
initialized 字符串 true 或 False 表示集群的状态。
sortby list 将返回的结果按照其中一个资源属性对结果进行排序。
page 整数 要显示的结果数。

Example

Clusters: initialized = true or name = Default

这个示例返回如下集群列表：
  • 初始化的; 或
  • 命名的默认

E.1.10. 搜索主机

下表描述了主机的所有搜索选项。

表 E.6. 搜索主机

属性（资源或资源类型） 类型 描述（参考）
Vms.Vms-prop 取决于属性类型 与主机关联的虚拟机的属性。
Templates.templates-prop 取决于属性类型 与主机关联的模板的属性。
Events.events-prop 取决于属性类型 与主机关联的事件的属性。
Users.users-prop 取决于属性类型 与主机关联的用户的属性。
name 字符串 主机的名称。
status list 主机的可用性。
external_status 字符串 外部系统和插件报告的主机健康状态。
cluster 字符串 主机所属的集群。
address 字符串 标识网络上主机的唯一名称。
cpu_usage 整数 使用的处理能力百分比。
mem_usage 整数 使用的内存百分比。
network_usage 整数 网络用量百分比。
load 整数 在给定时间片段中，等待每个处理器的 run-queue 中执行的作业。
version 整数 操作系统的版本号。
cpus 整数 主机上的 CPU 数量。
memory 整数 可用内存量。
cpu_speed 整数 CPU 的处理速度。
cpu_model 字符串 CPU 的类型。
active_vms 整数 当前正在运行的虚拟机数量。
migrating_vms 整数 当前正在迁移的虚拟机数量。
committed_mem 整数 提交的内存百分比。
tag 字符串 分配给主机的标签。
type 字符串 主机的类型。
datacenter 字符串 主机所属的数据中心。
sortby list 将返回的结果按照其中一个资源属性对结果进行排序。
page 整数 要显示的结果数。

Example

Hosts: cluster = Default and Vms.os = rhel6

这个示例返回主机列表：
  • 是运行 Red Hat Enterprise Linux 6 操作系统的默认集群和主机虚拟机的一部分。

E.1.11. 搜索网络

下表描述了网络的所有搜索选项。

表 E.7. 搜索网络

属性（资源或资源类型） 类型 描述（参考）
Cluster_network.clusternetwork-prop 取决于属性类型 与网络关联的集群的属性。
Host_Network.hostnetwork-prop 取决于属性类型 与网络关联的主机的属性。
name 字符串 标识网络的人类可读名称。
description 字符串 描述网络的关键字或文本（在创建网络时可选使用）。
vlanid 整数 网络的 VLAN ID。
stp 字符串 是否为网络启用或禁用生成树协议(STP)。
mtu 整数 逻辑网络的最大传输单元。
vmnetwork 字符串 网络是否仅用于虚拟机流量。
datacenter 字符串 网络附加到的数据中心。
sortby list 将返回的结果按照其中一个资源属性对结果进行排序。
page 整数 要显示的结果数。

Example

Network: mtu > 1500 and vmnetwork = true

这个示例返回网络列表：
  • 最大传输单元大于 1500 字节
  • 设置的用户仅供虚拟机使用。

E.1.12. 搜索存储

下表描述了存储的所有搜索选项。

表 E.8. 搜索存储

属性（资源或资源类型） 类型 描述（参考）
Hosts.hosts-prop 取决于属性类型 与存储关联的主机的属性。
Clusters.clusters-prop 取决于属性类型 与存储关联的集群的属性。
name 字符串 标识网络上存储的唯一名称。
status 字符串 存储域的状态。
external_status 字符串 外部系统和插件报告的存储域的健康状况。
datacenter 字符串 存储所属的数据中心。
type 字符串 存储的类型。
size 整数 存储的大小。
used 整数 使用的存储量。
committed 整数 提交的存储量。
sortby list 将返回的结果按照其中一个资源属性对结果进行排序。
page 整数 要显示的结果数。

Example

Storage: size > 200 or used < 50

这个示例返回了一个存储列表：
  • 存储空间总量超过 200 GB；或者
  • 使用的存储空间小于 50 GB。

E.1.13. 搜索磁盘

下表描述了磁盘的所有搜索选项。

表 E.9. 搜索磁盘

属性（资源或资源类型） 类型 描述（参考）
Datacenters.datacenters-prop 取决于属性类型 与磁盘关联的数据中心的属性。
Storages.storages-prop 取决于属性类型 与磁盘关联的存储的属性。
alias 字符串 标识网络上存储的人类可读名称。
description 字符串 描述磁盘时使用的关键字或文本（可选）。
provisioned_size 整数 磁盘的虚拟大小。
size 整数 磁盘大小。
actual_size 整数 分配给磁盘的实际大小。
creation_date 整数 磁盘创建的日期。
bootable 字符串 磁盘是否可以引导。有效值为 0, 1, yes, 或 no 之一
shareable 字符串 磁盘是否能一次连接到多个虚拟机。有效值为 0, 1, yes, 或 no 之一
format 字符串 磁盘格式。可以是 unused, unassigned, cow, 或 raw 之一。
status 字符串 磁盘状态。可以是 unassigned, ok, locked, invalid, 或 illegal 之一。
disk_type 字符串 磁盘的类型。可以是 image 或 lun 之一。
number_of_vms 整数 附加磁盘的虚拟机数量。
vm_names 字符串 附加磁盘的虚拟机的名称。
quota 字符串 虚拟磁盘上强制配额的名称。
sortby list 将返回的结果按照其中一个资源属性对结果进行排序。
page 整数 要显示的结果数。

Example

Disks: format = cow and provisioned_size > 8

这个示例返回虚拟磁盘列表：
  • QCOW，也称为精简配置、格式和
  • 分配的磁盘大小大于 8 GB。

E.1.14. 搜索卷

下表描述了卷的所有搜索选项。

表 E.10. 搜索卷

属性（资源或资源类型） 类型 描述（参考）
Volume.cluster-prop 取决于属性类型 与卷关联的集群的属性。
Cluster 字符串 与卷关联的集群名称。
name 字符串 标识卷的人类可读名称。
type 字符串 可以是 distribute, copy, distributed_replicate, stripe, 或 distributed_stripe 之一。
transport_type 整数 可以是 TCP 或 RDMA 之一。
replica_count 整数 副本数。
stripe_count 整数 条带数。
status 字符串 卷的状态。可以是 Up 或 Down 之一。
sortby list 将返回的结果按照其中一个资源属性对结果进行排序。
page 整数 要显示的结果数。

Example

Volume: transport_type = rdma and stripe_count >= 2

这个示例返回了一个卷列表：
  • 传输类型设置为 RDMA; 和
  • 带 2 个或更多条。

E.1.15. 搜索虚拟机

下表描述了虚拟机的所有搜索选项。

表 E.11. 搜索虚拟机

属性（资源或资源类型） 类型 描述（参考）
Hosts.hosts-prop 取决于属性类型 与虚拟机关联的主机的属性。
Templates.templates-prop 取决于属性类型 与虚拟机关联的模板的属性。
Events.events-prop 取决于属性类型 与虚拟机关联的事件的属性。
Users.users-prop 取决于属性类型 与虚拟机关联的用户的属性。
Storage.storage-prop 取决于属性类型 与虚拟机关联的存储设备的属性。
Vnic.mac-prop 取决于属性类型 与虚拟机关联的 MAC 地址的属性。
name 字符串 虚拟机的名称。
status list 虚拟机可用性。
ip 整数 虚拟机的 IP 地址。
uptime 整数 虚拟机运行了几分钟的时间。
domain 字符串 对这些机器进行分组的域（通常是 Active Directory 域）。
os 字符串 创建虚拟机时选择的操作系统。
creationdate Date 创建虚拟机的日期。
address 字符串 标识网络上的虚拟机的唯一名称。
cpu_usage 整数 使用的处理能力百分比。
mem_usage 整数 使用的内存百分比。
network_usage 整数 使用的网络的百分比。
memory 整数 定义的最大内存。
apps 字符串 当前在虚拟机上安装的应用程序。
cluster list 虚拟机所属的集群。
pool list 虚拟机所属的虚拟机池。
loggedinuser 字符串 当前登录到虚拟机的用户的名称。
tag list 虚拟机所属的标签。
datacenter 字符串 虚拟机所属的数据中心。
type list 虚拟机类型（服务器或桌面）。
quota 字符串 与虚拟机关联的配额名称。
description 字符串 描述虚拟机的关键字或文本，可以选择创建虚拟机时使用。
sortby list 将返回的结果按照其中一个资源属性对结果进行排序。
page 整数 要显示的结果数。
next_run_configuration_exists 布尔值 虚拟机有待处理的配置更改。

Example

Vms: template.name = Win* and user.name = ""

这个示例返回虚拟机列表，其中：
  • 虚拟机基于的模板以 Win 开始，虚拟机将被分配给任何用户。

Example

Vms: cluster = Default and os = windows7

这个示例返回虚拟机列表，其中：
  • 虚拟机所属的集群名为 Default，虚拟机运行 Windows 7 操作系统。

E.1.16. 搜索池

下表描述了池的所有搜索选项。

表 E.12. 搜索池

属性（资源或资源类型） 类型 描述（参考）
name 字符串 池的名称。
description 字符串 池的描述。
type list 池的类型。
sortby list 将返回的结果按照其中一个资源属性对结果进行排序。
page 整数 要显示的结果数。

Example

Pools: type = automatic

这个示例返回带有以下内容的池列表：
  • 自动类型

E.1.17. 搜索模板

下表描述了模板的所有搜索选项。

表 E.13. 搜索模板

属性（资源或资源类型） 类型 描述（参考）
Vms.Vms-prop 字符串 与模板关联的虚拟机的属性。
Hosts.hosts-prop 字符串 与模板关联的主机的属性。
Events.events-prop 字符串 与模板关联的事件的属性。
Users.users-prop 字符串 与模板关联的用户的属性。
name 字符串 模板的名称。
domain 字符串 模板的域。
os 字符串 操作系统的类型。
creationdate 整数
创建模板的日期。
日期格式为 mm/dd/yy。
childcount 整数 从模板创建的虚拟机数量。
mem 整数 定义的内存。
description 字符串 模板的描述。
status 字符串 模板的状态。
cluster 字符串 与模板关联的集群。
datacenter 字符串 与模板关联的数据中心。
quota 字符串 与模板关联的配额。
sortby list 将返回的结果按照其中一个资源属性对结果进行排序。
page 整数 要显示的结果数。

Example

Template: Events.severity >= normal and Vms.uptime > 0

这个示例返回模板列表，其中：
  • 从模板派生的虚拟机上发生了正常或更高严重性的事件，并且虚拟机仍在运行。

E.1.18. 搜索用户

下表描述了用户的所有搜索选项。

表 E.14. 搜索用户

属性（资源或资源类型） 类型 描述（参考）
Vms.Vms-prop 取决于属性类型 与用户关联的虚拟机的属性。
Hosts.hosts-prop 取决于属性类型 与用户关联的主机的属性。
Templates.templates-prop 取决于属性类型 与用户关联的模板的属性。
Events.events-prop 取决于属性类型 与用户关联的事件的属性。
name 字符串 用户名称。
lastname 字符串 用户的姓氏。
usrname 字符串 用户的唯一名称。
department 字符串 用户所属的部门。
group 字符串 用户所属的组。
title 字符串 用户的标题。
status 字符串 用户的状态。
role 字符串 用户的角色。
tag 字符串 用户所属的标签。
pool 字符串 用户所属的池。
sortby list 将返回的结果按照其中一个资源属性对结果进行排序。
page 整数 要显示的结果数。

Example

Users: Events.severity > normal and Vms.status = up or Vms.status = pause

这个示例返回一组用户，其中：
  • 大于正常严重性的事件在其虚拟机上发生，且虚拟机仍在运行；或者
  • 用户的虚拟机已暂停。

E.1.19. 搜索事件

下表描述了可用于搜索事件的所有搜索选项。会根据情况，为许多选项提供自动完成功能。

表 E.15. 搜索事件

属性（资源或资源类型） 类型 描述（参考）
Vms.Vms-prop 取决于属性类型 与事件关联的虚拟机的属性。
Hosts.hosts-prop 取决于属性类型 与事件关联的主机的属性。
Templates.templates-prop 取决于属性类型 与事件关联的模板的属性。
Users.users-prop 取决于属性类型 与事件关联的用户的属性。
Clusters.clusters-prop 取决于属性类型 与事件关联的集群的属性。
Volumes.Volumes-prop 取决于属性类型 与事件关联的卷的属性。
type list 事件的类型。
severity list 事件的严重性： Warning/Error/Normal.
message 字符串 事件类型的描述。
time list 事件发生日。
usrname 字符串 与事件关联的用户名。
event_host 字符串 与事件关联的主机。
event_vm 字符串 与事件关联的虚拟机。
event_template 字符串 与事件关联的模板。
event_storage 字符串 与事件关联的存储。
event_datacenter 字符串 与事件关联的数据中心。
event_volume 字符串 与事件关联的卷。
correlation_id 整数 事件的标识号。
sortby list 将返回的结果按照其中一个资源属性对结果进行排序。
page 整数 要显示的结果数。

Example

Events: Vms.name = testdesktop and Hosts.name = gonzo.example.com

这个示例返回事件列表，其中：
  • 当事件在主机 gonzo.example.com 上运行时，会发生在名为 testdesktop 的虚拟机上。