7 監視と通知のコンフィグレーション

WebLogic 診断フレームワーク (WLDF) の監視と通知コンポーネントでは、サーバとアプリケーションの状態をモニタし、監視で設定した条件に基づく通知を送信できます。監視と通知は、ドメイン内の 1 つまたは複数のサーバを対象にした診断モジュールの一部としてコンフィグレーションされます。

監視と通知については、以下の節で説明します。

監視と通知
監視と通知のコンフィグレーションの概要
監視と通知のコンフィグレーションのサンプル

監視と通知

「監視」は、モニタまたは診断目的で捕捉する状況を識別します。監視は、ログレコード、データイベント、および収集されたメトリックを分析するようコンフィグレーションできます。監視は、監視ルールとして指定されます。監視ルールには以下の項目が指定されます。

監視ルール式
アラーム設定
1 つまたは複数の通知ハンドラ

通知は、監視ルール式の評価が true となった場合のアクションです。WLDF では、以下の種類の通知をサポートしています。

Java Management Extensions (JMX)
Java Message Service (JMS)
電子メールなどの Simple Mail Transfer Protocol (SMTP)
Simple Network Management Protocol (SNMP)
診断イメージ

監視は、実行中のサーバの指定した状態またはアクティビティについて管理者に通知する場合など、役に立つ診断アクティビティの通知に関連付ける必要があります。

監視と通知は、それぞれ別にコンフィグレーションされます。通知は複数の監視に関連付けることができ、監視は複数の通知に関連付けることができます。そのため、現在のニーズに応じて、監視と通知を柔軟に再結合し、再利用することができます。

監視と通知のコンフィグレーションの概要

完全な監視と通知のコンフィグレーションには、1 つまたは複数の監視、1 つまたは複数の通知、通知媒体で必要な基底のコンフィグレーション (たとえば、SNMP ベースの通知の場合は SNMP コンフィグレーション) の設定が含まれます。

WLDF システムリソースコンフィグレーションファイル DIAG_MODULE.xml の、監視と通知のコンフィグレーションに必要な主な要素をコードリスト 7-1 に示します。コードリストで示すように、監視と通知を定義するための基本要素は <watch-notification> です。監視は <watch> 要素で定義され、通知は、種類ごとに指定されている要素 <jms-notification>、<jmx-notification>、<smtp-notification>、<image-notification> などで定義されます。

コードリスト 7-1 監視と通知のコンフィグレーションのスケルトン (DIAG_MODULE.xml 内)

<wldf-resource>
<!-- ----- 他のシステム リソース コンフィグレーション要素 ----- -->
  <watch-notification>
  <log-watch-severity>
     <!-- ログ監視による評価のしきい値となる重大度 
           (監視レベルでさらに限定することが可能) -->
  </log-watch-severity>
    <!-- ----- 監視のコンフィグレーション要素 ----- -->
    <watch>
      <!-- 監視ルール -->
    </watch>
    <watch>
      <!-- 監視ルール -->
    </watch>
    <!-- その他の監視のコンフィグレーション -->

    <!-- ----- 通知コンフィグレーション要素 ----- -->
    <!-- 以下の通知コンフィグレーション要素では、サポートされている 
         通知の各種類の 1 つを表示する。ただし、すべての種類が 
         どのシステム リソース コンフィグレーションでも必要なわけではなく、複数の種類が 
         認められる。-->
    <jms-notification>
      <!-- JMS ベースの通知のコンフィグレーション。jms-server 要素と
           jms-system-resource 要素を介して、対応する JMS コンフィグレーションを
           必要とする -->
    </jms-notification>

    <jmx-notification>
      <!-- JMS ベースの通知のコンフィグレーション -->
    </jmx-notification>
    <smtp-notification>
      <!-- SMTP ベースの通知のコンフィグレーション。mail-session 要素を
           介して、対応する SMTP コンフィグレーションを必要とする -->
    </smtp-notification>
    <snmp-notification>
      <!-- SNMP ベースの通知のコンフィグレーション。snmp-agent 要素を 
           介して、対応する SNMP コンフィグレーションを
           必要とする -->
    </snmp-notification>
    <image-notification>
      <!-- イメージベースの通知のコンフィグレーション -->
    </image-notification>
  <watch-notification>
<!-- ----- 他のコンフィグレーション要素 ----- -->
</wldf-resource>

注意 :

通知媒体は、その通知媒体に応じた通知で使用できるようにコンフィグレーションする必要がありますが、そのコンフィグレーションは、診断モジュール自体のコンフィグレーションの一部ではありません。つまり、通知媒体は、診断モジュールのコンフィグレーションファイルの <wldf-resource> 要素でコンフィグレーションされるものではありません。

個々の通知と監視に対して <enabled>true</enabled> または <enabled>false</enabled> を設定すると、各監視と通知を個別に有効化および無効化できます。また、すべての通知と監視に対して <enabled>true</enabled> または <enabled>false</enabled> を設定すると、監視と通知の機能全体を有効化および無効化できます。デフォルト値は <enabled>true</enabled> です。

<watch-notification> 要素には、<log-watch-severity> 下位要素があります。この下位要素は、ログルールの監視によってトリガされる通知の発動に影響します。

監視をトリガしたログメッセージの最大の重大度レベルが、指定されている重大度レベルと同じレベル以上でなければ、その監視でトリガされる通知は発動しません。ただし、これはログルールタイプの監視によって発動される通知にのみ適用されます。この要素を、監視に対して定義する <severity> 要素と混同しないでください。<severity> 要素は、監視自体に重大度を割り当てるものですが、<log-watch-severity> 要素は、ログルールの監視によってどの通知が発動されるかを指定します。

Administration Console を使用することでどう監視と通知を構成するかの情報については、『Oracle Fusion Middleware Oracle WebLogic Server Administration Console ヘルプ』の「監視および通知のコンフィグレーション」を参照してください。

監視と通知のコンフィグレーションのサンプル

診断モジュールの監視と通知のコンフィグレーションのセットに関する完全なコンフィグレーションをコードリスト 7-2 に示します。この例については、以下の 2 つの章で詳しく説明します。

「監視のコンフィグレーション」
「通知のコンフィグレーション」

コードリスト7-2 監視と通知のコンフィグレーションのサンプル (DIAG_MODULE.xml 内)

<?xml version='1.0' encoding='UTF-8'?> 
<wldf-resource xmlns="http://xmlns.oracle.com/weblogic/weblogic-diagnostics" 
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://xmlns.oracle.com/weblogic/weblogic-diagnostics/1.0/weblogic-diagnostics.xsd"> 
  <name>mywldf1</name> 
  <!-- インスツルメンテーション監視用に、インスツルメンテーションをコンフィグレーション 
       および有効化する必要がある -->
  <instrumentation> 
    <enabled>true</enabled> 
    <wldf-instrumentation-monitor> 
      <name>DyeInjection</name> 
      <description>Dye Injection monitor</description> 
      <dye-mask xsi:nil="true"></dye-mask>    <properties>ADDR1=127.0.0.1</properties> 
    </wldf-instrumentation-monitor> 
  </instrumentation> 
  <!-- ハーベスタ監視に対して必ずしも収集をコンフィグレーションおよび有効化
       しなくてもよい。ただし、ハーベスタをコンフィグレーションすると、データのアーカイブなどの利点がある。-->
  <harvester> 
    <name>mywldf1</name> 
    <sample-period>20000</sample-period> 
    <harvested-type> 
      <name>weblogic.management.runtime.ServerRuntimeMBean</name> 
    </harvested-type> 
    <harvested-type> 
      <name>weblogic.management.runtime.WLDFHarvesterRuntimeMBean</name> 
    </harvested-type> 
  </harvester> 
  <!-- すべての監視と通知は、watch-notification 要素で定義される -->
  <watch-notification> 
    <enabled>true</enabled> 
    <log-watch-severity>Info</log-watch-severity>
    <!-- ハーベスタ監視のコンフィグレーション --> 
    <watch> 
      <name>myWatch</name> 
      <enabled>true</enabled> 
      <rule-type>Harvester</rule-type>
      <rule-expression>${com.bea:Name=myserver,Type=ServerRuntime//SocketsOpenedTotalCount} &gt;= 1</rule-expression>
      <alarm-type>AutomaticReset</alarm-type> 
      <alarm-reset-period>60000</alarm-reset-period> 
      <notification>myMailNotif,myJMXNotif,mySNMPNotif</notification> 
    </watch> 
    <!-- インスツルメンテーション監視のコンフィグレーション --> 
    <watch> 
      <name>myWatch2</name> 
      <enabled>true</enabled> 
      <rule-type>EventData</rule-type> 
      <rule-expression>
      (MONITOR LIKE 'JDBC_After_Execute') AND
      (DOMAIN = 'MedRecDomain') AND
      (SERVER = 'medrec-adminServer') AND
      ((TYPE = 'ThreadDumpAction') OR (TYPE = TraceElapsedTimeAction')) AND
      (SCOPE = 'MedRecEAR')
      </rule-expression>
      <notification>JMXNotifInstr</notification> 
    </watch> 
    <!-- ログ監視のコンフィグレーション -->
    <watch> 
      <name>myLogWatch</name> 
      <rule-type>Log</rule-type> 
      <rule-expression>MSGID='BEA-000360'</rule-expression> 
      <severity>Info</severity> 
      <notification>myMailNotif2</notification> 
    </watch>
    <!-- JMX 通知 -->
    <jmx-notification> 
      <name>myJMXNotif</name> 
    </jmx-notification> 
    <!-- 2 つの SMTP 通知 -->
    <smtp-notification> 
      <name>myMailNotif</name> 
      <enabled>true</enabled> 
      <mail-session-jndi-name>myMailSession</mail-session-jndi-name> 
      <subject>This is a harvester alert</subject> 
      <recipient>username@emailservice.com</recipient> 
    </smtp-notification> 
    <smtp-notification> 
      <name>myMailNotif2</name> 
      <enabled>true</enabled> 
      <mail-session-jndi-name>myMailSession</mail-session-jndi-name> 
      <subject>This is a log alert</subject> 
      <recipient>username@emailservice.com</recipient> 
    </smtp-notification> 
    <!-- SMTP 通知 -->
    <snmp-notification> 
      <name>mySNMPNotif</name> 
      <enabled>true</enabled> 
    </snmp-notification> 
  </watch-notification> 
</wldf-resource>