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 リソースの検索クエリーの構文は、以下のとおりです。
result type: {criteria} [sortby sort_spec]
構文の例

以下の表には、検索クエリーの使用例を記載しています。これにより、Red Hat Virtualization での検索クエリーの構築方法を理解することができます。

表E.1 検索クエリーの例

結果
Hosts: Vms.status = up稼働中の仮想マシンを実行している全ホストの一覧を表示
Vms: domain = qa.company.com指定したドメインで稼働中の全仮想マシンの一覧を表示
Vms: users.name = Maryユーザー名が Mary のユーザーに属する全仮想マシンの一覧を表示
Events: severity > normal sortby time重大度が Normal を超える全イベントの一覧を時間順に表示

E.1.3. 検索のオートコンプリート機能

管理ポータルは、正しく有効な検索クエリーの作成に役立つオートコンプリート機能を提供しています。検索クエリーの一部を入力すると、検索バーの下に、後に続く箇所の選択肢がドロップダウンリストに表示されます。このリストから選択して入力/選択を続けることができます。また、オプションを無視して手動でクエリーの入力を続けることも可能です。
以下の表には、管理ポータルでクエリー構築にオートコンプリート機能を活用する方法の例をまとめています。
Hosts: Vms.status = down

表E.2 オートコンプリートを使用した検索クエリーの例

入力表示される一覧項目アクション
hHosts (オプションは 1 つのみ)
Hosts を選択もしくは
Hosts と入力
Hosts:
ホストの全プロパティー
v と入力
Hosts: vv で始まるホストのプロパティーVms を選択もしくは Vms と入力
Hosts: Vms仮想マシンの全プロパティーs と入力
Hosts: Vms.ss で始まる仮想マシンの全プロパティーstatus を選択もしくは status と入力
Hosts: Vms.status
=
!=
= を選択または入力
Hosts: Vms.status =すべてのステータス値down を選択または入力

E.1.4. 検索結果タイプのオプション

結果タイプを指定して、以下のいずれかのタイプのリソースを検索することができます。
  • Vms: 仮想マシンの一覧
  • Host: ホストの一覧
  • Pools: プールの一覧
  • Template: テンプレートの一覧
  • Event: イベントの一覧
  • Users: ユーザーの一覧
  • Cluster: クラスターの一覧
  • Datacenter: データセンターの一覧
  • Storage: ストレージドメインの一覧
各リソースタイプには、固有のプロパティーセットと、それが関連付けられたその他のリソースタイプのセットがあります。また、各検索タイプには、一式の有効な構文の組み合わせがあります。オートコンプリート機能を使用すると、正しいクエリーを容易に作成することができます。

E.1.5. 検索条件

クエリーのコロンの後に、検索条件を指定することができます。{criteria} の構文は以下のとおりです。
<prop><operator><value>
または
<obj-type><prop><operator><value>

以下の表には、構文の各要素についての説明をまとめています。

表E.3 検索条件の例

要素説明注記
prop検索対象となるリソースのプロパティー。リソースタイプのプロパティー (obj-type を参照) または tag (カスタムタグ) を指定することも可能。検索対象を特定のプロパティーのオブジェクトに限定 (例: status プロパティーのオブジェクトの検索)Status該当なし
obj-type検索対象となるリソースに関連付けできるリソースタイプデータセンターや仮想マシンなどのシステムオブジェクトUsers該当なし
operator比較演算子
=
!= (not equal)
>
<
>=
<=
該当なしプロパティーによって、値のオプションが異なる
value式の比較対象
文字列
整数
ランキング
日付 (地域設定に応じた形式)
Jones
256
normal
  • 文字列内にワイルドカードを使用することが可能
  • 初期化されていない (空の) 文字列を示すには、"" (一組の二重引用符。間にはスペースなし) を使用することが可能
  • 空白を含む文字列や日付は、二重引用符で囲む

E.1.6. 検索: 複数の基準とワイルドカード

ワイルドカードは、文字列の構文の <value> の部分に使用することができます。たとえば、m で始まる全ユーザーを検索するには、m* と入力します。
ANDOR などのブール演算子を使うと、2 つの基準で検索を行うことができます。例:
Vms: users.name = m* AND status = Up
上記のクエリーは、ユーザー名が "m" で始まるユーザーの実行中の仮想マシンをすべて返します。
Vms: users.name = m* AND tag = "paris-loc"
上記のクエリーは、ユーザー名が "m" で始まるユーザーの "paris-loc" とタグ付けされた仮想マシンをすべて返します。
AND または OR を使わずに 2 つの基準を指定すると、AND が暗黙的に指定されます。ANDOR より優先され、また 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一覧データセンターの稼働状況
sortby一覧リソースプロパティー別に検索結果を並べ替え
page整数表示する結果のページ番号

Datacenter: type = nfs and status != up

以下の条件に一致するデータセンターの一覧を返します。
  • ストレージタイプが NFS で、ステータスが UP 以外のデータセンター

E.1.9. クラスターの検索

以下の表には、クラスターの全検索オプションをまとめています。

表E.5 クラスターの検索

プロパティー (リソースまたはリソースタイプ)タイプ説明
Datacenter.datacenter-propプロパティータイプによって異なるクラスターに関連付けられたデータセンターのプロパティー
Datacenter文字列クラスターが属するデータセンター
name文字列ネットワーク上でクラスターを識別する一意名
description文字列クラスターの説明
initialized文字列True または False でクラスターのステータスを表示
sortby一覧リソースプロパティー別に検索結果を並べ替え
page整数表示する結果のページ番号

Clusters: initialized = true or name = Default

以下の条件に一致するクラスターの一覧を返します。
  • 初期化されたクラスター
  • Default と名前の付いたクラスター

E.1.10. ホストの検索

以下の表には、ホストの全検索オプションをまとめています。

表E.6 ホストの検索

プロパティー (リソースまたはリソースタイプ)タイプ説明
Vms.Vms-propプロパティータイプによって異なるホストに関連付けられた仮想マシンのプロパティー
Templates.templates-propプロパティータイプによって異なるホストに関連付けられたテンプレートのプロパティー
Events.events-propプロパティータイプによって異なるホストに関連付けられたイベントのプロパティー
Users.users-propプロパティータイプによって異なるホストに関連付けられたユーザーのプロパティー
name文字列ホスト名
status一覧ホストの稼働状況
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一覧リソースプロパティー別に検索結果を並べ替え
page整数表示する結果のページ番号

Hosts: cluster = Default and Vms.os = rhel6

以下の条件に一致するホストの一覧を返します。
  • Default のクラスターに属し、Red Hat Enterprise Linux 6 オペレーティングシステムを実行する仮想マシンをホストしている

E.1.11. ネットワークの検索

以下の表には、ネットワークの全検索オプションをまとめています。

表E.7 ネットワークの検索

プロパティー (リソースまたはリソースタイプ)タイプ説明
Cluster_network.clusternetwork-propプロパティータイプによって異なるネットワークに関連付けられたクラスターのプロパティー
Host_Network.hostnetwork-propプロパティータイプによって異なるネットワークに関連付けられたホストのプロパティー
name文字列ネットワークを識別する、人間が判読可能な名前
description文字列ネットワークを説明するキーワードまたはテキスト。ネットワークの作成時にオプションで使用することができます。
vlanid整数ネットワークの VLAN ID
stp文字列そのネットワークで Spanning Tree Protocol (STP) が有効かどうか。
mtu整数論理ネットワークの最大転送単位
vmnetwork文字列そのネットワークを仮想マシントラフィック専用に使用するかどうか。
datacenter文字列ネットワークがアタッチされたデータセンター
sortby一覧リソースプロパティー別に検索結果を並べ替え
page整数表示する結果のページ番号

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一覧リソースプロパティー別に検索結果を並べ替え
page整数表示する結果のページ番号

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文字列ディスクがブート可能であるかどうか。有効な値は 01yesno のいずれかです。
shareable文字列ディスクを複数の仮想マシンに同時にアタッチできるかどうか。有効な値は 01yesno のいずれかです。
format文字列ディスクの形式。unusedunassignedcowraw のいずれかです。
status文字列ディスクのステータス。unassignedoklockedinvalidillegal のいずれかです。
disk_type文字列ディスクのタイプ。image または lun のいずれかです。
number_of_vms整数ディスクがアタッチされている仮想マシンの数
vm_names文字列ディスクがアタッチされている仮想マシンの名前
quota文字列仮想ディスクに有効化されているクォータの名前
sortby一覧リソースプロパティー別に検索結果を並べ替え
page整数表示する結果のページ番号

Disks: format = cow and provisioned_size > 8

この例は、以下の条件に一致する仮想ディスクの一覧を返します。
  • QCOW (別称: シンプロビジョニング) 形式
  • 割り当てられたディスクサイズが 8 GB 以上

E.1.14. ボリュームの検索

以下の表には、ボリュームの全検索オプションをまとめています。

表E.10 ボリュームの検索

プロパティー (リソースまたはリソースタイプ)タイプ説明
Cluster.cluster-propプロパティーのタイプによって異なるボリュームに関連付けられたクラスターのプロパティー
Cluster文字列ボリュームに関連付けられたクラスターの名前
name文字列ボリュームを識別する、人間が判読可能な名前
type文字列distribute、replicate、distributed_replicate、stripe、distributed_stripe のいずれかを指定することができます。
transport_type整数TCP または RDMA のいずれかを指定することができます。
replica_count整数レプリカの数
stripe_count整数ストライプの数
status文字列ボリュームのステータス。Up または Down のいずれか。
sortby一覧リソースプロパティー別に検索結果を並べ替え
page整数表示する結果のページ番号

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.vnic-propプロパティータイプによって異なる仮想マシンに関連付けられた仮想 NIC のプロパティー
name文字列仮想マシンの名前
status一覧仮想マシンの稼働状況
ip整数仮想マシンの IP アドレス
uptime整数仮想マシンの実行時間 (分単位)
domain文字列これらのマシンをグループ化するドメイン (通常は、Active Directory ドメイン)
os文字列仮想マシンの作成時に選択したオペレーティングシステム
creationdate日付仮想マシンの作成日
address文字列ネットワーク上で仮想マシンを識別する一意名
cpu_usage整数処理能力の使用率
mem_usage整数メモリー使用率
network_usage整数ネットワーク使用率
memory整数定義済みの最大メモリー
apps文字列仮想マシンに現在インストールされているアプリケーション
cluster一覧仮想マシンが属するクラスター
pool一覧仮想マシンが属する仮想マシンプール
loggedinuser文字列仮想マシンに現在ログインしているユーザーの名前
tag一覧仮想マシンが属するタグ
datacenter文字列仮想マシンが属するデータセンター
type一覧仮想マシンのタイプ (サーバーまたはデスクトップ)
quota文字列仮想マシンに関連付けられたクォータの名前
description文字列仮想マシンを説明するキーワードまたはテキスト。仮想マシンの作成時にオプションで使用することができます。
sortby一覧リソースプロパティー別に検索結果を並べ替え
page整数表示する結果のページ番号

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

この例は、以下の条件に一致する仮想マシンの一覧を返します。
  • ベーステンプレート名が Win で始まり、いずれかのユーザーに割り当てられている仮想マシン

Vms: cluster = Default and os = windows7

この例は、以下の条件に一致する仮想マシンの一覧を返します。
  • 属するクラスター名が Default で、Windows 7 オペレーティングシステムを実行している仮想マシン

E.1.16. プールの検索

以下の表には、プールの全検索オプションをまとめています。

表E.12 プールの検索

プロパティー (リソースまたはリソースタイプ)タイプ説明
name文字列プールの名前
description文字列プールの説明
type一覧プールのタイプ
sortby一覧リソースプロパティー別に検索結果を並べ替え
page整数表示する結果のページ番号

Pools: type = automatic

以下の条件に一致するプールの一覧を返します。
  • タイプが 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一覧リソースプロパティー別に検索結果を並べ替え
page整数表示する結果のページ番号

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

以下の条件に一致するテンプレートの一覧を返します。
  • テンプレートを使用して作成した仮想マシンで、重大度が normal 以上のイベントが発生し、その仮想マシンがまだ実行中である

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一覧リソースプロパティー別に検索結果を並べ替え
page整数表示する結果のページ番号

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一覧イベントのタイプ
severity一覧イベントの重大度: Warning/Error/Normal
message文字列イベントタイプの説明
time一覧イベントの発生日
usrname文字列イベントに関連付けられたユーザー名
event_host文字列イベントに関連付けられたホスト
event_vm文字列イベントに関連付けられた仮想マシン
event_template文字列イベントに関連付けられたテンプレート
event_storage文字列イベントに関連付けられたストレージ
event_datacenter文字列イベントに関連付けられたデータセンター
event_volume文字列イベントに関連付けられたボリューム
correlation_id整数イベントの識別番号
sortby一覧リソースプロパティー別に検索結果を並べ替え
page整数表示する結果のページ番号

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

以下の条件に一致するイベントの一覧を返します。
  • gonzo.example.com というホストで実行していた testdesktop という名前の仮想マシンで発生したイベント