|
|
| |
トラップ通知
この章では次の内容について説明します。
WebLogic SNMP トラップ タイプの概要
SNMP エージェントによって SNMP マネージャに送信される、イベントの発生またはしきい値への到達についてのレポートをトラップ通知と呼びます。WebLogic SNMP エージェント ソフトウェアが生成できるトラップ通知には、次のようにいくつかのタイプがあります。
これらのトラップは、エージェントが有効にされていて、あらかじめ定義している特定の条件が発生したときに、SNMP エージェントによって自動的に生成されます。
これらのトラップは、選択した WebLogic 属性の値が変更したときに生成されます。
これらのトラップは、指定した基準を満たすログ メッセージがローカルの WebLogic Server 上で生成されたときに発生します。
これらのトラップは、作成した Java Management Extension (JMX) モニタがしきい値への到達を検出したとき、または、定義していた指定の条件が発生したときに生成されます。
この節では、これらさまざまなタイプのトラップ通知を生成するために WebLogic SNMP エージェントを設定する方法について説明します。トラップ通知が送信される送り先の設定方法については、「 SNMP を使用した WebLogic Server の管理」を参照してください。
SNMP 規格では、マネージャに送信されるトラップ通知を 図 2-1のフィールドを備えたプロトコル データ ユニット(PDU)であると規定しています。
図2-1 SNMP トラップ パケット
フィールドには次の意味があります。
PDU type
は、パケットをトラップ通知として識別します。
enterprise
はトラップを作成したシステムおよびネットワーク管理サブシステムのベンダ識別子(OID)です。WebLogic SNMP エージェントによって作成されたトラップは、すべて、enterprise
フィールドが WebLogic OID の .1.3.6.1.4.140.625
になっています。
agent address
はトラップが作成されたノードの IP アドレスです。
generic trap type
は、0 〜 6 の範囲の整数です。タイプ 6 は enterpriseSpecific
トラップ タイプであり、SNMP の規格解釈はありません。このトラップの解釈は specific trap type フィールドの値によって決まり、specific trap type フィールドはベンダのカスタム MIB によって定義されます。
specific trap type
は、トラップが generic type 6(enterpriseSpecific
)の場合に、トラップを生成したイベントの性質を細かく指定する数値です。WebLogic SNMP エージェントが生成した enterpriseSpecific
トラップに対する specific trap type フィールドの値を
表 2-1 に示します。これらの値は BEA WebLogic MIB で定義されています。
timestamp
はトラップを発行したエージェントが最後に再初期化した時からトラップが発行された時までの時間です。
variable bindings
はトラップに関係する追加情報を示します。このフィールドは名前と値の組で構成されます。このフィールドの意義はベンダによって異なります。WebLogic SNMP エージェントが生成する enterpriseSpecific
トラップ内の変数バインドの内容は、WebLogic MIB 定義で決まります(『WebLogic SNMP MIB リファレンス』を参照)。変数バインドについては後述します。
注意: WebLogic 6.1 SNMP エージェントで使用される enterprise OID は、WebLogic 5.1 SNMP エージェントで使用された enterprise OID とは異なります。WebLogic 6.1 用の enterprise OID は .1.3.6.1.4.140.625
です。
WebLogic 固有トラップ タイプ
次の表は、WebLogic SNMP エージェントが生成する enterpriseSpecific
トラップの固有トラップ タイプについて説明したものです。
表2-1 WebLogic 固有トラップ タイプ
定義済みの WebLogic SNMP トラップ
WebLogic SNMP エージェントは、自動的に次の汎用トラップを生成します。
coldStart
トラップ - このトラップは番号 0 の generic
トラップであり、管理サーバが起動すると、SNMP サービスが有効になっている場合はいつでも生成されます。
authenticationFailure
トラップ - このトラップは、番号 4 の generic trap であり、不正な SNMP コミュニティ文字列を送信する管理ステーションに送信されます。コミュニティ文字列プレフィックスは実際のパスワードであり、Administration Console で WebLogic SNMP エージェントをコンフィグレーションするとき、[コミュニティ プレフィックス] フィールドに設定した値と一致する必要があります(SNMP マネージャが送信するコミュニティ文字列の必須フォーマットについては、「
SNMP を使用した WebLogic Server の管理」を参照してください)。
WebLogic SNMP エージェントが生成する他のすべてのトラップ通知はエンタープライズ固有のトラップ(generic type 6)です。
次の enterpriseSpecific トラップ通知もエージェントによって自動的に生成されます。
serverStart
− このトラップは、以前は停止していた WebLogic の管理対象サーバが現在は起動していることを SNMP エージェントが検出したときには、いつでも生成されます。
このトラップには値が 65 の詳細タイプがあります。variable bindings にある最初の 2 つの名前と値の組は、起動時刻とサーバ名です。
serverShutDown
− このトラップは、以前は稼働していた WebLogic の管理対象サーバが現在は停止していることを SNMP エージェントが検出したときには、いつでも生成されます。
このトラップには値が 70 の詳細タイプがあります。variable bindings にある最初の 2 つの名前と値の組は、停止時刻とサーバ名です。
属性変更トラップ
選択した WebLogic コンフィグレーション属性が変更したことを SNMP エージェントに通知するために WebLogic SNMP エージェントを設定するには、次の操作を行います。
属性変更トラップ通知の変数バインドには、次のような名前と値の組が含まれています。
ADD
、REMOVE
、UPDATE
のいずれかの値。
注意: 実行時属性の変更に関するモニタの作成はサポートされていません。属性値の変更をモニタできるのは、コンフィグレーション MIB 内にある属性だけです。
ログ メッセージ トラップ
WebLogic ロギング サブシステムは、各 WebLogic Server のローカル ログにメッセージの記録を取ります。SNMP エージェントは、エージェントが通知を受けたいログ メッセージを選択するローカル サーバ上にログ メッセージ フィルタを登録できます。フィルタの条件を満たすログ メッセージがローカル WebLogic Server に生成されると、JMX ログ通知がエージェントに送信され、エージェントは SNMP ログ通知トラップを生成します。
ログ通知フィルタは、次のようなログ メッセージ属性に基づいてログ メッセージを選択するように定義できます。
ログ通知フィルタの作成
ログ通知フィルタを作成するには、次の操作を行います。
ログ メッセージ トラップにおける変数バインド
ログ メッセージの属性はトラップの変数バインドとして SNMP マネージャに渡されます。ログ通知トラップの変数バインドには、次のような名前と値の組が含まれています。
trapTime
− トラップが生成された時刻。
trapServerName
− ログ メッセージを生成したローカル サーバの名前。
trapMachineName
− ログ メッセージを生成したサーバが稼働しているマシンの名前。
trapLogThreadId
− ログ メッセージのスレッド ID。
trapLogTransactionId
− ログ メッセージのトランザクション ID(存在する場合)。ログ メッセージがトランザクションのコンテキストで発生した場合、存在するのはトランザクション ID だけです。
trapLogUserId
− ログ メッセージのユーザ ID。
trapLogSubsystem
− ログ メッセージのサブシステム名。
trapLogMsgId
− ログ メッセージのログ メッセージ ID。
trapLogSeverity
− ログ メッセージのメッセージ重大度レベル。
trapLogMessage
− ログ メッセージのテキスト。
ログ メッセージと WebLogic Server ロギング サブシステムの詳細については、『WebLogic Server 管理者ガイド』を参照してください。
モニタ トラップ
WebLogic SNMP エージェントでは、ユーザが定義した条件の発生またはしきい値への到達をチェックするために、指定した間隔で WebLogic リソースのポーリングを行うように Java Management Extension(JMX)モニタをコンフィグレーションできます。ユーザが定義したモニタが指定された条件を検出すると、トラップ通知が SNMP マネージャに送信されます。この機能によって、SNMP 管理ステーションから WebLogic 管理サーバへの WebLogic リソースのポーリングの負荷を軽減できます。
次の 3 種類の JMX モニタをコンフィグレーションできます。
カウンタ モニタのコンフィグレーション
JMX カウンタ モニタを設定するには、次の操作を行います。
ゲージ モニタのコンフィグレーション
JMX ゲージ モニタを設定するには、次の操作を行います。
文字列モニタのコンフィグレーション
JMX 文字列モニタを設定するには、次の操作を行います。
モニタ トラップに含まれる変数
JMX モニタは、指定したしきい値または条件に対してポーリングを行い、エージェントは、指定したしきい値に到達したとき、または指定した条件が発生したときにモニタ トラップを生成します。WebLogic SNMP エージェントには、それぞれのモニタ トラップの変数バインドに次のような名前と値の組があります。
trapTime
− トラップが生成された時刻。
trapServerName
− トラップを生成した属性値を持つローカル サーバ。
trapMonitorType
− CounterMonitor
、StringMonitor
、または GaugeMonitor
のいずれか。
trapMonitorThreshold
− トラップをトリガしたしきい値の ASCII 表記。
trapMonitorValue
− トラップをトリガした値の ASCII 表記。
trapMBeanName
− モニタされる属性を含む MBean の名前。
trapMBeanType
− モニタされる属性を含む MBean のタイプ。
trapAttributeName
− トラップをトリガした値を持つ属性の名前。
トラップ生成の無効化
ログ フィルタ トラップや JMX モニタ トラップなど、特定のタイプのトラップのためにエントリを作成すると、そのようなトラップの生成は、管理サーバが再起動されて初めてアクティブになります。ただし、トラップ生成の非アクティブ化は、作成済みのトラップ リクエストに対して、Administration Console 経由で(または weblogic.Admin
コマンドライン インタフェースで)動的に行うことができます。
特定のタイプのトラップに対するトラップ生成を有効にするときには、Administration Console に表示されるそのタイプのトラップ用のテーブルにエントリを作成します。トラップの非アクティブ化は、トラップ テーブルのエントリを削除するだけでできます。つまり、特定の条件に対してポーリングを行う JMX カウンタ モニタを作成した場合、[SNMP|トラップ|モニタ|SNMP カウンタ モニタ] で表示されたテーブルでそのカウンタ モニタ用のエントリを削除すると、モニタをオフにすることになります。