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 よりも高いすべての Events の一覧を表示します。

E.1.3. 自動完了の検索

管理ポータルは、有効で強力な検索クエリーの作成に役立つ自動補完を提供します。検索クエリーの各部分を入力すると、検索の次の部分を選択するドロップダウンリストが、Search Bar の下に開きます。一覧から選択して、検索の次の部分の入力/選択を続けたり、オプションを無視したりして、手動でクエリーを入力を続けたりできます。
以下の表は、管理ポータルの自動補完がクエリーの構築を助けるする方法の例を示しています。
Hosts: Vms.status = down

表E.2 自動補完を使用した検索クエリーの例

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

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

結果のタイプを使用すると、以下のタイプのリソースを検索できます。
  • Vms、仮想マシンの一覧
  • ホスト の一覧
  • pools: プールの一覧
  • template: テンプレートの一覧
  • event: イベント のリスト。
  • Users、ユーザーのリスト。
  • cluster、クラスターの一覧。
  • datacenter: データセンターの一覧
  • Storage、ストレージドメインのリスト。
各タイプのリソースには、一意のプロパティーセットと、関連付けられたその他のリソースタイプのセットがあるため、各検索タイプには、有効な構文の組み合わせがあります。自動補完機能を使用して、有効なクエリーも簡単に作成できます。

E.1.5. 検索基準

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

以下の表は、構文の部分を示しています。

表E.3 検索基準の例

部分 説明 注記
prop 検索対象リソースのプロパティー。リソース種別のプロパティー( obj-typeを参照)、または タグ(カスタムタグ )にすることもできます。 検索対象を特定のプロパティーを持つオブジェクトに制限します。たとえば、status プロパティーでオブジェクトを検索します。 状態 該当なし
obj-type 検索対象のリソースに関連付けることができるリソースタイプ。 これは、データセンターや仮想マシンなどのシステムオブジェクトです。 Users 該当なし
operator 比較演算子。
=
!= (等しくない)
>
<
>=
<=
該当なし 値オプションは obj-type によって異なります。
その式が何と比較されるか。
String
Integer
ランキング
日付 (Regional Settings に応じた書式設定)
Jones
256
normal
  • ワイルドカードは文字列内で使用できます。
  • "" (間にスペースが入っていない 2 つの引用符のセット) は、初期化されていない (空の) 文字列を表すために使用できます。
  • スペースが含まれる文字列または日付を二重引用符で囲む必要があります

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

ワイルドカードは文字列の構文の <value > 部分で使用できます。たとえば、m で始まるすべてのユーザーを検索するには、m* を入力します。
ブール演算子の AND および OR を使用して、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 よりも大きいすべての Events を時刻でソートして返します (降順)。

E.1.8. データセンターの検索

以下の表は、データセンターのすべての検索オプションを示しています。

表E.4 データセンターの検索

プロパティー (リソースまたはリソースタイプの) タイプ 説明 (参照)
Clusters.clusters-prop プロパティータイプによります。 データセンターに関連付けられたクラスターのプロパティー。
name String データセンターの名前。
description String データセンターの説明
type String データセンターのタイプ。
status リスト データセンターの可用性
sortby リスト 返された結果をリソースプロパティーの 1 つで並べ替えます。
page Integer 表示する結果のページ番号。

Datacenter: type = nfs and status != up

以下の例では、以下が含まれるデータセンターの一覧を返します。
  • NFS のストレージタイプおよび up 以外のステータス

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

以下の表は、クラスターのすべての検索オプションについて説明しています。

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

プロパティー (リソースまたはリソースタイプの) タイプ 説明 (参照)
Datacenter.datacenter-prop プロパティータイプによります。 クラスターに関連付けられたデータセンターのプロパティー。
Datacenter String クラスターが属するデータセンター。
name String ネットワーク上のクラスターを識別する一意の名前。
description String クラスターの説明。
initialized String クラスターのステータスを示す true または False。
sortby リスト 返された結果をリソースプロパティーの 1 つで並べ替えます。
page Integer 表示する結果のページ番号。

Clusters: initialized = true or name = Default

この例では、以下のクラスターの一覧を返します。
  • initialized、または
  • 名前付きのデフォルト

E.1.10. ホストの検索

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

表E.6 ホストの検索

プロパティー (リソースまたはリソースタイプの) タイプ 説明 (参照)
Vms.Vms-prop プロパティータイプによります。 ホストに関連付けられた仮想マシンのプロパティー。
Templates.templates-prop プロパティータイプによります。 ホストに関連付けられたテンプレートのプロパティー。
Events.events-prop プロパティータイプによります。 ホストに関連付けられたイベントのプロパティー。
Users.users-prop プロパティータイプによります。 ホストに関連付けられたユーザーのプロパティー。
name String ホストの名前。
status リスト ホストの可用性。
external_status String 外部システムおよびプラグインによって報告されるホストのヘルスステータス。
cluster String ホストが属するクラスター。
address String ネットワーク上のホストを識別する一意の名前。
cpu_usage Integer 使用される処理能力の割合。
mem_usage Integer 使用されるメモリーの割合。
network_usage Integer ネットワーク使用率の割合。
load Integer 特定のタイムスライスで、プロセッサーごとにラン タイムキューで実行 されるのを待機しているジョブ。
version Integer オペレーティングシステムのバージョン番号。
cpus Integer ホスト上の CPU 数。
memory Integer 使用可能なメモリーの量。
cpu_speed Integer CPU の処理速度。
cpu_model String CPU のタイプ。
active_vms Integer 現在実行中の仮想マシンの数。
migrating_vms Integer 現在移行中の仮想マシンの数。
committed_mem Integer コミットされたメモリーの割合
tag String ホストに割り当てられたタグ。
type String ホストのタイプ。
datacenter String ホストが属するデータセンター。
sortby リスト 返された結果をリソースプロパティーの 1 つで並べ替えます。
page Integer 表示する結果のページ番号。

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 String ネットワークを識別するための人が判読可能な名前。
description String ネットワークを記述するキーワードまたはテキスト。オプションでネットワークの作成時に使用されます。
vlanid Integer ネットワークの VLAN ID。
stp String Spanning Tree Protocol (STP) がネットワークで有効または無効になっているかどうか。
mtu Integer 論理ネットワークの最大伝送単位。
vmnetwork String ネットワークが仮想マシントラフィックのみに使用されているかどうか。
datacenter String ネットワークが接続されているデータセンター。
sortby リスト 返された結果をリソースプロパティーの 1 つで並べ替えます。
page Integer 表示する結果のページ番号。

Network: mtu > 1500 and vmnetwork = true

以下の例では、ネットワークの一覧を返します。
  • 最大伝送単位が 1500 バイトを超える場合
  • これは、仮想マシンのみが使用するように設定されます。

E.1.12. ストレージの検索

以下の表は、ストレージのすべての検索オプションについて説明しています。

表E.8 ストレージの検索

プロパティー (リソースまたはリソースタイプの) タイプ 説明 (参照)
Hosts.hosts-prop プロパティータイプによります。 ストレージに関連付けられたホストのプロパティー。
Clusters.clusters-prop プロパティータイプによります。 ストレージに関連付けられたクラスターのプロパティー。
name String ネットワーク上のストレージを識別する一意の名前。
status String ストレージドメインのステータス。
external_status String 外部システムおよびプラグインによって報告されるストレージドメインのヘルスステータス。
datacenter String ストレージが属するデータセンター。
type String ストレージのタイプ。
size Integer ストレージのサイズ。
used Integer 使用中のストレージの量。
committed Integer コミットされるストレージの量。
sortby リスト 返された結果をリソースプロパティーの 1 つで並べ替えます。
page Integer 表示する結果のページ番号。

Storage: size > 200 or used < 50

以下の例では、以下が含まれるストレージの一覧を返します。
  • 200 GB を超える合計ストレージ容量
  • 50 GB 未満の使用ストレージ領域。

E.1.13. ディスクの検索

以下の表は、ディスクの全検索オプションを示しています。

表E.9 ディスクの検索

プロパティー (リソースまたはリソースタイプの) タイプ 説明 (参照)
Datacenters.datacenters-prop プロパティータイプによります。 ディスクに関連付けられたデータセンターのプロパティー。
Storages.storages-prop プロパティータイプによります。 ディスクに関連付けられたストレージのプロパティー。
alias String ネットワーク上のストレージを識別する人が判読可能な名前。
description String ディスクを記述するキーワードまたはテキスト。オプションでディスクの作成時に使用されます。
provisioned_size Integer ディスクの仮想サイズ
size Integer ディスクのサイズ。
actual_size Integer ディスクに割り当てられる実際のサイズ。
creation_date Integer ディスクが作成された日付。
bootable String ディスクを起動できるかどうか。有効な値は 01yesno のいずれかです。
shareable String ディスクを一度に複数の仮想マシンにアタッチできるかどうか。有効な値は 01yesno のいずれかです。
format String ディスクの形式。unusedunassignedcowraw のいずれかです。
status String ディスクのステータスunassignedoklockedinvalidillegal のいずれかです。
disk_type String ディスクのタイプ。image または lun のいずれか。
number_of_vms Integer ディスクがアタッチされている仮想マシンの数。
vm_names String ディスクがアタッチされている仮想マシンの名前。
quota String 仮想ディスクで強制されるクォータの名前。
sortby リスト 返された結果をリソースプロパティーの 1 つで並べ替えます。
page Integer 表示する結果のページ番号。

Disks: format = cow and provisioned_size > 8

この例では、以下が含まれる仮想ディスクの一覧を返します。
  • QCOW: シンプロビジョニング、フォーマットとしても知られています。
  • 8 GB を超える割り当て済みディスクサイズ。

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

以下の表は、ボリュームのすべての検索オプションについて説明しています。

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

プロパティー (リソースまたはリソースタイプの) タイプ 説明 (参照)
Volume.cluster-prop プロパティータイプによります。 ボリュームに関連付けられたクラスターのプロパティー。
Cluster String ボリュームに関連付けられたクラスターの名前。
name String ボリュームを識別する、人が判読可能な名前。
type String distribute、replicate、distributed_replicate、stripe、または distributed_stripe のいずれか。
transport_type Integer TCP または RDMA のいずれか。
replica_count Integer レプリカの数。
stripe_count Integer ストライプの数。
status String ボリュームのステータスUp または Down のいずれかです。
sortby リスト 返された結果をリソースプロパティーの 1 つで並べ替えます。
page Integer 表示する結果のページ番号。

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 String 仮想マシンの名前。
status リスト 仮想マシンの可用性
ip Integer 仮想マシンの IP アドレス。
uptime Integer 仮想マシンが実行されている期間 (分単位)。
domain String これらのマシンをグループ化するドメイン (通常は Active Directory ドメイン)。
os String 仮想マシンの作成時に選択されたオペレーティングシステム。
creationdate 日付 仮想マシンが作成された日付。
address String ネットワーク上の仮想マシンを識別する一意の名前。
cpu_usage Integer 使用される処理能力の割合。
mem_usage Integer 使用されるメモリーの割合。
network_usage Integer 使用されるネットワークの割合。
memory Integer 定義された最大メモリー。
apps String 仮想マシンに現在インストールされているアプリケーション。
cluster リスト 仮想マシンが属するクラスター。
pool リスト 仮想マシンが属する仮想マシンプール。
loggedinuser String 仮想マシンに現在ログインしているユーザーの名前。
tag リスト 仮想マシンが属するタグ。
datacenter String 仮想マシンが属するデータセンター。
type リスト 仮想マシンタイプ (サーバーまたはデスクトップ)。
quota String 仮想マシンに関連付けられたクォータの名前。
description String 仮想マシンを記述するキーワードまたはテキスト。オプションとして、仮想マシンの作成時に使用されます。
sortby リスト 返された結果をリソースプロパティーの 1 つで並べ替えます。
page Integer 表示する結果のページ番号。
next_run_configuration_exists ブール値 仮想マシンに保留中の設定変更があります。

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

この例では、仮想マシンの一覧を返します。ここでは、以下のようになります。
  • 仮想マシンのベースとなるテンプレートは Win で始まり、仮想マシンが任意のユーザーに割り当てられます。

Vms: cluster = Default and os = windows7

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

E.1.16. プールの検索

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

表E.12 プールの検索

プロパティー (リソースまたはリソースタイプの) タイプ 説明 (参照)
name String プールの名前。
description String プールの説明。
type リスト プールのタイプ。
sortby リスト 返された結果をリソースプロパティーの 1 つで並べ替えます。
page Integer 表示する結果のページ番号。

Pools: type = automatic

この例では、以下が含まれるプールの一覧を返します。
  • 自動のタイプ

E.1.17. テンプレートの検索

以下の表は、テンプレートの全検索オプションを示しています。

表E.13 テンプレートの検索

プロパティー (リソースまたはリソースタイプの) タイプ 説明 (参照)
Vms.Vms-prop String テンプレートに関連付けられた仮想マシンのプロパティー。
Hosts.hosts-prop String テンプレートに関連付けられたホストのプロパティー。
Events.events-prop String テンプレートに関連付けられたイベントのプロパティー。
Users.users-prop String テンプレートに関連付けられたユーザーのプロパティー。
name String テンプレートの名前。
domain String テンプレートのドメイン。
os String オペレーティングシステムのタイプ。
creationdate Integer
テンプレートが作成された日付。
日付の形式は mm/dd/yy です。
childcount Integer テンプレートから作成された仮想マシンの数。
mem Integer 定義されたメモリー。
description String テンプレートの説明。
status String テンプレートのステータス
cluster String テンプレートに関連付けられたクラスター。
datacenter String テンプレートに関連付けられたデータセンター。
quota String テンプレートに関連付けられたクォータ。
sortby リスト 返された結果をリソースプロパティーの 1 つで並べ替えます。
page Integer 表示する結果のページ番号。

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 String ユーザーの名前。
lastname String ユーザーの名字を。
usrname String ユーザーの一意の名前。
department String ユーザーが属する部。
group String ユーザーが属するグループ。
title String ユーザーのタイトル。
status String ユーザーの状態。
role String ユーザーのロール。
tag String ユーザーが属するタグ。
pool String ユーザーが属するプール。
sortby リスト 返された結果をリソースプロパティーの 1 つで並べ替えます。
page Integer 表示する結果のページ番号。

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 String イベントタイプの説明。
time リスト イベントが発生した日。
usrname String イベントに関連付けられたユーザー名。
event_host String イベントに関連付けられたホスト。
event_vm String イベントに関連付けられた仮想マシン。
event_template String イベントに関連付けられたテンプレート。
event_storage String イベントに関連付けられたストレージ。
event_datacenter String イベントに関連付けられたデータセンター。
event_volume String イベントに関連付けられたボリューム。
correlation_id Integer イベントの識別番号。
sortby リスト 返された結果をリソースプロパティーの 1 つで並べ替えます。
page Integer 表示する結果のページ番号。

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

この例では、以下のイベント一覧を返します。
  • イベントは、ホスト gonzo.example.com で実行中の testdesktop という名前の仮想マシンで発生しました。