付録E 検索、ブックマーク、およびタグの使用
E.1. 検索
E.1.1. Red Hat Virtualization での検索
E.1.2. 検索構文と例
構文の例
以下の例は、検索クエリーの使用方法と、Red Hat Virtualization が検索クエリーの構築を支援する方法を理解するのに役立ちます。
例 | 結果 |
---|---|
Hosts: Vms.status = up | 稼働中の仮想マシンを実行しているすべてのホストの一覧を表示します。 |
Vms: domain = qa.company.com | 指定されたドメインで稼働しているすべての仮想マシンの一覧を表示します。 |
Vms: users.name = Mary | ユーザー名が Mary のユーザーに属する全仮想マシンの一覧を表示します。 |
Events: severity > normal sortby time | 重大度が Normal よりも高いすべての Events の一覧を表示します。 |
E.1.3. 自動完了の検索
Hosts: Vms.status = down
入力 | 表示されているリスト項目 | アクション |
---|---|---|
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. 検索基準
例
以下の表は、構文の部分を示しています。
部分 | 説明 | 値 | 例 | 注記 |
---|---|---|---|---|
prop | 検索対象リソースのプロパティー。リソース種別のプロパティー( obj-typeを参照)、または タグ(カスタムタグ )にすることもできます。 | 検索対象を特定のプロパティーを持つオブジェクトに制限します。たとえば、status プロパティーでオブジェクトを検索します。 | 状態 | 該当なし |
obj-type | 検索対象のリソースに関連付けることができるリソースタイプ。 | これは、データセンターや仮想マシンなどのシステムオブジェクトです。 | Users | 該当なし |
operator | 比較演算子。 |
=
!= (等しくない)
>
<
>=
<=
| 該当なし | 値オプションは obj-type によって異なります。 |
値 | その式が何と比較されるか。 |
String
Integer
ランキング
日付 (Regional Settings に応じた書式設定)
|
Jones
256
normal
|
|
E.1.6. 検索: 複数の基準およびワイルドカード
m*
を入力します。
AND
および OR
を使用して、2 つの基準を持つ検索を実行できます。以下に例を示します。
Vms: users.name = m* AND status = Up
Vms: users.name = m* AND tag = "paris-loc"
AND
または OR
を使用せずに 2 つの基準を指定した場合、AND
が暗黙的に指定されます。AND
は OR
よりも優先され、OR
は暗黙の AND
よりも優先されます。
E.1.7. 検索: 検索順序の決定
sortby
を使用して決定できます。並べ替え方向 (昇順は asc
、降順は desc
) を含めることができます。
events: severity > normal sortby time desc
E.1.8. データセンターの検索
プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
---|---|---|
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. クラスターの検索
プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
---|---|---|
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. ホストの検索
プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
---|---|---|
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. ネットワークの検索
プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
---|---|---|
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. ストレージの検索
プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
---|---|---|
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. ディスクの検索
プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
---|---|---|
Datacenters.datacenters-prop | プロパティータイプによります。 | ディスクに関連付けられたデータセンターのプロパティー。 |
Storages.storages-prop | プロパティータイプによります。 | ディスクに関連付けられたストレージのプロパティー。 |
alias | String | ネットワーク上のストレージを識別する人が判読可能な名前。 |
description | String | ディスクを記述するキーワードまたはテキスト。オプションでディスクの作成時に使用されます。 |
provisioned_size | Integer | ディスクの仮想サイズ |
size | Integer | ディスクのサイズ。 |
actual_size | Integer | ディスクに割り当てられる実際のサイズ。 |
creation_date | Integer | ディスクが作成された日付。 |
bootable | String | ディスクを起動できるかどうか。有効な値は 0 、1 、yes 、no のいずれかです。 |
shareable | String | ディスクを一度に複数の仮想マシンにアタッチできるかどうか。有効な値は 0 、1 、yes 、no のいずれかです。 |
format | String | ディスクの形式。unused 、unassigned 、cow 、raw のいずれかです。 |
status | String | ディスクのステータスunassigned 、ok 、locked 、invalid 、illegal のいずれかです。 |
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. ボリュームの検索
プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
---|---|---|
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. 仮想マシンの検索
プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
---|---|---|
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. プールの検索
プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
---|---|---|
name | String | プールの名前。 |
description | String | プールの説明。 |
type | リスト | プールのタイプ。 |
sortby | リスト | 返された結果をリソースプロパティーの 1 つで並べ替えます。 |
page | Integer | 表示する結果のページ番号。 |
例
Pools: type = automatic
- 自動のタイプ
E.1.17. テンプレートの検索
プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
---|---|---|
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. ユーザーの検索
プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
---|---|---|
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. イベントの検索
プロパティー (リソースまたはリソースタイプの) | タイプ | 説明 (参照) |
---|---|---|
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
という名前の仮想マシンで発生しました。