Oracle® Fusion Middleware

SNMPによるOracle WebLogic Serverのモニタリング

12c (12.2.1)

E69999-01(原本部品番号:E55206-01)

2015年10月

Oracle WebLogic ServerのSNMP機能を説明する管理者向けのドキュメントです。

Oracle Fusion Middleware SNMPによるOracle WebLogic Server のモニタリング, 12c (12.2.1)

E69999-01

Copyright © 2007, 2015, Oracle and/or its affiliates.All rights reserved.

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- ドキュメントのアクセシビリティについて

- 表記規則

1 概要とロードマップ

- ドキュメントのスコープおよび対象読者

- このドキュメントの手引き

- 関連ドキュメント

- WebLogic Server SNMPでサポートされる標準

- このリリースでのSNMPの新機能と変更点

2 WebLogic Server SNMPエージェントおよびMIBの理解

- SNMPの概要

- WebLogic Server SNMPエージェント

- ドメイン内でのSNMPエージェントの配置

- ドメイン・スコープのエージェント

- SNMPプロトコルの構成

- UDPポートおよびTCPポートの構成

- リクエストのスコープの限定

- SNMPエージェントのモニター

- SNMPのセキュリティ

- SNMPv1およびSNMPv2用のコミュニティ名

- SNMPv1およびSNMPv2の無効化

- SNMPv3のセキュリティの構成

- SNMPv3資格証明キャッシュの無効化

- WebLogic Server用のMIBモジュール

- 階層データ・モデル

- 構成と実行時の階層

- MIBモジュールとWebLogic Server MBeanデータ・モデルの関係

- オブジェクト識別子

- オブジェクトと変数のOID

- MIBの閲覧

- カスタムMBeanのモニター

- カスタムMBean MIBモジュールの構造

3 WebLogic Server通知の理解

- INFORM通知とTRAP通知

- 自動的に生成される通知

- ログ・メッセージ通知

- ログ・メッセージ通知における変数バインド

- モニター通知

- モニター通知の変数バインド

- 属性変更通知

- 属性変更通知の変数バインド

- WebLogic Server通知のOID

4 SNMPプロキシの理解

- 他のエージェント用のプロキシとしてのSNMPエージェント

- プロキシされた通信のSNMPプロトコルの構成

- プロキシされた通信に対する資格証明の指定

- プロキシされたエージェントのリスニング・ポートの選択

- Microsoft Windows SNMPサービス

5 WebLogic SNMPコマンドライン・ユーティリティ

- SNMPコマンドライン・ユーティリティの環境要件

- SNMPコマンドライン・ユーティリティの構文とコマンド

- 例

はじめに

ここでは、このガイド『SNMPによるOracle WebLogic Serverのモニタリング』で使用されるアクセシビリティ機能および表記規則について説明します。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

サポートをご購入のOracleのお客様は、My Oracle Supportにアクセスして電子サポートを受けることができます。詳細情報はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoか、聴覚に障害があるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。

表記規則

このドキュメントでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

斜体

イタリックは、ユーザーが特定の値を指定するプレースホルダー変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

1 概要とロードマップ

この章では、このガイド(『SNMPによるOracle WebLogic Serverのモニタリング』)の内容と構成について説明します。このドキュメントでは、WebLogic ServerにおけるSNMP (Simple Network Management Protocol)機能全体、およびSNMPを利用して企業全体の管理システムで、単一の管理コンソールから異種環境のソフトウェアおよびハードウェアを管理する方法について説明します。

この章の内容は次のとおりです。

- ドキュメントのスコープおよび対象読者

- このドキュメントの手引き

- 関連ドキュメント

- WebLogic Server SNMPでサポートされる標準

- このリリースでのSNMPの新機能と変更点

ドキュメントのスコープおよび対象読者

このドキュメントは、SNMPを使用してWebLogic Serverをモニターするシステム管理者のためのリソースです。

このドキュメントのトピックでは、WebLogic ServerのSNMP機能について説明します。WebLogic Server管理コンソール・オンライン・ヘルプでは、WebLogic ServerドメインのSNMPサービスを構成するタスクに関連する情報を提供しています。

SNMPおよび一般的なネットワーク管理の概念に精通している読者を対象としています。SNMPの基本情報については、「関連ドキュメント」で紹介するドキュメントを参照してください。

このドキュメントの手引き

このドキュメントの構成は次のとおりです。

- この章では、このガイドの対象読者について説明します。また、関連ドキュメントへのリンクも用意されています。

- 第2章「WebLogic Server SNMPエージェントおよびMIBの理解」では、WebLogic Serverの管理に適用されるSimple Network Management Protocolの基本概念の理解説明します。

- 第3章「WebLogic Server通知の理解」では、WebLogicのエンタープライズ固有SNMP通知について説明します。

- 第4章「SNMPプロキシの理解」では、WebLogic Serverが他のSNMPエージェントのプロキシの役割を果たすマスター・エージェントとして機能する仕組みについて説明します。

- 第5章「WebLogic SNMPコマンドライン・ユーティリティ」では、コマンドライン・ユーティリティについて説明します。SNMPマネージャが備えている機能は、その大部分がコマンドライン・ユーティリティからも実行できます。

関連ドキュメント

WebLogic ServerドメインのSNMPサービスを構成する手順については、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPを使用したWebLogic Serverの監視に関する項を参照してください。

WebLogic Serverをモニターするためのその他の技術については、以下のドキュメントを参照してください。

- 『Oracle WebLogic Server JMXによるカスタム管理ユーティリティの開発』

- Oracle WebLogic Server診断フレームワークの構成と使用

SNMPに関する基本情報については、『com.protocols.snmp SNMP FAQ Part 1』(http://www.faqs.org/faqs/snmp-faq/part1/)および『com.protocols.snmp SNMP FAQ Part 2』(http://www.faqs.org/faqs/snmp-faq/part2/)を参照してください。

WebLogic Server SNMPでサポートされる標準

このリリースのWebLogic Serverは以下のSNMP標準をサポートしています。

表1-1 サポートされるSNMP標準

機能

サポートされる標準

SNMPプロトコル

SNMPv1、SNMPv2、SNMPv3

ネットワーク・プロトコル

UDP、TCP

SNMPv3用の認証プロトコル

HMAC-MD5-96、HMAC-SHA-96

SNMPv3用のプライバシ・プロトコル

- Data Encryption StandardのCipher Block Chaining (CBC)モード

- Advanced Encryption Standard (AES)暗号アルゴリズム。http://www.rfc-archive.org/getrfc.php?rfc=3826のRFC 3826を参照してください。

このリリースでのSNMPの新機能と変更点

このリリースでは、WebLogic Server SNMPエージェントには、各モニター通知の変数バインドに、新しい名前と値のペアtrapConfigNameがあります。詳細は、「モニター通知」を参照してください。

WebLogic Serverのこのリリースに追加された新機能の一覧については、『Oracle WebLogic Serverの新機能』 12.2.1を参照してください。

2 WebLogic Server SNMPエージェントおよびMIBの理解

この章では、Simple Network Management Protocol (SNMP)管理モデルおよびWebLogic Serverが、このモデルを実装する仕組みについて説明します。SNMPを使用すると、企業全体の管理システムにモニター・データを提供できます。

この章の内容は以下のとおりです。

- SNMPの概要

- WebLogic Server SNMPエージェント

- SNMPのセキュリティ

- WebLogic Server用のMIBモジュール

- カスタムMBeanのモニター

詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPを使用したWebLogic Serverの監視に関する項を参照してください。

SNMPの概要

SNMPでは、管理対象リソースの情報に対するリクエストが、マネージャからエージェントに送信されます。エージェントはリクエストされたデータを収集し、レスポンスを返します。また、管理対象リソースに対する定義済みのしきい値または条件を検出したときに、非請求レポート(通知)をマネージャに発行するように、エージェントを構成することもできます。

特定の管理対象リソースのデータをリクエストするには、マネージャがリソースを一意に識別できる必要があります。SNMPでは、各タイプの管理対象リソースは、一意のオブジェクト識別子(OID)が指定された管理対象オブジェクトとして、管理情報ベース(MIB)内に記述されます。個々の構成で、MIBモジュール内の特定の管理対象オブジェクトが定義されます。特定の管理対象リソースについて通信するには、マネージャとエージェントが両方とも、同じMIBモジュールにアクセスできる必要があります。

WebLogic Server SNMPエージェント

WebLogic Server SNMPエージェントは、WebLogic Server管理システムに対して問合せを実行し、SNMPプロトコルを通じてその結果をマネージャに通信します。WebLogic Server管理システムは、管理対象Bean (MBean)の集合を通じて、管理データを公開します。WebLogic Server SNMPエージェントは、マネージャからのリクエストを受信すると、マネージャのリクエスト内のOIDに対応するMBeanを判断します。次に、データを取り出し、SNMPレスポンスにラップします。

WebLogic Server SNMPエージェントを使用すると、次のことができます。

- WebLogic Server MBean属性の現在の値に対するSNMPマネージャからの簡単なGETリクエストに応答します。

注意:
WebLogic Serverでは、SNMPマネージャはMBeanの値の設定とMBean処理の呼出しはできません。SNMPマネージャでは、WebLogic Serverのモニターのみを実行できます。

- JMXモニターを使用してWebLogic Server MBeanを定期的にポーリングし、指定したとおりにMBean属性が変更されたときにSNMPマネージャに通知を送信します。

- 管理サーバーまたは任意の管理対象サーバーが起動または停止したときに、SNMPマネージャに通知を送信します。

- 特定のログ・メッセージをリスニングし、WebLogic Serverがそのメッセージを生成したときにSNMPマネージャに通知を送信します。

- SNMPマネージャからのリクエストを同一マシン内のWebLogic以外のSNMPエージェント(Oracleデータベース・エージェントなど)に渡すプロキシ・エージェントとして機能します。

ドメイン内でのSNMPエージェントの配置

各WebLogic Serverドメインで、複数のSNMPエージェントを作成して、SNMPモニターおよび通信のために、分散型または集中型モデルとして配置できます。

- 分散型モデルでは、管理対象サーバーごとにSNMPエージェントを作成します。SNMPマネージャは、個々の管理対象サーバーのエージェントと通信します。図2-1を参照してください。

- 集中型モデルでは、管理サーバーのみにSNMPエージェントを作成します。SNMPマネージャは、管理サーバーのSNMPエージェントとのみ通信し、エージェントがドメイン内のすべての管理対象サーバーからモニター・データを収集します。図2-2を参照してください。
これは、単一のリクエストでドメイン全体のデータを取り出せる便利なモデルですが、次のような問題があります。

- 管理サーバーが利用できない場合は、SNMPによってドメインをモニターできません。

- ドメインが大きい場合、特定リソースの情報を見つけるために大量のデータをフィルタ処理する必要があリます。レスポンスでデータをフィルタ処理するかわりに、リクエストの範囲を絞り込むことが可能です。「リクエストのスコープの限定」を参照してください。

- このモデルでは、パフォーマンス・オーバーヘッドを導入しています。ドメイン内の全サーバーからデータを収集するには、管理サーバー上のエージェントがドメイン実行時MBeanサーバーに対して問合せを実行します。このMBeanサーバーは、ドメイン全体のサービスに対するMBeanを含み、管理対象サーバー上にあるMBeanへの単一のアクセス・ポイントとしても機能します。ドメイン実行時MBeanサーバーは、ドメイン内のすべての管理対象サーバーと通信するので、ネットワーク・レイテンシの影響を受けやすく、管理サーバーが使用するメモリーの量が増大します。

図2-1は、ドメイン内の個々のサーバーにSNMPエージェントを作成する際、エージェントによってホスト・サーバーの実行時MBeanサーバー内のMBeanに問合せが行われるプロセスを図示したものです。このMBeanサーバーには、個々のホスト・サーバーのMBeanのみが含まれます。

図2-1 SNMPモニターおよび通信の分散型モデル

図2-2は、管理サーバー上のSNMPエージェントを使用して管理対象サーバーのデータを取り出す際、エージェントによってドメイン実行時MBeanサーバー内のMBeanに対し問合せが行われるプロセスを図示したものです。

図2-2 SNMPモニターおよび通信の集中型モデル

WebLogic Server SNMPエージェントの作成については、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPエージェントの作成に関する項を参照してください。

ドメイン・スコープのエージェント

WebLogic Serverリリース9.2以前で作成されたドメインをサポートするため、管理サーバーまたは管理対象サーバー上のSNMPエージェント(サーバーSNMPエージェント)を構成するのではなく、ドメイン・スコープのSNMPエージェントを有効にして使用することができます。ドメイン・スコープのエージェントには、上述の集中型モデルにおけるサーバーSNMPエージェントと同じ機能があります。ただし、基底の実装が違っており、いずれ非推奨となる予定です。ドメイン・スコープのエージェントは、サーバーSNMPエージェントを管理サーバーにターゲット指定すると、オーバーライドされます。

SNMPプロトコルの構成

WebLogic Server SNMPエージェントは、SNMPv3プロトコルを使用するマネージャとは常に通信可能です。エージェントが、SNMPv1およびSNMPv2プロトコルもサポートするかどうかを構成できます。エージェントがSNMPv3リクエストを受信しないようにすることはできませんが、エージェントでは、WebLogic Serverセキュリティ・レルムで構成した、既知のユーザーからのリクエストのみが処理されます。

詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPエージェントの作成に関する項を参照してください。

UDPポートおよびTCPポートの構成

SNMPエージェントは、UDPトラフィックを受け付けるポートと、TCPトラフィックを受け付ける別のポートを介して通信します。デフォルトでは、すべてのTCPトラフィックに、ホスト・サーバーのリスニング・ポートを使用します。たとえば、このエージェントをManagedServer1という名前のサーバーにターゲット指定し、ManagedServer1がポート7001に対するリクエストをリスニングする場合、SNMPエージェントはポート7001に対するTCPリクエストをリスニングします。TCPポートを介しての通信時には、WebLogic Serverはサービス拒否(DOS)攻撃からSNMP通信を保護します。

SNMP TCPトラフィックを、ビジネス・トラフィックから分離する場合は、カスタム・ネットワーク・チャネルを作成します。

詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPエージェントの作成に関する項とSNMPネットワーク・チャネルの作成に関する項を参照してください。

リクエストのスコープの限定

SNMPマネージャが管理サーバー上のエージェントに対するリクエストを送信した場合、エージェントのレスポンスには、オブジェクトの複数のインスタンスを記述するデータが含まれている可能性があります。たとえばserverUptimeというオブジェクトは、ドメイン内のWebLogic Serverインスタンスごとに存在します。マネージャがserverUptimeに対するリクエストを管理サーバー上のエージェントに送信した場合、レスポンスにはドメイン内の各サーバーにつきserverUptimeインスタンスが1つ含まれます。

マネージャのリクエスト内において追加情報をエンコードすることで、リクエストのスコープを限定することができます。エンコードする情報は、使用するSNMPプロトコルに応じて変わります。

- SNMPv1またはSNMPv2プロトコルを使用するリクエストでは、次のように、リクエストと共に送信するSNMPコミュニティ名に、サーバー・インスタンス名を付加します。
community_prefix@server_name

community_prefixはSNMPコミュニティ名、server_nameは目的の管理対象サーバーの名前です。マネージャから送信されるcommunity_prefixの値は、SNMPエージェントの構成時に「コミュニティ接頭辞」フィールドで設定する値と一致する必要があります。

ドメイン内のすべてのサーバー・インスタンスの管理対象オブジェクトをリクエストするには、コミュニティ名を次の形式でWebLogic SNMPエージェントに送信します。

community_prefix

- SNMPv3プロトコルを使用するリクエストでは、リクエストのコンテキスト名フィールドで管理対象サーバーの名前をエンコードします。

SNMPエージェントのモニター

WebLogic Server管理コンソールの「SNMP」→「監視」タブでは、ドメイン内の各SNMPエージェントについて、マネージャに送信した通知の数や、失敗した認証の試行回数などの情報を確認できます。Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPエージェントの監視に関する項を参照してください。

また、WebLogic Scripting Tool (WLST)またはJMXクライアントを使用してこのモニター情報にアクセスし、新しいSNMPAgentRuntimeMBeanにアクセスすることもできます。Oracle WebLogic Server MBeanリファレンスのSNMPAgentRuntimeMBeanに関する項を参照してください。WLSTの使用方法については、『WebLogic Scripting Toolの理解』を参照してください。

SNMPのセキュリティ

SNMPで利用できるセキュリティ機能は、エージェントがマネージャとの通信に使用するSNMPプロトコルによって異なります。

SNMPv1およびSNMPv2用のコミュニティ名

WebLogic SNMPエージェントからのデータをリクエストしているSNMPマネージャにデータを取得する許可が付与されていることを確認し、さらにそのエージェントにターゲット・マネージャへ通知を送信する許可が付与されていることを検証する場合、SNMPv1およびSNMPv2ではコミュニティ名というクリア・テキスト・パスワードが使用されます。

SNMPエージェントを作成する際には(Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPエージェントの作成に関する項を参照)、エージェントにより要求されるSNMPマネージャからのコミュニティ名を指定します。

SNMPv1およびSNMPv2の無効化

SNMPv1およびSNMPv2はクリア・テキスト・パスワードを使用するため、セキュリティ・レベルは低いものです。マネージャとの通信にSNMPv3を使用できる場合は、各SNMPエージェントに対するコミュニティ・ベースのアクセスの無効化によってSNMPv1およびSNMPv2を無効化することを検討してください。詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPエージェントの作成に関する項を参照してください。

SNMPv3のセキュリティの構成

SNMPv3プロトコルでは、通信を正常に行うためにSNMPエージェントとマネージャの両方がPDUで同じ資格証明をエンコードする必要があります。資格証明には、複数のトークン(ユーザー名、SNMPエンジンID、認可プロトコル、および省略可能なプライバシ・パスワード)が含まれており、それらはすべて、ネットワーク経由でトランスポートされる前に、暗号化されます。

WebLogic Serverでは、SNMPエージェントはドメインのセキュリティ・レルムと連携して機能し、セキュアな通信を実現します。SNMPエージェントは、リクエスト内のSNMP資格証明をデコードして、セキュリティ・レルムにSNMPユーザー名を渡します。セキュリティ・レルムは、SNMPユーザー名をWebLogic Serverユーザーにマップし、ユーザーを認証し、ドメイン内のモニター・データへのアクセスを認可します。SNMP資格証明を、WebLogic Serverセキュリティ・レルム内のユーザーにマップするには、資格証明マップを作成します。

SNMPv3のセキュリティを構成する方法については、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPv3通信の保護に関する項を参照してください。

SNMPv3資格証明キャッシュの無効化

パフォーマンス最適化のため、SNMPエージェントは、WebLogic ServerユーザーとSNMP資格証明を相互に関連付ける資格証明マップをキャッシュします。キャッシュに、SNMP資格証明の最新セットが確実に格納されるよう、エージェントは定期的に、キャッシュを無効化します。キャッシュの無効化後、次に資格証明をリクエストしたときに、エージェントはキャッシュを再生成します。

資格証明マップに変更を加えても、SNMPエージェントのキャッシュが自動的に更新されることはありません。キャッシュが更新されるのは、無効化を経た場合のみです。たとえば、SNMP資格証明マップの既存エントリ内のプライバシ・パスワードを更新した場合、SNMPエージェントは、キャッシュが無効化されて再生成されるまで、その新しいパスワードを認識しません。キャッシュが無効化されるまでは、古いセキュリティ・パスワードを付与されたSNMPユーザーが、引続きエージェントを使用してWebLogic Serverのデータにアクセスできます。

資格証明マップの修正後は、各SNMPエージェントがキャッシュの無効化を行うのを待機することも、即座に無効化することもできます。

キャッシュを即座に無効化する方法については、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMP資格証明のキャッシュの無効化に関する項を参照してください。

エージェントによるキャッシュ無効化の頻度は、エージェント作成時に構成できます。Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPエージェントの作成に関する項を参照してください。

WebLogic Server用のMIBモジュール

WebLogic Server用のMIBモジュールでは、抽象構文記法1 (Abstract Syntax Notation.1: ASN.1)を使用して、SNMPを介してモニターできるリソース・タイプと、WebLogic Server SNMPエージェントがSNMPマネージャに送信できる通知タイプを記述します。

WebLogic Serverインストーラは、MIBモジュールのコピーを次の場所に作成します。ここで、WL_HOMEは、WebLogic Serverのルート・インストール・ディレクトリを示します。

WL_HOME/server/lib/BEA-WEBLOGIC-MIB.asn1

WebLogic Serverの各リリースによって、新しい管理対象オブジェクトがモジュールに追加されます。既存の管理対象オブジェクトのオブジェクト識別子は、リリースごとに変更されません。

以下の節では、WebLogic Server MIBモジュールについて説明します。

- 階層データ・モデル

- オブジェクト識別子

- MIBの閲覧

階層データ・モデル

WebLogic Serverは、その管理システム内で多数のデータ・ポイントを公開します。このデータを編成するために、ドメインで利用可能なサービスとリソースの集まりを反映した階層データ・モデルが用意されてます。たとえば、WebLogic Serverドメインには複数のサーバーを配置できます。各サーバーはアプリケーションを保持(またはホスト)し、各アプリケーションにはWebアプリケーション、EJB、および他のJava EEモジュールが含まれます。

WebLogic Server MIBモジュールは、この階層を反映しています。たとえば、WebLogic Serverドメインは、その構成全体をdomainTableという表形式の管理対象オブジェクトに記述します。この表形式のオブジェクトはスカラー・オブジェクトの集合を参照(保持)し、それぞれのオブジェクトはドメインの何らかの属性を定義します。たとえば、domainTableには、ドメインのすべてのサーバー名を定義するdomainServersというスカラー・オブジェクトがあります。serverTableオブジェクトには、serverDeploymentsというスカラー・オブジェクトがあります。これは、サーバーに現在デプロイされているすべてのアプリケーションを定義します。

表形式のオブジェクトは、オブジェクト・インスタンス(MIB変数)を直接保持しません。かわりに、表形式のオブジェクトはスカラー・オブジェクトを保持し、スカラー・オブジェクトは変数を保持します。たとえば、MS1とMS2という2つの管理対象サーバーをドメインに作成した場合、MIBにはserverTableオブジェクトが1つあり、このオブジェクトにserverNameオブジェクトが含まれます。serverNameオブジェクトには、MS1とMS2という値を保持する2つの変数が存在します。図2-3を参照してください。

図2-3 オブジェクトとオブジェクト・インスタンスの階層

構成と実行時の階層

WebLogic Server管理データ・モデルは、そのすべての管理データを反映した1つの大規模な階層ではなく、2つの階層から構成されます。ひとつはその構成データ用で、もうひとつは実行時のみに利用可能なパフォーマンスおよびモニター・データ用です。実行時データを記述するすべての管理対象オブジェクトには、名前に「runtime」という単語が含まれますが、構成用の管理対象オブジェクトには含まれません。たとえば、MIBのdomainTableにはドメインの構成が記述され、domainRuntimeTableには実行時データが記述されます。

MIBモジュールとWebLogic Server MBeanデータ・モデルの関係

WebLogic Serverには、Java Management Extensions (JMX)の実装の一部として管理対象Bean (MBean)が用意されています。JMXはプログラミングによってWebアプリケーション・サーバーの管理データにアクセスするためのJava EE仕様であり、MBeanは管理データと管理処理を表現したものです。JMXの目的は、SNMPと同じように、エージェントとマネージャ間の管理情報の標準通信を実現することです。

実装レベルでは、WebLogic Server SNMPエージェントとMIBは、WebLogic Server JMX実装の上部のプロトコル固有レイヤーを形成します。WebLogic Server JMX実装について理解していれば、WebLogic Server MBeanのデータ・モデルとWebLogic Server MIBの管理対象オブジェクトの構成が似ていることに気がつきます。しかし、重要な相違点もいくつかあります。

- WebLogic Serverでは、JMXクライアント(SNMPマネージャに類似)はドメインをモニターでき、またドメインの構成を変更できます。SNMPマネージャには、その管理システムに対する読取りアクセス権のみが付与されています。

- MBeanのデータ・モデルは階層が深く、MIBのデータ・モデルは浅いです。たとえば、JMXクライアントはDomainMBeanからその子であるServerMBeansを参照し、さらに各ServerMBeanの子を参照できます。これに対し、MIBは一意の識別子を使用してオブジェクトを表現します。「オブジェクト識別子」を参照してください。

- 複雑なタイプや複雑なタイプの配列のMBean属性のエントリは、SNMP MIBには含まれません。Stringや簡単なタイプのMBean属性、またはStringや簡単なタイプの配列のMBean属性がMIBで定義されます。

WebLogic ServerのJMX実装の詳細は、『Oracle WebLogic Server JMXによる管理可能アプリケーションの開発』を参照してください。

オブジェクト識別子

MIBは、各管理対象オブジェクトにオブジェクト識別子 (OID)という一意で不変な番号を割り当てます。各OIDは、左から右に並べられた整数で構成されています。この数値の並び順は、MIBツリー内のオブジェクトの位置を定義し、ツリー内でのオブジェクトへの一意のパスを指定します。パス上の各ノードには、番号とその番号に関連付けられた名前があります。

パス.1.3.6.1.4.1は、private.enterprises OIDを定義しており、ツリーにおいてこのノードの下にあるそれぞれの番号は、特定ベンダー(Oracleなど)用に予約されたツリーのブランチを表しています。MIBモジュールは、ツリー内の.1.3.6.1.4.1.140で登録され、WebLogic Server MIBモジュールは.1.3.6.1.4.1.140.625の下にあるすべてのOIDから構成されます。

オブジェクトと変数のOID

WebLogic Server MIBモジュールは、OIDを使用してその階層データ・モデルを反映します。たとえば、serverRuntimeTableオブジェクトのOIDは、.1.3.6.1.4.1.140.625.360です。serverRuntimeTableオブジェクトに含まれるserverRuntimeStateスカラー・オブジェクトのOIDは、.1.3.6.1.4.1.140.625.360.1.60です。

オブジェクトのインスタンス(変数)を識別するため、WebLogic SNMPエージェントでは、一連の追加番号が生成され、オブジェクトのOIDに付加されます。たとえば、serverRuntimeStateの変数のOIDは以下のようになります。

.1.3.6.1.4.1.140.625.
360.1.60.32.102.100.48.98.101.102.100.99.102.52.98.97.48.48.49.102.57.53.51.50.
100.102.53.55.97.101.52.56.99.99.97.99.

OIDは、そのオブジェクトの複数のインスタンスにわたって不変です。

管理対象オブジェクトのOIDを参照する場合は、BEA-WEBLOGIC-MIB.asn1の内容を表示できます。また、変数のOIDを参照する場合は、SnmpWalkコマンドまたはSnmpGetNextコマンドを使用します。詳細は、第5章「WebLogic SNMPコマンドライン・ユーティリティ」を参照してください。

MIBの閲覧

WebLogic ServerのMIBモジュールの内容を表示するには、MIBブラウザの使用をお薦めします。WebLogic Serverには付属していませんが、MIBブラウザはほとんどのSNMPユーティリティ・ベンダーによって提供されています。

MIBモジュールは、WebLogic Serverのインストール・ディレクトリの次の場所に格納されています。

WL_HOME/server/lib/BEA-WEBLOGIC-MIB.asn1

カスタムMBeanのモニター

WebLogic SNMPエージェントは、WebLogic Server実行時MBeanサーバーに登録されたすべてのカスタムMBeanに対するエントリが格納された実行時MIBモジュールを保持するように構成できます。カスタムMBeanとは、ユーザーが作成および登録できるMBeanです(『Oracle WebLogic Server JMXによる管理可能アプリケーションの開発』を参照)。その後、SNMPマネージャを使用すると、カスタムMBeanに関する情報をリクエストできます。WebLogic Server SNMPエージェントでは、しきい値に到達した値があると、カスタムMBeanの値を定期的にポーリングして通知を生成することができません。かわりに、SNMPマネージャがWebLogic Server SNMPエージェントへのリクエストを送信する必要があります。

カスタムMBeanを監視するためのWebLogic SNMPエージェントの構成方法および使用方法については、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのカスタムMBeanの監視に関する項を参照してください。

カスタムMBean MIBモジュールの構造

各カスタムMBeanタイプについて、WebLogic ServerではMIBモジュールに表が追加されます。カスタムMBeanの各インスタンスについて、表の行が追加されます。各MBean属性については、表の列が追加されます。

標準MBeanの表名はそのMBeanの実装クラスの名前に基づいており、モデルMBeanの表名はそのMBeanのMBeanInfoオブジェクトで指定されている名前に基づいています。

カスタムMBeanタイプの表に加えて、MBean MIBモジュールには、federatedMBeanServerDelegateTableおよびmBeanServerDelegateTableという2つの表があります。これらのMBeanには、MBeanサーバー自体に関する情報(ベンダー名、バージョン番号など)が含まれています。

WebLogic Serverでは、MIBモジュールをファイルなどのデータ構造として永続化することはありませんが、モジュール内のOIDは複数のサーバー・セッションに渡って一定に保持されます。

例2-1に、Avitek Medical Recordsアプリケーション(MedRec)から抜粋したカスタムMBean MIBモジュールを示します。MedRecはWebLogic Serverに付属のエンドツーエンドのサンプルJava EEアプリケーションです。MedRecは、WebLogic Server実行時MBeanサーバーに、2つのカスタムMBeanを登録します。

- AdminReportMBean。これはデータベースを6秒ごとにポーリングして、システムに追加する新規ユーザーを確認します。新規ユーザー数は、NewUserCountという属性に格納されます。

- RecordSessionEJBMBean。これにはRecordSessionEJBがデータベースに処方箋を書き込む回数を記録する1つの属性TotalRxが含まれます。

例2-1のMIBモジュールには、MedRecのカスタムMBeanタイプごとに1つずつの表、adminReportTableおよびrecordSessionEJBMBeanImplTableが含まれます。MIB内の表名(adminReportTableおよびrecordSessionEJBMBeanImplTable)は、AdminReportMBeanおよびRecordSessionEJBMBean (標準MBean)の、基底の実装クラスに一致しています。

例2-1 MedRecサーバーにおけるカスタムMBeanのMIBモジュール

CUSTOM-MBEANS-MIB DEFINITIONS ::=
BEGIN
IMPORTS
wls    FROM BEA-WEBLOGIC-MIB
OBJECT-TYPE, MODULE-IDENTITY    FROM SNMPv2-SMI
;
customMBeansMib MODULE-IDENTITY
LAST-UPDATED "0701101716Z"
ORGANIZATION "..."
CONTACT-INFO "...."
DESCRIPTION "MIB for custom MBeans registered in WLS RuntimeMBeanServer"
::= { wls 50  }
customMBeansMibTables OBJECT IDENTIFIER ::= { customMBeansMib 1  }
adminReportTable-Oid OBJECT IDENTIFIER ::= {
customMBeansMibTables 97 100 109 105 110 82 101 112 111 114
federatedMBeanServerDelegateTable-Oid OBJECT IDENTIFIER ::= {
customMBeansMibTables 102 101 100 101 114
mBeanServerDelegateTable-Oid OBJECT IDENTIFIER ::= {
customMBeansMibTables 109 66 101 97 110 83 101 114
recordSessionEJBMBeanImplTable-Oid OBJECT IDENTIFIER ::= {
customMBeansMibTables 114 101 99 111 114 100
adminReportTable OBJECT-TYPE
SYNTAX      SEQUENCE OF AdminReportEntry
MAX-ACCESS  not-accessible
STATUS      current
DESCRIPTION "Dynamically created table for type
com.bea.medrec.admin.AdminReport"
::= { adminReportTable-Oid 1  }
adminReportEntry OBJECT-TYPE
SYNTAX      AdminReportEntry
MAX-ACCESS  not-accessible
STATUS      current
DESCRIPTION "Generated SNMP Table Entry."
INDEX { adminReportIndex}
::= { adminReportTable 1 }
AdminReportEntry ::=
SEQUENCE
{
adminReportIndex     OCTET STRING,
adminReportObjectName OCTET STRING,
adminReportNewUserCount OCTET STRING
}
adminReportIndex OBJECT-TYPE
SYNTAX      OCTET STRING
MAX-ACCESS  not-accessible
STATUS      current
DESCRIPTION "Index column"
::= { adminReportEntry 1  }
adminReportObjectName OBJECT-TYPE
SYNTAX      OCTET STRING
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION "ObjectName column"
::= { adminReportEntry 2  }
adminReportNewUserCount OBJECT-TYPE
SYNTAX      OCTET STRING
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION "Attribute exposed for management"
::= { adminReportEntry 3  }
... Definitions for federatedMBeanServerDelegateTable and
mBeanServerDelegateTable are omitted from this example ...
recordSessionEJBMBeanImplTable OBJECT-TYPE
SYNTAX      SEQUENCE OF RecordSessionEJBMBeanImplEntry
MAX-ACCESS  not-accessible
STATUS      current
DESCRIPTION "Dynamically created table for type
com.bea.medrec.controller.RecordSessionEJBMBeanImpl"
::= { recordSessionEJBMBeanImplTable-Oid 1  }
recordSessionEJBMBeanImplEntry OBJECT-TYPE
SYNTAX      RecordSessionEJBMBeanImplEntry
MAX-ACCESS  not-accessible
STATUS      current
DESCRIPTION "Generated SNMP Table Entry."
INDEX { recordSessionEJBMBeanImplIndex}
::= { recordSessionEJBMBeanImplTable 1 }
RecordSessionEJBMBeanImplEntry ::=
SEQUENCE
{
recordSessionEJBMBeanImplIndex OCTET STRING,
recordSessionEJBMBeanImplObjectName OCTET STRING,
recordSessionEJBMBeanImplTotalRx OCTET STRING
}
recordSessionEJBMBeanImplIndex OBJECT-TYPE
SYNTAX      OCTET STRING
MAX-ACCESS  not-accessible
STATUS      current
DESCRIPTION "Index column"
::= { recordSessionEJBMBeanImplEntry 1  }
recordSessionEJBMBeanImplObjectName OBJECT-TYPE
SYNTAX      OCTET STRING
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION "ObjectName column"
::= { recordSessionEJBMBeanImplEntry 2  }
recordSessionEJBMBeanImplTotalRx OBJECT-TYPE
SYNTAX      OCTET STRING
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION "Attribute exposed for management"
::= { recordSessionEJBMBeanImplEntry 3  }
END

3 WebLogic Server通知の理解

この章では、WebLogic Server SNMPエージェントが生成できる通知について説明します。WebLogic Server SNMPエージェントを構成して、管理対象リソース内で特定のしきい値または条件を検出し、1つまたは複数のSNMPマネージャにレポート(通知)を送信するようにできます。WebLogic Server SNMPエージェントでは、SNMPv1、SNMPv2、およびSNMPv3プロトコルに準拠する通知を生成できます。

この章の内容は以下のとおりです。

- INFORM通知とTRAP通知

- 自動的に生成される通知

- ログ・メッセージ通知

- モニター通知

- 属性変更通知

- WebLogic Server通知のOID

WebLogic Server通知を構成する手順または削除する手順については、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPを使用したWebLogic Serverの監視に関する項を参照してください。

INFORM通知とTRAP通知

SNMPv2またはSNMPv3プロトコルを使用するSNMPエージェントでは、モニターされた属性が定義済みのしきい値に到達すると、2種類の通知のうちの一方を送信できます。

- TRAP。エージェントは、TRAP通知を1回送信し、SNMPマネージャがメッセージを受信したと想定します。

- INFORM。エージェントは、INFORM通知を送信し、SNMPマネージャからの、メッセージを受信したことを示すレスポンスを待機します。マネージャからの応答がなければ、エージェントは通知を再送します。

デフォルトでは、WebLogic Server SNMPエージェントはTRAP通知を送信します。INFORM通知を送信するようにSNMPエージェントを構成する方法については、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのINFORM通知の構成に関する項を参照してください。

自動的に生成される通知

WebLogic Server SNMPエージェントでは、表3-1に記載されている通知を自動的に生成できます。これらの通知には、イベントをより詳細に記述するための名前と値のペア(変数バインド)が含まれているものもあります。

表3-1 自動的に生成される通知

通知

次の時点で生成されます

変数バインド

coldStart

SNMPエージェントをホストするWebLogic Serverインスタンスが起動します。

なし

serverStart

停止していたWebLogic Serverインスタンスが起動します。

管理対象サーバー上のSNMPエージェントがこの通知を生成するのは、ホスト管理対象サーバーの起動時のみです。管理サーバー上のSNMPエージェントは、ドメイン内のどのサーバーが起動してもこの通知を生成します。

サーバーの起動時刻とサーバー名を識別する名前と値のペアが2つ含まれます。

serverShutDown

起動していたサーバーが停止します。

管理対象サーバー上のSNMPエージェントがこの通知を生成するのは、ホスト管理対象サーバーの停止時のみです。管理サーバー上のSNMPエージェントは、ドメイン内のどのサーバーが停止してもこの通知を生成します。

サーバーの停止時刻とサーバー名を識別する名前と値のペアが2つ含まれます。

ログ・メッセージ通知

WebLogic Serverインスタンス上のサブシステムおよびデプロイ可能なモジュール(アプリケーションなど)は、ログ・メッセージを生成してステータスや他の操作データを通知します。

各サーバー・インスタンスは、これらのメッセージをローカル・ログ・ファイルに格納してから、JMX通知としてブロードキャストします。JMX通知をすべてリスニングするようにWebLogic Server SNMPエージェントを設定したり、以下のような条件に基づいてフィルタを設定したりできます。

- メッセージの重大度

- メッセージを生成したサブシステム名

- サブシステムを実行するユーザーID

- 一意のメッセージID

- メッセージ・テキスト内の文字列

たとえば、セキュリティ・サービスのメッセージのうち、重大度レベルがERROR以上のものだけがSNMPエージェントに送信されるように指定できます。SNMPエージェントを設定してメッセージをリスニングする方法については、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPログ・フィルタの作成に関する項を参照してください。

メッセージを受信したエージェントでは、SNMPログ通知が生成されます(図3-1を参照)。

図3-1 ログ・メッセージ通知

ログ・メッセージ通知における変数バインド

この節では、ログ・メッセージ通知によってSNMPマネージャに渡される、変数バインド・フィールドの名前と値のペアについて説明します。

- trapTime: 通知が生成された時刻。

- trapServerName: ログ・メッセージを生成したサーバー・インスタンスの名前。

- trapMachineName: サーバー・インスタンスが稼動するマシンの名前。

- trapLogThreadId: ログ・メッセージのスレッドID。

- trapLogTransactionId: ログ・メッセージのトランザクションID (存在する場合)。トランザクションIDは、トランザクションのコンテキスト内で記録されたメッセージに対してのみ生成されます。

- trapLogUserId: ログ・メッセージのユーザーID。このユーザーIDから、ログ・メッセージの生成に使用されたセキュリティ・コンテキストがわかります。

- trapLogSubsystem: ログ・メッセージを生成したサブシステム。

- trapLogMsgId: ログ・メッセージのログ・メッセージID。

- trapLogSeverity: ログ・メッセージのメッセージ重大度。

- trapLogMessage: ログ・メッセージのテキスト。

ログ・メッセージおよびWebLogic Serverロギング・サブシステムの詳細は、『Oracle WebLogic Serverログ・ファイルの構成とログ・メッセージのフィルタ処理』のWebLogicロギング・サービスの理解に関する項を参照してください。

モニター通知

WebLogicリソースの値が変更されたかどうかを定期的にチェックするには、JMXモニターを設定し、これらのモニターからの通知をSNMPエージェントがリスニングするように構成します。

JMXは、管理データを公開するためのJava EE仕様であり、WebLogic Server管理システムの基礎です。JMX仕様では、管理データおよび管理処理は、管理対象Bean (MBean)を通じて公開されます。WebLogic Server MIBの管理対象オブジェクトは、MBeanとMBean属性に対応します。「MIBモジュールとWebLogic Server MBeanデータ・モデルの関係」を参照してください。

JMXモニターは、WebLogic Server MBeanを指定された間隔でポーリングし、指定のイベント(しきい値への到達など)が発生した場合はWebLogic SNMPエージェントに通知を送ります。SNMPエージェントは通知を生成して、SNMPマネージャに送信します。(図3-2を参照)。

図3-2 モニター通知

監視する属性のデータ型に応じて、次の3種類のJMXモニターを構成できます(属性が戻すデータ型については、Oracle WebLogic Server MBeanリファレンスを参照)。

- カウンタ・モニター
カウンタ・モニターは、Integerオブジェクト型として返されるMBean属性値を監視します。

属性がしきい値の範囲を超えた場合に通知が生成されるように指定できます。値がしきい値を超えると、モニターがしきい値をオフセット値の分だけ増加するように指定することもできます。監視されている属性が新しいしきい値を超えるたびに、しきい値は指定された最大許容しきい値に達するまでオフセット値の分ずつ増加します。

カウンタ・モニターの構成の詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのカウンタ・モニターの作成に関する項を参照してください。

- ゲージ・モニター
ゲージ・モニターは、整数または浮動小数点値として表されるMBean属性の変化を監視します。

属性が、高しきい値または低しきい値を超えた場合に通知が生成されるように指定できます。

ゲージ・モニターの構成の詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのゲージ・モニターの作成に関する項を参照してください。

- 文字列モニター
文字列モニターは、Stringオブジェクトで表される属性の変化を監視します。

属性の値と指定した文字列が一致した場合に通知を生成するように指定することも、属性の値が指定した文字列とは異なる場合に通知を生成するように指定することもできます。

文字列モニターの構成の詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプの文字列モニターの作成に関する項を参照してください。

モニター通知の変数バインド

JMXモニターは、指定したしきい値または条件に対してポーリングを行います。値が指定のしきい値に到達したか、または指定の条件が発生した場合に、エージェントはモニター通知を生成します。WebLogic Server SNMPエージェントには、各モニター通知の変数バインドに、次のような名前と値のペアがあります。

- trapTime: 通知が生成された時刻。

- trapServerName: 通知を生成した属性値を持つローカル・サーバー。

- trapMonitorType: CounterMonitor、StringMonitor、またはGaugeMonitorのいずれか。

- trapMonitorThreshold: 通知をトリガーしたしきい値のASCII表記。

- trapMonitorValue: 通知をトリガーした値のASCII表記。

- trapMBeanName: モニター対象の属性を含むMBeanの名前。

- trapMBeanType: モニター対象の属性を含むMBeanのタイプ。

- trapAttributeName: 通知をトリガーした値を持つ属性の名前。

- trapConfigName: TRAP通知を生成する監視ルールまたはしきい値を定義するSNMP MBeanの名前。

属性変更通知

JMXモニターを使用してWebLogic Serverリソースを定期的にポーリングし、特定のしきい値の範囲を超える変化が属性にないか調べることができますが、属性に何らかの変更があったらすぐに通知を送信するようにSNMPエージェントを構成することもできます。たとえば、JMXモニターを使用して、現在アクティブなJDBC接続の数に変化がないかどうかをポーリングします。アクティブな接続数がしきい値を超えた場合、SNMPエージェントは通知を送信できます。

属性変更通知を送信するようにSNMPエージェントを構成する方法については、Oracle WebLogic Server管理コンソール・オンライン・ヘルプの属性変更の作成に関する項を参照してください。

注意:
実行時MBeanの属性変更の作成はサポートされていません。サポートされているのは、構成MBean属性の属性変更通知のみです。

属性変更通知の変数バインド

属性変更通知の変数バインドには、次のような名前と値のペアが含まれます。

- trapTime: 通知が生成された時刻。

- trapServerName: 管理サーバーの名前。

- trapMBeanName: 属性を含むMBeanの名前。

- trapMBeanType: 属性を含むMBeanのタイプ。

- trapAttributeName: 変更された構成属性の名前。

- trapAttributeChangeType: 値はADD、REMOVE、UPDATEのいずれかです。

- trapAttriruteOldVal: 変更前の属性の値。

- trapAttributeNewVal: 変更後の属性の値。

- trapConfigName: TRAP通知を生成する監視ルールまたはしきい値を定義するSNMP MBeanの名前。

WebLogic Server通知のOID

すべてのWebLogic Server通知のオブジェクト識別子(OID)は、次のWebLogic Server OIDで開始されます。

.1.3.6.1.4.1.140.625

表3-2は、WebLogic Server通知におけるOIDの後続の値を説明しています。

表3-2 WebLogic Server通知のOID

値

次の時点で生成されます

60

ログ通知を送信するためにユーザーが定義した基準と一致するメッセージが、サーバー・インスタンスによって記録されます。

たとえば、.1.3.6.1.4.1.140.625.60です。

65

停止していたWebLogic Serverインスタンスが起動します。

管理対象サーバー上のSNMPエージェントがこの通知を生成するのは、ホスト管理対象サーバーの起動時のみです。管理サーバー上のSNMPエージェントは、ドメイン内のどのサーバーが起動してもこの通知を生成します。

これをserverStart通知と呼びます。

たとえば、.1.3.6.1.4.1.140.625.65です。

70

起動していたサーバーが停止します。

管理対象サーバー上のSNMPエージェントがこの通知を生成するのは、ホスト管理対象サーバーの停止時のみです。管理サーバー上のSNMPエージェントは、ドメイン内のどのサーバーが停止してもこの通知を生成します。

これをserverShutDown通知と呼びます。

たとえば、.1.3.6.1.4.1.140.625.70です。

75

ユーザーが定義したJMXモニターが、しきい値への到達またはイベントの発生を検出します。

たとえば、.1.3.6.1.4.1.140.625.75です。

80

ユーザーが選択した属性の値が変更されました。

たとえば、.1.3.6.1.4.1.140.625.80です。

変数バインドが含まれる通知もあります。変数バインドのOIDについては、「WebLogic Server用のMIBモジュール」を参照してください。

4 SNMPプロキシの理解

この章では、WebLogic ServerおよびSNMPプロキシ・エージェントの基礎情報について説明します。WebLogic Serverエージェントを他のSNMPエージェントのプロキシとして構成する手順については、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPプロキシの作成に関する項を参照してください。

この章の内容は以下のとおりです。

- 他のエージェント用のプロキシとしてのSNMPエージェント

- Microsoft Windows SNMPサービス

他のエージェント用のプロキシとしてのSNMPエージェント

WebLogic SNMPエージェントは、他のSNMPエージェントにリクエストを転送(プロキシ)する、マスター・エージェントとして機能できます。WebLogic Serverエージェントのマスター・エージェント機能を使用する場合は、登録ツリー(OIDツリー)のブランチを、他のSNMPエージェントの責任として割り当てます。SNMPマネージャがWebLogic SNMPエージェントにリクエストを送信したときに、リクエストされたオブジェクトのOIDがプロキシされたエージェントに割り当てられたOIDツリーのブランチ下にあれば、WebLogic SNMPエージェントはリクエストを、プロキシされたエージェントに転送します。

注意:
WebLogic Server SNMPエージェントは、他のWebLogic ServerドメインのSNMPエージェントのプロキシとしては使用できません。たとえば、domainA内のWebLogic Serverエージェントは、domainB内のWebLogic Serverエージェントへのリクエストをプロキシすることはできません。これは、すべてのWebLogic Serverエージェントで同じMIBルートが使用されることに伴う制限です。
複数のWebLogic Serverドメインへリクエストをプロキシするかわりに、すべてのサーバー・インスタンスを単一ドメインに置き、リクエストを各管理対象サーバーへ直接送信できます。「リクエストのスコープの限定」を参照してください。

プロキシされた通信のSNMPプロトコルの構成

WebLogic SNMPエージェントにより他のエージェントへのリクエストがプロキシされる場合、その通信プロセスは、個々のイベント(会話)によって構成され、イベントごとに異なるSNMPプロトコルを使用できます(図4-1を参照)。

- SNMPマネージャとWebLogic SNMPエージェント間の通信。
WebLogic SNMPエージェントでは、SNMPv1、v2、またはv3のプロトコルを使用するリクエストを受信できます。SNMPv1またはv2のリクエストをエージェントが拒否するようにするには、通信ベースのアクセスを無効化します。Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPエージェントの作成に関する項を参照してください。

- WebLogic SNMPエージェントとプロキシされたエージェント間の通信。
マネージャとWebLogic SNMPエージェントの間で使用されるプロトコルが何であるかに関係なく、WebLogic SNMPエージェントがSNMPv1またはv3リクエストを、プロキシされたエージェントに転送するかどうかを指定できます。

プロキシの構成時にセキュリティ名を指定すると、WebLogic SNMPエージェントではプロキシされたエージェントとの通信に、必ずSNMPv3が使用されます。セキュリティ名を設定しなければ、WebLogic SNMPエージェントでは必ずSNMPv1が使用されます。Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPプロキシの作成に関する項を参照してください。

図4-1 プロキシされたSNMP通信のための個別の会話

プロキシされた通信に対する資格証明の指定

WebLogic SNMPエージェントは、マネージャからのリクエストを受信すると、リクエスト自体を処理するのか、プロキシされたエージェントに転送するのかを判断する前に、必ずそのリクエストに対する他のセキュリティ操作を認証および実行します。したがって、SNMPマネージャとWebLogic SNMPエージェント間の通信に使用されるプロトコルまたは資格証明が何であろうと、WebLogic SNMPエージェントは、プロキシされたエージェントとの会話のために、独自の資格証明を提供します。

プロキシされたエージェントとの通信に、SNMPv1を使用する場合は、WebLogic Server管理コンソールでコミュニティ名を指定することにより、セキュアな通信を実現します。デフォルトでは、WebLogic SNMPエージェントはコミュニティ名としてpublicを送信します。プロキシされたエージェントとの通信にSNMPv3を使用する場合は、セキュリティ名とセキュリティ・レベルを設定します。Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPプロキシの作成に関する項を参照してください。

プロキシされたエージェントのリスニング・ポートの選択

デフォルトでは、WebLogic SNMPエージェントはポート161で管理リクエストをリスニングします。WebLogic SNMPエージェントで他のSNMPエージェントのプロキシを行う場合、それらの他のエージェントは、それ以外のポートでSNMP管理リクエストをリスニングするように構成する必要があります。WebLogic Server SNMPエージェントの構成の手順については、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPエージェントの作成に関する項を参照してください。

Microsoft Windows SNMPサービス

WebLogic Server SNMPエージェントは他のSNMPエージェントのプロキシになることができますが、Microsoft Windows SNMPエージェント・サービスのサブエージェントとして構成することはできません。

Microsoft Extension Agent APIを使用すると、Microsoft Windows 2000 SNMPエージェント・サービスを他のSNMPエージェントのプロキシにすることができます。ただし、WebLogic Serverはこの機能をサポートしていないため、Windows SNMPエージェントをプロキシとして使用できません。

5 WebLogic SNMPコマンドライン・ユーティリティ

この章では、SNMPマネージャと同じ機能の多くを提供するSNMPコマンドライン・ユーティリティについて説明します。このユーティリティは、WebLogic Serverドメイン内のSNMPエージェントの構成に対するテストとトラブルシューティングに使用できます。

この章の内容は以下のとおりです。

- SNMPコマンドライン・ユーティリティの環境要件

- SNMPコマンドライン・ユーティリティの構文とコマンド

- 例

SNMPコマンドライン・ユーティリティの環境要件

WebLogic Server SNMPコマンドライン・ユーティリティ用に環境を設定するには:

1. インストレーション・ガイドの説明に従って、WebLogic Serverソフトウェアをインストールおよび構成します。

2. SNMPエージェントと、トラップ宛先をWebLogic Serverドメイン内に作成します。Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPを使用したWebLogic Serverの監視に関する項を参照してください。

3. コマンド・プロンプト(シェル)を開いて、次のスクリプトを呼び出します。
WL_HOME\server\bin\setWLSEnv.sh (WindowsではsetWLSEnv.cmd)

ここで、WL_HOMEは、WebLogic Serverのインストール先ディレクトリです。

このスクリプトを実行すると、シェルのPATH環境変数にはサポートされるJDKが追加され、CLASSPATH変数にはWebLogic Serverクラスが追加されます。

SNMPコマンドライン・ユーティリティの構文とコマンド

次の構文を使用して、SNMPコマンドライン・ユーティリティを呼び出します。

java weblogic.diagnostics.snmp.cmdline.Manager command [-?]

前述の構文のcommandは、表5-1に記載されているコマンドのいずれかを示します。オプションの引数-?を使用して、指定したコマンドの使用情報を取得します。

表5-1 SNMPコマンド

コマンド

説明

SnmpBulkWalk
[startingOID] [endingOID]

指定したパターンでSnmpGetNextを繰返し呼び出すことにより、MIBオブジェクトインスタンス (MIB変数)の集合を返します。

コマンド・ラインで指定した最初のOIDから開始して、オブジェクトの下にあるすべてのMIB変数を取得するのに必要な回数、SnmpGetNextコマンドを呼び出します。

コマンド・ラインで指定したOIDをインクリメントして、前述のパターンを繰り返します。

オプションとして-Bm引数を指定すると、SNMPエージェントに送信する各リクエスト内の複数のSnmpGetNextの呼出しがグループ化されます。たとえば、-Bm 3を指定すると、シーケンス内の最後のOIDに到達するまで、各リクエストにおいて3回のSnmpGetNext呼出しが発行されます。

SnmpInform

INFORM通知を構築し、SNMPマネージャまたはトラップ・モニターに配信します。

SnmpGet

1つまたは複数のMIB変数の値を取得します。このコマンドでは、管理対象オブジェクトのOIDは使用できません。

指定した変数の値が繰返し取得されるように、必要に応じて間隔を指定することができます。

SnmpGetAll <columnOID>
[<columnOID>...]

指定した表の列を確認して、出力内の各行に対する列値をグループ化します。指定された列はすべて、同じ表のものであることが必要です。

SnmpGetBulk
[OIDs]

指定したパターンでSnmpGetNextを繰返し呼び出すことにより、MIB変数の集合を返します。オプションでパターンの指定には、-Bnおよび-Bm引数と、1つ以上のOIDを含まれています。

-Bn (非リピータ)引数は、コマンドがSnmpGetNext操作を繰返し実行することのないコマンド・ラインに対して、OID引数の数を指定します。これらのOIDに関しては、コマンドはSnmpGetNext操作を一度実行してから、コマンド・ライン上の次のOID引数に進みます。スカラー・オブジェクトに対しては、-Bnおよび非リピータOIDの使用を検討してください。

-Bm (繰返し上限)引数は、コマンド・ライン上の他のすべてのOIDに対して、コマンドがSnmpGetNext操作を実行する回数を指定します。表形式のオブジェクトに対しては、-Bmおよびそれに関連付けられたOIDの使用を検討してください。

SnmpGetNext

管理対象オブジェクトまたはMIB変数を返します。表形式のオブジェクトを指定した場合、最初の子管理対象オブジェクトが返されます。スカラー・オブジェクトを指定した場合、オブジェクトの最初の変数が返されます。

SnmpWalkコマンドが提供する再帰的なリストとは異なり、このコマンドでは、OIDの順序が次となる管理対象オブジェクトまたは変数1つのみに関する説明を返します。一連のSnmpGetNextコマンドを並べて指定すると、SnmpWalkコマンドと同じ結果が得られます。

SnmpTrap

TRAP通知を構築し、SNMPマネージャまたはトラップ・モニターに配信します。

SnmpTrapLogger

通知をリスニングするプロセスを開始します。受信した各通知を、ログ・ファイルに書き込みます。

SnmpTrapMonitor

通知をリスニングするプロセスを開始します。受信した各通知を、標準出力へ出力します。

SnmpWalk

MIB内の指定されたノード以下に、または指定された範囲内にあるすべての管理対象オブジェクトまたは変数を返します。

表形式のオブジェクトOIDを指定すると、コマンドはそのすべてのオブジェクト変数と、関連するすべての子オブジェクトおよび変数を返します。

例

この節のサンプルでは、管理サーバー上にSNMPエージェントを作成済みであり、エージェントのデフォルト変数を変更していないということが前提となっています(たとえば、エージェントはUDPポート161をリスニングし、コミュニティ名としてpublicを使用します)。

これらの例では、MIBモジュールのロードに次のオプションが使用され、これにより、管理対象オブジェクトをOIDではなく、その表示名で参照できるようになります。

- -mは、WebLogic Server MIBモジュールBEA-WEBLOGIC-MIBを指定します。

- -Mは、コンパイルしたMIBのディレクトリ、またはリソース・クラスパースを指定します。これらの例では、リソース・クラスパースが使用されています。

すべてのWebLogic Server管理対象オブジェクトの表示名を確認するには、「WebLogic Server用のMIBモジュール」を参照してください。

- 次の例では、SnmpWalkコマンドの使用情報を表示します。
java weblogic.diagnostics.snmp.cmdline.Manager SnmpWalk -?

- 次の例では、ドメインにデプロイされているすべてのアプリケーションの名前を取得します。

java weblogic.diagnostics.snmp.cmdline.Manager SnmpWalk
-m BEA-WEBLOGIC-MIB -M /weblogic/diagnostics/snmp/mib
applicationRuntimeObjectName

- 以下のコマンドでは、ドメイン内のすべてのアプリケーションのすべての変数バインドを取得します。ネットワーク通信の効率を上げるため、各リクエスト内で3つのSnmpGetBulkコマンドをグループ化しています。

java weblogic.diagnostics.snmp.cmdline.Manager SnmpBulkWalk -v2 -Bm 3
-m BEA-WEBLOGIC-MIB -M /weblogic/diagnostics/snmp/mib
applicationRuntimeTable

- 以下のコマンドでは、ドメイン内で最初にデプロイされたアプリケーションの名前を取得します。その後、ドメイン内の最初の2つのJMSサーバーの名前と保留中のバイト数を取得します。

java weblogic.diagnostics.snmp.cmdline.Manager SnmpGetBulk -v2
-Bn 1 -Bm 2 applicationRuntimeObjectName
jmsServerRuntimeObjectName jmsServerRuntimeBytesPendingCount

オラクルの法律上の注意点について

コピーライトについて

Copyright © 1994-2016, Oracle and/or its affiliates.All rights reserved.

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクルまでご連絡ください。

制限付権利について

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、Oracle Corporationおよびその関連会社は一切の責任を負いかねます。

商標と登録商標について

OracleおよびJavaはオラクルおよびその関連会社の登録商標です。その他の社名、商品名等は各社の商標または登録商標である場合があります。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

アルファ版およびベータ版ドラフト・ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。Oracle Corporationおよびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

非公開のアルファ版およびベータ版ドラフト・ドキュメントについて

このドキュメントが非公開の試作版の場合:

このドキュメントに含まれる情報は、情報の共有のみを目的としたものであって、顧客諮問委員会(Customer Advisory Board)のメンバーとしてのお客様の立場でのみ、またはお客様のベータ・トライアル契約のみに従って検討されるべきものとします。マテリアル、コード、または機能の提供をお約束するものではなく、購入決定を行う際の判断材料とすべきではありません。このドキュメントに記載されている特徴または機能の開発、リリースおよび時期については、オラクルの裁量により決定されます。

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle PartnerNetwork Agreement、Oracle Distribution Agreementまたはその他のライセンス契約の条件に従うものとします。このドキュメントとその内容の開示、コピー、複製および配布には、オラクルによる事前の承諾を必要とします。このドキュメントはライセンス契約の一部となるものではなく、オラクルおよびその子会社や関連会社との契約を構成するものではありません。

ドキュメントのアクセシビリティについて

オラクルのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc を参照してください。

Oracle Supportへのアクセス

サポートをご契約のお客様には、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoか、聴覚に障害のあるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。