付録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という名前の仮想マシンで発生したイベント

Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.