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. 検索構文および例
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 オートコンプリートを使用した検索クエリーの例
入力 | 表示される一覧項目 | アクション |
---|---|---|
h | Hosts (オプションは 1 つのみ) | Hosts を選択もしくは
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: 仮想マシンの一覧
- 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*
と入力します。
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. データセンターの検索
表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 | 文字列 | ディスクがブート可能であるかどうか。有効な値は 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 | 一覧 | リソースプロパティー別に検索結果を並べ替え |
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
という名前の仮想マシンで発生したイベント