機械翻訳について

モニタリングと診断

次の項では、仮想化環境のGrafanaダッシュボードおよびイベント通知の設定方法と使用方法、およびパフォーマンス・コパイロット・メトリックについて説明します。

イベント通知の使用

次のセクションでは、仮想化環境のイベントを監視するイベント通知の設定方法について説明します。 特定のイベントが発生したときにイベント通知を電子メールで送信し、指定のユーザーにアラートを通知するようにManagerを構成するか、簡易ネットワーク管理プロトコル(SNMP)トラップを有効にして仮想化環境を監視できます。

詳細は、「Oracle Linux Virtualization Manager: アーキテクチャおよびプランニング・ガイド」のイベント・ロギングおよび通知を参照してください。

エンジンに対するイベント通知サービスの構成

イベント通知を電子メール受信者に正しく送信するには、エンジンのメール・サーバーを構成し、ovirt-engine-notifierサービスを有効にする必要があります。 管理ポータルでのイベント通知の作成の詳細は、「管理ポータルでのイベント通知の作成」を参照してください。

エンジンの通知サービスを構成するには:

  1. Managerを実行しているホストにログインします。

  2. ovirt-engine-notifier.confを90-email-notify.confという名前の新しいファイルにコピーします。 

    # cp /usr/share/ovirt-engine/services/ovirt-engine-notifier/ovirt-engine-notifier.conf/ \
etc/ovirt-engine/notifier/notifier.conf.d/90-email-notify.conf
  3. 90-email-notify.confファイルを編集するには、EMAIL Notificationsセクションを除くすべてを削除します。

    ノート:

    仮想化環境でSNMPトラップも構成する予定の場合は、ovirt-notifier.confファイルのSNMP_TRAP Notificationsセクションから20-snmp.confという名前のファイルに値をコピーすることもできます。 詳細は、「SNMPトラップを送信するエンジンの構成」を参照してください。

  4. 正しい電子メール変数を入力します。 このファイルは、元のovirt-engine-notifier.confファイルの値をオーバーライドします。 
    ---------------------
# EMAIL Notifications #
---------------------

# The SMTP mail server address. Required.
MAIL_SERVER=myemailserver.mycompany.com

# The SMTP port (usually 25 for plain SMTP, 465 for SMTP with SSL, 587 for SMTP with TLS)
MAIL_PORT=25

# Required if SSL or TLS enabled to authenticate the user. Used also to specify 'from' 
  user address if mail server
# supports, when MAIL_FROM is not set. Address is in RFC822 format
MAIL_USER=email.example.com

# Required to authenticate the user if mail server requires authentication or if SSL or 
  TLS is enabled
SENSITIVE_KEYS="${SENSITIVE_KEYS},MAIL_PASSWORD"
MAIL_PASSWORD=

# Indicates type of encryption (none, ssl or tls) should be used to communicate with 
  mail server.
MAIL_SMTP_ENCRYPTION=none

# If set to true, sends a message in HTML format.
HTML_MESSAGE_FORMAT=false

# Specifies 'from' address on sent mail in RFC822 format, if supported by mail server.
MAIL_FROM=myovirtengine@mycompany.com

# Specifies 'reply-to' address on sent mail in RFC822 format.
MAIL_REPLY_TO=myusername@mycompany.com

# Interval to send smtp messages per # of IDLE_INTERVAL
MAIL_SEND_INTERVAL=1

# Amount of times to attempt sending an email before failing.
MAIL_RETRIES=4

    ノート:

    ovirt-engine-notifier.confファイル内のイベント通知に使用できるその他のパラメータの詳細は、「oVirtドキュメント」を参照してください。

  5. ovirt-engine-notifierサービスを有効化して再起動し、変更内容をアクティブ化します。 

    # systemctl daemon-reload
# systemctl enable ovirt-engine-notifier.service
# systemctl restart ovirt-engine-notifier.service

管理ポータルでのイベント通知の作成

イベント通知を作成する前に、着信自動メッセージを処理してこれらのメッセージを配信リストに配信できる電子メール・サーバーにアクセスできる必要があります。 また、エンジンでイベント通知サービスを構成する必要もあります。 詳細は、「エンジンに対するイベント通知サービスの構成」を参照してください

管理ポータルでイベント通知を作成するには:

  1. 「管理」に移動して「ユーザー」をクリックします。

    「ユーザー」ペインが開きます。

  2. 「ユーザー名」列で、ユーザーの名前をクリックして、ユーザーの詳細ビューを表示します。

    ノート:

    ユーザーは、作成されて適切な権限が割り当てられるまで、管理ポータルに表示されません。 詳細は、「新規ユーザー・アカウントの作成」を参照してください。

  3. イベント通知タブをクリックします。

  4. 「イベントの管理」をクリックします。

    イベント通知の追加ダイアログ・ボックスが開きます。

  5. 通知する個々のイベントまたはイベント・トピック領域の横にあるチェック・ボックスを選択して、通知を作成するイベントを選択します。

    通知に使用可能なイベントは、複数のトピック領域にグループ化されています。 デフォルトでは、最上位レベルのトピック領域(一般ホスト・イベントなど)のチェック・ボックスを選択すると、そのトピック領域のすべてのイベントが選択されます。 オプションで、すべて開くまたはすべて閉じるをクリックして、すべてのイベント・トピック領域を展開または縮小できます。 また、特定の最上位レベルのトピック領域の横にある矢印アイコンをクリックすると、そのトピック領域に関連付けられたイベントを展開または縮小できます。

  6. 「メール受信者」フィールドに、電子メール・アドレスを入力します。

  7. 変更を保存する場合は、「OK」をクリックします。

 管理ポータルでのイベント通知の取消し

管理ポータルでイベント通知を取り消すには:

  1. 「管理」に移動して「ユーザー」をクリックします。

    「ユーザー」ペインが開きます。

  2. 「ユーザー名」列で、ユーザーの名前をクリックして、ユーザーの詳細ビューを表示します。

  3. イベント通知タブをクリックします。

  4. 「イベントの管理」をクリックします。

    イベント通知の追加ダイアログ・ボックスが開きます。

  5. すべて開くをクリックするか、またはトピック固有の展開オプションをクリックしてイベントを表示します。

  6. 該当するチェック・ボックスの選択を解除して、該当するイベントの通知を取り消します。

  7. 「OK」をクリックして変更を保存します。

SNMPトラップを送信するエンジンの構成

SNMPトラップを1つ以上の外部SNMPマネージャに送信するようにManagerを構成できます。 SNMPトラップには、仮想化環境を監視するために使用するシステム・イベント情報が含まれます。 SNMPマネージャに送信されるトラップの数とタイプはエンジン内で定義できます。

このタスクを実行する前に、トラップを受信する1つ以上の外部SNMPマネージャを構成し、次の詳細を確認しておく必要があります。

  • SNMPマネージャとして機能するマシンのIPアドレスまたは完全修飾ドメイン名。 オプションで、SNMPマネージャがトラップ通知を受信するポートを決定します。デフォルトのUDPポートは162です。

  • SNMPコミュニティ。 複数のSNMPマネージャが1つのコミュニティに属することができます。 管理システムおよびエージェントは、同じコミュニティ内にある場合にのみ通信できます。 デフォルトのコミュニティはpublicです。

  • アラートのトラップ・オブジェクト識別子。 エンジンでは、1.3.6.1.4.1.2312.13.1.1のデフォルトOIDが提供されます。 このOIDが定義されると、イベント情報が追加されてすべてのトラップ・タイプがSNMPマネージャに送信されます。

    ノート:

    • デフォルト・トラップを変更すると、生成されたトラップがエンジンの管理情報ベースに準拠しなくなります。

    • エンジンは、/usr/share/doc/ovirt-engine/mibs/OVIRT-MIB.txtおよび/usr/share/doc/ovirt-engine/mibs/REDHAT-MIB.txtの管理情報ベースを提供します。 SNMPマネージャにMIBを読み込んでから続行してください。

エンジンでSNMPトラップを構成するには:

  1. Managerを実行しているホストにログインします。

  2. エンジンで、SNMP構成ファイルを作成します。
    # vi /etc/ovirt-engine/notifier/notifier.conf.d/20-snmp.conf

    デフォルトのSNMP構成値は、次のディレクトリ・パスにあるイベント通知構成ファイル(ovirt-engine-notifier.conf)のエンジンに存在: / usr/share/ovirt-engine/services/ovirt-engine-notifier/ovirt-engine-notifier.conf. このステップで指定する値は、このファイルで提供されるデフォルト値またはサンプル値に基づいています。 構成設定が再起動後も保持されるようにするには、ovirt-engine-notifier.confファイルを編集するのではなく、SNMP構成(20-snmp.conf)のオーバーライド・ファイルを定義します。詳細は、「エンジンでのイベント通知サービスの構成」を参照してください。

  3. SNMPマネージャ、SNMPコミュニティおよびOIDを次の形式で指定します。
    SNMP_MANAGERS="manager1.example.com manager2.example.com:162"
SNMP_COMMUNITY=public
SNMP_OID=1.3.6.1.4.1.2312.13.1.1
    20-snmp.confファイルでは、次の値を構成できます。
    #-------------------------#
# SNMP_TRAP Notifications #
#-------------------------#
# Send v2c snmp notifications

# Minimum SNMP configuration
#
# Create /etc/ovirt-engine/notifier/notifier.conf.d/20-snmp.conf with:
# SNMP_MANAGERS="host"
# FILTER="include:*(snmp:) ${FILTER}"

# Default whitespace separated IPv4/[IPv6]/DNS list with optional port, default is 162.
# SNMP_MANAGERS="manager1.example.com manager2.example.com:164"
SNMP_MANAGERS=

# Default SNMP Community String.
SNMP_COMMUNITY=public

# SNMP Trap Object Identifier for outgoing notifications.
# { iso(1) org(3) dod(6) internet(1) private(4) enterprises(1) redhat(2312) ovirt(13) 
  engine(1) notifier(1) }
#
# Note: changing the default will prevent generated traps from complying with 
  OVIRT-MIB.txt.
SNMP_OID=1.3.6.1.4.1.2312.13.1.1

# Default SNMP Version. SNMP version 2 and version 3 traps are supported
# 2 = SNMPv2
# 3 = SNMPv3
SNMP_VERSION=2

# The engine id used for SNMPv3 traps
SNMP_ENGINE_ID=

# The user name used for SNMPv3 traps
SNMP_USERNAME=

# The SNMPv3 auth protocol. Supported values are MD5 and SHA.
SNMP_AUTH_PROTOCOL=

# The SNMPv3 auth passphrase, used when SNMP_SECURITY_LEVEL is set to AUTH_NOPRIV 
  and AUTH_PRIV
SNMP_AUTH_PASSPHRASE=

# The SNMPv3 privacy protocol. Supported values are AES128, AES192 and AES256.
# Be aware that AES192 and AES256 are not defined in RFC3826, so please verify
# that your SNMP server supports those protocols before enabling them.
SNMP_PRIVACY_PROTOCOL=

# The SNMPv3 privacy passphrase, used when SNMP_SECURITY_LEVEL is set to AUTH_PRIV
SNMP_PRIVACY_PASSPHRASE=

# The SNMPv3 security level.
# 1 = NOAUTH_NOPRIV
# 2 = AUTH_NOPRIV
# 3 = AUTH_PRIV
SNMP_SECURITY_LEVEL=1

# SNMP profile support
#
# Multiple SNMP profiles are supported.
# Specify profile settings by using _profile suffix,
# for example, to define a profile to sent specific
# message to host3, specify:
# SNMP_MANAGERS_profile1=host3
# FILTER="include:VDC_START(snmp:profile1) ${FILTER}"

  4. SNMPマネージャに送信するイベントを定義します。

    デフォルトでは、次のデフォルト・フィルタがovirt-engine-notifier.confファイルに定義されています。このフィルタをオーバーライドしたり、オーバーライド・フィルタを適用しない場合、通知は送信されません。
    FILTER="exclude:\*"
    次に、イベント・フィルタの他の一般的な例を示します。
    • すべてのイベントをデフォルトSNMPプロファイルに送信します。
      FILTER="include:\*(snmp:) ${FILTER}"
    • 重大度がERRORまたはALERTのすべてのイベントをデフォルトのSNMPプロファイルに送信します。
      FILTER="include:\*:ERROR(snmp:) ${FILTER}"
 FILTER="include:\*:ALERT(snmp:) ${FILTER}"

  5. ファイルを保存します。

  6. ovirt-engine-notifierサービスを起動し、このサービスが起動時に起動されることを確認します。
     # systemctl start ovirt-engine-notifier.service
 # systemctl enable ovirt-engine-notifier.service

  7. (オプション)トラップがSNMPマネージャに送信されていることを検証します。

Grafanaの使用

次の項では、仮想化環境でGrafanaダッシュボードを設定および使用する方法について説明します。

重要:

データ・ウェアハウス・データベース、データ・ウェアハウス・サービスおよびGrafanaをすべて同じマシンにインストールする必要があります。ただし、これらの各コンポーネントは別々のマシンにインストールできます。

詳細は、「Oracle Linux Virtualization Manager: アーキテクチャおよびプランニング・ガイド」のGrafanaによるモニタリングを参照してください。

Grafanaの使用方法の詳細は、「Grafanaサイト」を参照してください。

Grafanaのインストール

Grafana統合は、標準エンジンまたは自己ホスト・エンジンのインストールでengine-setupを実行すると、デフォルトで有効化およびインストールされます。 一部のシナリオでは、アップグレードの実行、バックアップのリストア、データ・ウェアハウスの別のマシンへの移行後など、Grafanaを手動でインストールする必要がある場合があります。

Grafanaを手動でインストールするには:

  1. (自己ホスト型エンジンのみ) 環境をグローバル・メンテナンス・モードにします: 

              # hosted-engine --set-maintenance --mode=global

  2. Grafanaをインストールするマシンにログインします。 これは、データ・ウェアハウスが構成されているマシン(通常はエンジン・マシン)と同じマシンである必要があります。

  3. 次のようにengine-setupコマンドを実行して、Grafanaの再構成を開始します: 

    # engine-setup --reconfigure-optional-components

  4. Enterキーを押してYesと応答し、このマシンにGrafanaをインストールします。 

    Configure Grafana on this host (Yes, No) [Yes]:

  5. (自己ホスト型エンジンのみ) グローバル・メンテナンス・モードを無効にします。 

              # hosted-engine --set-maintenance --mode=none

インストール後は、次のいずれかの方法でGrafanaダッシュボードにアクセスできます:

  • https://<engine FQDN or IP address>/ovirt-engine-grafanaに移動します。

  • web管理のようこそページで「モニタリング・ポータル」をクリックします。

詳細は、「Oracle Linux Virtualization Manager: アーキテクチャおよびプランニング・ガイド」のデフォルトのGrafanaダッシュボードを参照してください。

Grafanaを使用したシングル・サインオンのユーザーの構成

engine-setupは、既存のユーザーが管理ポータルからログインできるようにGrafanaを自動的に構成しますが、これらのユーザーをGrafana内に自動的に作成しません。

Grafanaを使用してシングル・サインオンのユーザーを構成するには:

  1. Managerを実行しているホストにログインします。

  2. ユーザー・アカウントを編集して、Eメール・アドレスがまだ定義されていない場合は追加します。次に例を示します:

    # ovirt-aaa-jdbc-tool user edit test1 --attribute=email=jdoe@example.com
updating user test1...
user updated successfully
  3. 既存の管理ユーザー(最初に構成した管理者)を使用してGrafanaにログインします。
  4. 「構成」、「ユーザー」の順にナビゲートし、「招待」を選択します。
  5. ユーザー・アカウントのEメール・アドレスと名前を入力し、ロールを選択します。

  6. 次のいずれかのオプションを使用して、招待を送信します:

    • 「招待メールを送信」を選択し、「送信」をクリックします。 このオプションには、Grafanaマシンで構成された操作可能なローカル・メール・サーバーが必要です。

    • 「保留中の招待」を選択

      • 必要なエントリを検索
      • 「招待状のコピー」を選択
      • このリンクを使用して、ブラウザのアドレス・バーに直接貼り付けるか、別のユーザーに送信してアカウントを作成します。

      ノート:

      「保留中の招待」オプションを使用すると、電子メールは送信されず、電子メール・アドレスは存在する必要はありません。Managerユーザーの電子メール・アドレスとして構成されていれば、有効なアドレスは機能します。

このアカウントでログインするには:

  1. GrafanaにEメール・アドレスが構成されているアカウントを使用して、管理ポータルにログインします。
  2. Monitoring Portalを選択して、Grafanaダッシュボードを開きます。
  3. 「oVirtエンジン認証でサインイン」を選択します。

パフォーマンス・コパイロットの使用

パフォーマンス・コパイロット(PCP)は、すべてのOracle Linux KVMインストールに対してデフォルトで有効になり、パフォーマンスの問題の診断に使用できるOSおよびネットワーク・メトリックが収集されます。これは、サポート・チームが問題を解決するのに役立ちます。 pmloggerサービスによって生成およびアーカイブされたログは、/var/log/pcp/pmlogger/<hostname>ディレクトリに格納され、sosreportを使用して収集されます。

デフォルトでは、PCPはログを7日間保持し、pmlogger_timersファイルで定義されている1日後に圧縮します。 たとえば: 

# grep PMLOGGER_DAILY_PARAMS /etc/sysconfig/pmlogger_timers |grep -v '#'
PMLOGGER_DAILY_PARAMS="-x 1 -k 7 -R"

アーカイブ・ログは100MB後にローテーションされ、次のパラメータを使用して制御できます:

# grep LOCALHOSTNAME /etc/pcp/pmlogger/control.d/local
LOCALHOSTNAME y n PCP_ARCHIVE_DIR/LOCALHOSTNAME -r -T24h10m -c config.ora -v 100Mb

pcp-oracle-confパッケージがインストールされている場合、pmloggerサービスによって収集されるメトリックのみが、デフォルトのメトリック収集時間が10秒である/var/lib/pcp/config/pmlogger/config.ora構成ファイルにリストされます。

詳細については、「パフォーマンス・コパイロットを使用したメトリックの収集と分析」を参照してください。