18.5.2. ovirt-log-collector コマンドの構文
ログコレクターコマンドの基本構文は以下の通りです。
ovirt-log-collector[options]
list
[all, clusters, datacenters]
ovirt-log-collector[options]
collect
サポートされる 2 つの操作モードは
list
および collect
です。
list
パラメーターは、Red Hat Virtualization Manager に接続されているホスト、クラスター、またはデータセンターを一覧表示します。リストされたオブジェクトに基づいてログコレクションをフィルターリングできます。collect
パラメーターは、Red Hat Virtualization Manager からのログ収集を実行します。収集されたログは、/tmp/logcollector
ディレクトリー下のアーカイブファイルに配置されます。ovirt-log-collector コマンドは、各ログに特定のファイル名を割り当てます。
別のパラメーターが指定されていない限り、使用可能なホストを、それらが属するデータセンターおよびクラスターと一緒にリストすることがデフォルトのアクションとなります。特定のログを取得するために、ユーザー名とパスワードを入力するように求められます。
ovirt-log-collector コマンドをさらに絞り込むパラメーターが多数あります。
一般的なオプション
--version
- 使用中のコマンドのバージョン番号を表示し、プロンプトに戻る。
-h
,--help
- コマンドの使用情報を表示し、プロンプトに戻ります。
--conf-file=PATH
- ツールが使用する設定ファイルとして PATH を設定します。
--local-tmp=PATH
- ログが保存されるディレクトリーとして PATH を設定します。デフォルトのディレクトリーは
/tmp/logcollector
です。 --ticket-number=TICKET
- SOS レポートに関連付けるチケットまたはケース番号として TICKET を設定します。
--upload=FTP_SERVER
- FTP を使用して、取得されるログの宛先として FTP_SERVER を設定します。Red Hat のサポート担当者からアドバイスがない限り、このオプションは使用しないでください。
--log-file=PATH
- コマンドがログ出力に使用する特定のファイル名として PATH を設定します。
--quiet
- quiet モードを設定し、コンソール出力を最小限に抑えます。デフォルトでは、quiet モードはオフになっています。
-v
,--verbose
- verbose モードを設定し、より多くのコンソール出力を提供します。デフォルトでは、verbose モードはオフになっています。
Red Hat Virtualization Manager のオプション
これらのオプションはログコレクションをフィルターリングし、Red Hat Virtualization Manager の認証の詳細を指定します。
これらのパラメーターを、特定のコマンドと組み合わせることができます。たとえば、ovirt-log-collector --user=admin@internal --cluster ClusterA,ClusterB --hosts "SalesHost"* はユーザーを
admin@internal
として指定し、ログコレクションをクラスター A
および B
の SalesHost
ホストのみに制限します。
--no-hypervisors
- ログコレクションから仮想化ホストを省略します。
--one-hypervisor-per-cluster
- 各クラスターから 1 台のホスト (存在する場合は SPM) のログを収集します。
-u USER
、--user=USER
- ログイン用のユーザー名を設定します。USER は、ユーザー@ドメイン の形式で指定されます。ここで、user はユーザー名で、domain は使用中のディレクトリーサービスドメインです。ユーザーはディレクトリーサービスに存在し、Red Hat Virtualization Manager に認識されている必要があります。
-r FQDN
,--rhevm=FQDN
- ログの収集元となる Red Hat Virtualization Manager サーバーの完全修飾ドメイン名を設定します。FQDN は、Manager の完全修飾ドメイン名に置き換えられます。ログコレクターは、Red Hat Virtualization Manager と同じローカルホストで実行していると想定されています。デフォルト値は
localhost
です。 -c CLUSTER
,--cluster=CLUSTER
- Red Hat Virtualization Manager からのログに加えて、指定された CLUSTER 内の仮想化ホストからログを収集します。含めるクラスターは、クラスター名または一致パターンのコンマ区切りリストで指定する必要があります。
-D DATACENTER
,--data-center=DATACENTER
- Red Hat Virtualization Manager からのログに加えて、指定された DATACENTER の仮想化ホストからログを収集します。含めるデータセンターは、データセンター名または一致パターンのコンマ区切りリストで指定する必要があります。
-H HOSTS_LIST
,--hosts=HOSTS_LIST
- Red Hat Virtualization Manager からのログに加えて、指定された HOSTS_LIST 内の仮想化ホストからログを収集します。含めるホストは、ホスト名、完全修飾ドメイン名、または IP アドレスのコンマ区切りリストで指定する必要があります。一致パターンも有効です。
SSH 設定
--ssh-port=PORT
- 仮想化ホストとの SSH 接続に使用するポートとして PORT を設定します。
-k KEYFILE
,--key-file=KEYFILE
- 仮想化ホストへのアクセスに使用される公開 SSH キーとして KEYFILE を設定します。
--max-connections=MAX_CONNECTIONS
- 仮想化ホストからのログの最大同時 SSH 接続として MAX_CONNECTIONS を設定します。デフォルトは
10
です。
PostgreSQL データベースのオプション
データベースユーザー名とデータベース名は、デフォルト値から変更されている場合は、
pg-user
および dbname
パラメーターを使用して指定する必要があります。
データベースがローカルホスト上にない場合は、
pg-dbhost
パラメーターを使用します。オプションの pg-host-key
パラメーターを使用して、リモートログを収集します。リモートログ収集を成功させるには、PostgreSQL SOS プラグインをデータベースサーバーにインストールする必要があります。
--no-postgresql
- データベースのコレクションを無効にします。ログコレクターは Red Hat Virtualization Manager PostgreSQL データベースに接続し、
--no-postgresql
パラメーターが指定されていない限り、データをログレポートに追加します。 --pg-user=USER
- データベースサーバーへの接続に使用するユーザー名として USER を設定します。デフォルトは
postgres
です。 --pg-dbname=DBNAME
- データベースサーバーへの接続に使用するデータベース名として DBNAME を設定します。デフォルトは
rhevm
です。 --pg-dbhost=DBHOST
- データベースサーバーのホスト名として DBHOST を設定します。デフォルトは
localhost
です。 --pg-host-key=KEYFILE
- データベースサーバーの公開 ID ファイル(秘密鍵)として KEYFILE を設定します。この値はデフォルトでは設定されていません。データベースがローカルホストに存在しない場合にのみ必要です。