1.3. 検索
1.3.1. Red Hat Virtualization での検索
管理ポータルでは、仮想マシン、ホスト、ユーザーなど、何千ものリソースを管理することができます。検索を行うには、各リソースのメインページにある検索バーに、検索クエリー (フリーテキストまたは構文ベース) を入力します。検索条件をブックマークとして保存しておけば、検索結果を必要とするたびに検索条件を再入力する必要はありません。検索では大文字小文字の区別はありません。
1.3.2. 検索構文と例
Red Hat Virtualization リソースの検索クエリーの構文は以下のとおりです。
result type: {criteria} [sortby sort_spec]
構文の例
以下の例は、検索クエリーの使用方法と、Red Hat Virtualization が検索クエリーの構築を支援する方法を理解するのに役立ちます。
表1.15 検索クエリーの例
| 例 | 結果 |
|---|---|
| Hosts: Vms.status = up page 2 | 稼働中の仮想マシンを実行しているすべてのホストのリストの 2 ページ目を表示します。 |
| Vms: domain = qa.company.com | 指定されたドメインで稼働しているすべての仮想マシンの一覧を表示します。 |
| Vms: users.name = Mary | ユーザー名が Mary のユーザーに属する全仮想マシンの一覧を表示します。 |
| Events: severity > normal sortby time | 重大度が Normal よりも高いすべての Events の一覧を表示します。 |
1.3.3. 自動完了の検索
管理ポータルは、有効で強力な検索クエリーの作成に役立つ自動補完を提供します。検索クエリーの各部分を入力すると、検索の次の部分を選択するドロップダウンリストが、Search Bar の下に開きます。一覧から選択して検索の次の部分を入力/選択するか、オプションを無視して手動でクエリーを入力できます。
以下の表では、管理ポータルでクエリーを構築する際に自動補完がどのように機能するか、例を挙げて説明しています。
Hosts: Vms.status = down
表1.16 自動補完を使用した検索クエリーの例
| 入力 | 表示されるリスト項目 | アクション |
|---|---|---|
| h |
|
|
| Hosts: | すべてのホストプロパティー | v を入力 |
| Hosts: v |
|
|
| Hosts: Vms | すべての仮想マシンプロパティー | s を入力 |
| Hosts: Vms.s |
|
|
| Hosts: Vms.status |
| = を選択/入力 |
| Hosts: Vms.status = | すべてのステータス値 | down を選択/入力 |
1.3.4. 検索結果タイプのオプション
結果タイプを使用すると、以下のタイプのリソースを検索できます。
- Vms、仮想マシンのリスト。
- Host、ホストのリスト。
- Pools、プールのリスト。
- Template、テンプレートのリスト。
- Events、イベントのリスト。
- Users、ユーザーのリスト。
- Cluster、クラスターのリスト。
- DataCenter、データセンターのリスト。
- Storage、ストレージドメインのリスト。
各タイプのリソースには、一意のプロパティーセットと、関連付けられたその他のリソースタイプのセットがあるため、各検索タイプには、有効な構文の組み合わせがあります。自動補完機能を使用すると、有効なクエリーも簡単に作成できます。
1.3.5. 検索基準
クエリーのコロンの後に検索条件を指定できます。{criteria} の構文は以下のようになります。
<prop><operator><value>
または
<obj-type><prop><operator><value>
例
以下の表は、構文の部分を示しています。
表1.17 検索基準の例
| 部分 | 説明 | 値 | 例 | 注記 |
|---|---|---|---|---|
| prop |
検索対象リソースのプロパティー。リソースタイプのプロパティー ( | 検索対象を、特定のプロパティーを持つオブジェクトに制限します。たとえば、status プロパティーでオブジェクトを検索します。 | Status | 該当なし |
| obj-type | 検索対象のリソースに関連付けることができるリソースタイプ。 | データセンターや仮想マシンなどのシステムオブジェクトです。 | Users | 該当なし |
| operator | 比較演算子。 | = != (等しくない) > < >= <= | 該当なし | 値オプションはプロパティーによって異なります。 |
| Value | その式が何と比較されるか。 | 文字列 Integer Ranking Date (Regional Settings に応じた書式設定) | Jones 256 normal |
|
1.3.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 が暗黙的に指定されます。AND は OR よりも優先され、OR は暗黙の AND よりも優先されます。
1.3.7. 検索: 検索順序の決定
返される情報の並び替え順序は、sortby を使用して決定できます。並べ替え方向 (昇順は asc、降順は desc) を含めることができます。
以下に例を示します。
events: severity > normal sortby time desc
このクエリーは、重大度が Normal よりも大きいすべての Events を時刻でソートして返します (降順)。
1.3.8. データセンターの検索
以下の表は、データセンターのすべての検索オプションを示しています。
表1.18 データセンターの検索
| プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
|---|---|---|
|
| プロパティータイプによります。 | データセンターに関連付けられたクラスターのプロパティー。 |
|
| 文字列 | データセンターの名前。 |
|
| 文字列 | データセンターの説明。 |
|
| 文字列 | データセンターのタイプ。 |
|
| List | データセンターの可用性。 |
|
| List | 返された結果をリソースプロパティーの 1 つで並べ替えます。 |
|
| Integer | 表示する結果のページ番号。 |
例
datacenter: type = nfs and status != up
この例では、ストレージタイプが NFS で、ステータスが up 以外のデータセンターの一覧を返します。
1.3.9. クラスターの検索
以下の表は、クラスターのすべての検索オプションについて説明しています。
表1.19 クラスターの検索
| プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
|---|---|---|
|
| プロパティータイプによります。 | クラスターに関連付けられたデータセンターのプロパティー。 |
|
| 文字列 | クラスターが属するデータセンター。 |
|
| 文字列 | ネットワーク上のクラスターを識別する一意の名前。 |
|
| 文字列 | クラスターの説明。 |
|
| 文字列 | クラスターのステータスを示す true または False。 |
|
| List | 返された結果をリソースプロパティーの 1 つで並べ替えます。 |
|
| Integer | 表示する結果のページ番号。 |
例
Clusters: initialized = true or name = Default
この例では、初期化されたクラスターまたは Default という名前のクラスターの一覧を返します。
1.3.10. ホストの検索
以下の表は、ホストの全検索オプションを示しています。
表1.20 ホストの検索
| プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
|---|---|---|
|
| プロパティータイプによります。 | ホストに関連付けられた仮想マシンのプロパティー。 |
|
| プロパティータイプによります。 | ホストに関連付けられたテンプレートのプロパティー。 |
|
| プロパティータイプによります。 | ホストに関連付けられたイベントのプロパティー。 |
|
| プロパティータイプによります。 | ホストに関連付けられたユーザーのプロパティー。 |
|
| 文字列 | ホストの名前。 |
|
| List | ホストの可用性。 |
|
| 文字列 | 外部システムおよびプラグインによって報告されるホストのヘルスステータス。 |
|
| 文字列 | ホストが属するクラスター。 |
|
| 文字列 | ネットワーク上のホストを識別する一意の名前。 |
|
| Integer | 使用される処理能力の割合。 |
|
| Integer | 使用されるメモリーの割合。 |
|
| Integer | ネットワーク使用率の割合。 |
|
| Integer | 特定のタイムスライスで、プロセッサーごとに run-queue で実行されるのを待っているジョブ。 |
|
| Integer | オペレーティングシステムのバージョン番号。 |
|
| Integer | ホスト上の CPU 数。 |
|
| Integer | 使用可能なメモリーの量。 |
|
| Integer | CPU の処理速度。 |
|
| 文字列 | CPU のタイプ。 |
|
| Integer | 現在実行中の仮想マシンの数。 |
|
| Integer | 現在移行中の仮想マシンの数。 |
|
| Integer | コミットされたメモリーの割合 |
|
| 文字列 | ホストに割り当てられたタグ。 |
|
| 文字列 | ホストのタイプ。 |
|
| 文字列 | ホストが属するデータセンター。 |
|
| List | 返された結果をリソースプロパティーの 1 つで並べ替えます。 |
|
| Integer | 表示する結果のページ番号。 |
例
Hosts: cluster = Default and Vms.os = rhel6
この例では、Default クラスターの一部であるホストの一覧と、Red Hat Enterprise Linux 6 オペレーティングシステムを実行するホスト仮想マシンを返します。
1.3.11. ネットワークの検索
以下の表は、ネットワークの全検索オプションを説明しています。
表1.21 ネットワークの検索
| プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
|---|---|---|
|
| プロパティータイプによります。 | ネットワークに関連付けられたクラスターのプロパティー。 |
|
| プロパティータイプによります。 | ネットワークに関連付けられたホストのプロパティー。 |
|
| 文字列 | ネットワークを識別するための人が判読可能な名前。 |
|
| 文字列 | ネットワークを記述するキーワードまたはテキスト。オプションでネットワークの作成時に使用されます。 |
|
| Integer | ネットワークの VLAN ID。 |
|
| 文字列 | Spanning Tree Protocol (STP) がネットワークで有効か無効かを示します。 |
|
| Integer | 論理ネットワークの最大伝送単位。 |
|
| 文字列 | ネットワークが仮想マシントラフィックのみに使用されているかどうか。 |
|
| 文字列 | ネットワークが接続されているデータセンター。 |
|
| List | 返された結果をリソースプロパティーの 1 つで並べ替えます。 |
|
| Integer | 表示する結果のページ番号。 |
例
Network: mtu > 1500 and vmnetwork = true
この例では、最大転送単位が 1500 バイトを超え、仮想マシンのみが使用するように設定されているネットワークの一覧を返します。
1.3.12. ストレージの検索
以下の表は、ストレージのすべての検索オプションについて説明しています。
表1.22 ストレージの検索
| プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
|---|---|---|
|
| プロパティータイプによります。 | ストレージに関連付けられたホストのプロパティー。 |
|
| プロパティータイプによります。 | ストレージに関連付けられたクラスターのプロパティー。 |
|
| 文字列 | ネットワーク上のストレージを識別する一意の名前。 |
|
| 文字列 | ストレージドメインのステータス。 |
|
| 文字列 | 外部システムおよびプラグインによって報告されるストレージドメインのヘルスステータス。 |
|
| 文字列 | ストレージが属するデータセンター。 |
|
| 文字列 | ストレージのタイプ。 |
|
| Integer | 空きストレージのサイズ (GB)。 |
|
| Integer | 使用されるストレージの容量 (GB)。 |
|
| Integer | 利用可能なストレージの合計量 (GB)。 |
|
| Integer | コミットされたストレージの量 (GB)。 |
|
| List | 返された結果をリソースプロパティーの 1 つで並べ替えます。 |
|
| Integer | 表示する結果のページ番号。 |
例
Storage: free_size > 6 GB and total_size < 20 GB
この例では、空き領域が 6 GB を超えるストレージの一覧または、合計ストレージ容量が 20 GB 未満のストレージの一覧を返します。
1.3.13. ディスクの検索
以下の表は、ディスクの全検索オプションを示しています。
Disk Type および Content Type フィルターオプションを使用して、表示される仮想ディスクの数を減らすことができます。
表1.23 ディスクの検索
| プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
|---|---|---|
|
| プロパティータイプによります。 | ディスクに関連付けられたデータセンターのプロパティー。 |
|
| プロパティータイプによります。 | ディスクに関連付けられたストレージのプロパティー。 |
|
| 文字列 | ネットワーク上のストレージを識別する人が判読可能な名前。 |
|
| 文字列 | ディスクを記述するキーワードまたはテキスト。オプションでディスクの作成時に使用されます。 |
|
| Integer | ディスクの仮想サイズ |
|
| Integer | ディスクのサイズ。 |
|
| Integer | ディスクに割り当てられる実際のサイズ。 |
|
| Integer | ディスクが作成された日付。 |
|
| 文字列 |
ディスクを起動できるかどうか。有効な値は |
|
| 文字列 |
ディスクを一度に複数の仮想マシンにアタッチできるかどうか。有効な値は |
|
| 文字列 |
ディスクの形式。 |
|
| 文字列 |
ディスクのステータス |
|
| 文字列 |
ディスクのタイプ。 |
|
| Integer | ディスクがアタッチされている仮想マシンの数。 |
|
| 文字列 | ディスクがアタッチされている仮想マシンの名前。 |
|
| 文字列 | 仮想ディスクで強制されるクォータの名前。 |
|
| List | 返された結果をリソースプロパティーの 1 つで並べ替えます。 |
|
| Integer | 表示する結果のページ番号。 |
例
Disks: format = cow and provisioned_size > 8
この例では、QCOW 形式の仮想ディスクの一覧と、8 GB を超える割り当て済みのディスクサイズを返します。
1.3.14. ボリュームの検索
以下の表は、ボリュームのすべての検索オプションについて説明しています。
表1.24 ボリュームの検索
| プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
|---|---|---|
|
| 文字列 | ボリュームに関連付けられたクラスターの名前。 |
|
| プロパティータイプ (例: name、description、comment、architecture) による | ボリュームに関連付けられたクラスターのプロパティー。 |
|
| 文字列 | ボリュームを識別する、人が判読可能な名前。 |
|
| 文字列 | distribute、replicate、distributed_replicate、stripe、または distributed_stripe のいずれか。 |
|
| Integer | TCP または RDMA のいずれか。 |
|
| Integer | レプリカの数。 |
|
| Integer | ストライプの数。 |
|
| 文字列 | ボリュームのステータス。Up または Down のいずれかです。 |
|
| List | 返された結果をリソースプロパティーの 1 つで並べ替えます。 |
|
| Integer | 表示する結果のページ番号。 |
例
Volume: transport_type = rdma and stripe_count >= 2
この例では、トランスポートタイプが RDMA に設定され、ストライプが 2 つ以上あるボリュームのリストを返します。
1.3.15. 仮想マシンの検索
以下の表は、仮想マシンのすべての検索オプションについて説明しています。
現時点で、Network Label、Custom Emulated Machine、および Custom CPU Type プロパティーはサポートされていない検索プロパティーです。
表1.25 仮想マシンの検索
| プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
|---|---|---|
|
| プロパティータイプによります。 | 仮想マシンに関連付けられたホストのプロパティー。 |
|
| プロパティータイプによります。 | 仮想マシンに関連付けられたテンプレートのプロパティー。 |
|
| プロパティータイプによります。 | 仮想マシンに関連付けられたイベントのプロパティー。 |
|
| プロパティータイプによります。 | 仮想マシンに関連付けられたユーザーのプロパティー。 |
|
| プロパティータイプによります。 | 仮想マシンに関連付けられたストレージデバイスのプロパティー。 |
|
| プロパティータイプによります。 | 仮想マシンに関連付けられた vNIC のプロパティー。 |
|
| 文字列 | 仮想マシンの名前。 |
|
| List | 仮想マシンの可用性 |
|
| Integer | 仮想マシンの IP アドレス。 |
|
| Integer | 仮想マシンが実行されている期間 (分単位)。 |
|
| 文字列 | マシンをグループ化するドメイン (通常は Active Directory ドメイン)。 |
|
| 文字列 | 仮想マシンの作成時に選択されたオペレーティングシステム。 |
|
| Date | 仮想マシンが作成された日付。 |
|
| 文字列 | ネットワーク上の仮想マシンを識別する一意の名前。 |
|
| Integer | 使用される処理能力の割合。 |
|
| Integer | 使用されるメモリーの割合。 |
|
| Integer | 使用されるネットワークの割合。 |
|
| Integer | 定義された最大メモリー。 |
|
| 文字列 | 仮想マシンに現在インストールされているアプリケーション。 |
|
| List | 仮想マシンが属するクラスター。 |
|
| List | 仮想マシンが属する仮想マシンプール。 |
|
| 文字列 | 仮想マシンに現在ログインしているユーザーの名前。 |
|
| List | 仮想マシンが属するタグ。 |
|
| 文字列 | 仮想マシンが属するデータセンター。 |
|
| List | 仮想マシンタイプ (サーバーまたはデスクトップ)。 |
|
| 文字列 | 仮想マシンに関連付けられたクォータの名前。 |
|
| 文字列 | 仮想マシンを記述するキーワードまたはテキスト。オプションとして、仮想マシンの作成時に使用されます。 |
|
| List | 返された結果をリソースプロパティーの 1 つで並べ替えます。 |
|
| Integer | 表示する結果のページ番号。 |
|
| Boolean | 仮想マシンに保留中の設定変更があります。 |
例
Vms: template.name = Win* and user.name = ""
この例では、ベーステンプレート名が Win で始まり、任意のユーザーに割り当てられている仮想マシンの一覧を返します。
例
Vms: cluster = Default and os = windows7
この例では、Default クラスターに属し、Windows 7 を実行している仮想マシンの一覧を返します。
1.3.16. プールの検索
以下の表は、プールの全検索オプションを示しています。
表1.26 プールの検索
| プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
|---|---|---|
|
| 文字列 | プールの名前。 |
|
| 文字列 | プールの説明。 |
|
| List | プールのタイプ。 |
|
| List | 返された結果をリソースプロパティーの 1 つで並べ替えます。 |
|
| Integer | 表示する結果のページ番号。 |
例
Pools: type = automatic
この例では、タイプが automatic のプールの一覧を返します。
1.3.17. テンプレートの検索
以下の表は、テンプレートの全検索オプションを示しています。
表1.27 テンプレートの検索
| プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
|---|---|---|
|
| 文字列 | テンプレートに関連付けられた仮想マシンのプロパティー。 |
|
| 文字列 | テンプレートに関連付けられたホストのプロパティー。 |
|
| 文字列 | テンプレートに関連付けられたイベントのプロパティー。 |
|
| 文字列 | テンプレートに関連付けられたユーザーのプロパティー。 |
|
| 文字列 | テンプレートの名前。 |
|
| 文字列 | テンプレートのドメイン。 |
|
| 文字列 | オペレーティングシステムのタイプ。 |
|
| Integer | テンプレートが作成された日付。 日付の形式は mm/dd/yy です。 |
|
| Integer | テンプレートから作成された仮想マシンの数。 |
|
| Integer | 定義されたメモリー。 |
|
| 文字列 | テンプレートの説明。 |
|
| 文字列 | テンプレートのステータス。 |
|
| 文字列 | テンプレートに関連付けられたクラスター。 |
|
| 文字列 | テンプレートに関連付けられたデータセンター。 |
|
| 文字列 | テンプレートに関連付けられたクォータ。 |
|
| List | 返された結果をリソースプロパティーの 1 つで並べ替えます。 |
|
| Integer | 表示する結果のページ番号。 |
例
Template: Events.severity >= normal and Vms.uptime > 0
この例では、テンプレートから派生した仮想マシンで重大度が Normal 以上のイベントが発生し、かつ仮想マシンが引き続き実行されているテンプレートの一覧が返されます。
1.3.18. ユーザーの検索
以下の表は、ユーザーの全検索オプションについて説明しています。
表1.28 ユーザーの検索
| プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
|---|---|---|
|
| プロパティータイプによります。 | ユーザーに関連付けられた仮想マシンのプロパティー。 |
|
| プロパティータイプによります。 | ユーザーに関連付けられたホストのプロパティー。 |
|
| プロパティータイプによります。 | ユーザーに関連付けられたテンプレートのプロパティー。 |
|
| プロパティータイプによります。 | ユーザーに関連するイベントのプロパティー。 |
|
| 文字列 | ユーザーの名前。 |
|
| 文字列 | ユーザーの名字。 |
|
| 文字列 | ユーザーの一意の名前。 |
|
| 文字列 | ユーザーが属する部門。 |
|
| 文字列 | ユーザーが属するグループ。 |
|
| 文字列 | ユーザーのタイトル。 |
|
| 文字列 | ユーザーの状態。 |
|
| 文字列 | ユーザーのロール。 |
|
| 文字列 | ユーザーが属するタグ。 |
|
| 文字列 | ユーザーが属するプール。 |
|
| List | 返された結果をリソースプロパティーの 1 つで並べ替えます。 |
|
| Integer | 表示する結果のページ番号。 |
例
Users: Events.severity > normal and Vms.status = up or Vms.status = pause
この例では、仮想マシンで重大度が Normal よりも高いイベントが発生し、かつ仮想マシンがまだ稼働している場合や、ユーザーの仮想マシンが一時停止している場合のユーザーの一覧を返します。
1.3.19. イベントの検索
以下の表は、イベントの検索に使用できるすべての検索オプションについて説明しています。自動補完は、必要に応じて多くのオプションに対して提供されます。
表1.29 イベントの検索
| プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
|---|---|---|
|
| プロパティータイプによります。 | イベントに関連付けられた仮想マシンのプロパティー。 |
|
| プロパティータイプによります。 | イベントに関連付けられたホストのプロパティー。 |
|
| プロパティータイプによります。 | イベントに関連付けられたテンプレートのプロパティー。 |
|
| プロパティータイプによります。 | イベントに関連付けられたユーザーのプロパティー。 |
|
| プロパティータイプによります。 | イベントに関連付けられたクラスターのプロパティー。 |
|
| プロパティータイプによります。 | イベントに関連付けられたボリュームのプロパティー。 |
|
| List | イベントのタイプ。 |
|
| List | イベントの重大度: Warning/Error/Normal |
|
| 文字列 | イベントタイプの説明。 |
|
| List | イベントが発生した日。 |
|
| 文字列 | イベントに関連付けられたユーザー名。 |
|
| 文字列 | イベントに関連付けられたホスト。 |
|
| 文字列 | イベントに関連付けられた仮想マシン。 |
|
| 文字列 | イベントに関連付けられたテンプレート。 |
|
| 文字列 | イベントに関連付けられたストレージ。 |
|
| 文字列 | イベントに関連付けられたデータセンター。 |
|
| 文字列 | イベントに関連付けられたボリューム。 |
|
| Integer | イベントの識別番号。 |
|
| List | 返された結果をリソースプロパティーの 1 つで並べ替えます。 |
|
| Integer | 表示する結果のページ番号。 |
例
Events: Vms.name = testdesktop and Hosts.name = gonzo.example.com
この例では、ホスト gonzo.example.com で実行中の testdesktop という名前の仮想マシンで発生したイベントの一覧を返します。
