Red Hat Summit18.4. ログ収集ツール
18.4.1. ログコレクター
Red Hat Virtualization Manager には、ログ収集ツールが含まれています。これにより、サポートをリクエストする際には、Red Hat Virtualization 環境全体にわたる関連ログを簡単に収集することができます。
ログ収集のコマンドは、ovirt-log-collector です。root ユーザーとしてログインして、コマンドライン上で Red Hat Virtualization 環境の管理者の認証情報を入力する必要があります。ovirt-log-collector -h コマンドを実行すると、ovirt-log-collector コマンドの有効なオプションの全一覧など、使用方法に関する詳しい説明を表示することができます。
18.4.2. ovirt-log-collector コマンドの構文
ログコレクターコマンドの基本構文は以下の形式です。
ovirt-log-collector options list all|clusters|datacenters ovirt-log-collector options collect
# ovirt-log-collector options list all|clusters|datacenters
# ovirt-log-collector options collect
list および collect の 2 つの操作モードに対応しています。
-
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- 詳細モードに設定し、より詳しいコンソール出力を提供します。詳細モードは、デフォルトではオフになっています。
--time-only- 完全な SOS レポートを生成せずに、ホスト間の時間差に関する情報だけを表示します。
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 の形式で指定します。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-
データベースの収集を無効にします。
--no-postgresqlパラメーターが指定されていない場合には、ログコレクターが Red Hat Virtualization Manager PostgreSQL データベースに接続して、ログレポートにデータを追加します。 --pg-user=USER- データベースサーバーへの接続に使用するユーザー名を USER で指定します。デフォルトは postgres です。
--pg-dbname=DBNAME- データベースサーバーとの接続に使用するデータベース名を DBNAME で指定します。デフォルトは rhevm です。
--pg-dbhost=DBHOST- データベースサーバーのホスト名を DBHOST で指定します。デフォルトは localhost です。
--pg-host-key=KEYFILE- データベースサーバーの公開 ID ファイル (秘密鍵) を KEYFILE で指定します。この値は、ローカルホスト上にデータベースが存在しない場合にのみ必要なため、デフォルトでは設定されていません。
18.4.3. ログコレクターの基本的な使用例
追加のパラメーターを指定せずに ovirt-log-collector コマンドを実行した場合には、デフォルトの動作は、Red Hat Virtualization Manager および Manager にアタッチされたホストからのログをすべて収集します。また、--no-postgresql パラメーターが指定されていない限り、データベースのログも収集します。以下の例では、ログコレクターのコマンドを実行して、Red Hat Virtualization Manager とアタッチされたホスト 3 台からのログをすべて収集します。
例18.2 ログコレクターの使用例
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}