この章では、Oracle BAMを使用してOracle B2Bインスタンス・メッセージの監視を設定する方法を詳細に説明します。
Oracle B2B-BAM統合はOracle XEデータベースでは動作しません。Oracle 10g EEおよびOracle 11g EEのバージョンでは動作します。
項目は次のとおりです。
Oracle BAMでは、データの流入をリアルタイムに表示するダッシュボード、および指定した条件でアラートを送信するためのルールを作成するためのフレームワークが提供されています。この章の手順に従うことで、Oracle B2Bインスタンスを監視するようにOracle BAMを構成できます。
注意: インスタンス・メッセージ・テーブルで定義されている外部データ・ソースでOracle BAMダッシュボードを作成することもできますが、外部データ・ソースではアクティブ・データがサポートされていないため、結果のレポートではリアルタイムの更新が表示されません。 |
既存のデータ・ソースがある場合はそれを使用できます。または、次の手順に従って新しいデータ・ソースを作成することもできます。
Oracle WebLogic Server管理コンソールを開いてログインします。
http://host_name:port_number/console
host_name
はOracle BAMがインストールされているマシンの名前で、Oracle WebLogic Serverのデフォルトのport_number
は7001です。
「JDBC」セクションで「データ・ソース」を選択し、「新規」をクリックします。
データ・ソースを構成します。
データ・ソースの「名前」を入力します(例: BAMAQDataSource
)。
データ・ソースのJNDI名を入力します(例: jdbc/oracle/bamaq
)。この名前は、外部JMSサーバーの構成に使用されます。
「データベースのタイプ」で「Oracle」を選択します。
「データベース・ドライバ」でOracleのドライバ(シン)を選択します。
「次へ」をクリックします。
グローバル・トランザクションをサポートするの選択を解除し、「次へ」をクリックします。
「データベース名」フィールドにデータベースのSIDを入力します(例: ORCL
)。
「ホスト名」としてデータベースがインストールされているマシンのホスト名を入力します(例: localhost
)。
データベースの「ポート」番号を入力します(例: 1521
)。
「ユーザー名」と「パスワード」を入力し、「次へ」をクリックします。
「構成のテスト」をクリックします。
テストが成功したら、「次へ」をクリックします。
Oracle BAMがデプロイされているサーバーを選択し、「終了」をクリックします。
外部JMSサーバーを作成する手順は、次のとおりです。
Oracle WebLogic Server JMSモジュールを追加します。
Oracle WebLogic Server管理コンソールのホーム・ページで、「JMSモジュール」ページに移動します。
「新規」をクリックして、新しいOracle WebLogic Server JMSモジュールを作成します。
JMSモジュールの名前(例: BAMAQsystemModule
)を入力し、「次へ」をクリックします。
Oracle BAMがデプロイされているサーバーとしてターゲットを割り当て、「次へ」をクリックし、「終了」をクリックします。
注意: サブデプロイメントを作成することをお薦めします。「JMSモジュール」→「サブデプロイメント」→「新規」を選択します。以降の手順で「サブデプロイメント」タブがある場合はサブデプロイメントを使用します。 |
リストから選択して、サブデプロイメントをJMSサーバーに対するターゲットします。
AQ JMS外部サーバーをJMSモジュールに追加します。
作成したJMSモジュールを選択します。
「新規」をクリックし、JMSリソースのリストに進みます。
「外部サーバー」オプションを選択し、「次へ」をクリックします。
外部サーバーの「名前を入力し(例: BAMAQForeignServer
)、「終了」をクリックします。
AQ JMS外部サーバーを構成します。
作成したAQ JMS外部サーバーを選択します。
「JNDI初期コンテキスト・ファクトリ」フィールドに「oracle.jms.AQjmsInitialContextFactory
」と入力します。
「JNDIプロパティ」フィールドに「datasource=
data_source_jndi_location
」と入力します。data_source_jndi_location
は、データ・ソースのJNDIの場所です(例: jdbc/oracle/bamaq
)。
「デフォルトのターゲット指定を有効化」チェック・ボックスを選択します。
接続ファクトリをAQ JMS外部サーバーに追加します。
作成したAQ JMS外部サーバーを選択します。
「接続ファクトリ」タブを選択します。
接続ファクトリの名前を入力します。これは、Oracle WebLogic Serverによって参照される論理名です。
Oracle BAMエンタープライズ・メッセージ・ソースがこの接続ファクトリを検索するために使用するローカルJNDI名を、「ローカルJNDI名」フィールドに入力します(例: jms/BAMAQQueueCF
)。
「リモートJNDI名」フィールドに「QueueConnectionFactory
」と入力します。
注意: 次に示すのは使用可能な代替オプションです。この接続ファクトリをグローバル・トランザクションで使用する場合は、XAベースの接続ファクトリを選択します。それ以外の場合は、XAベースではない接続ファクトリを選択します。
|
「OK」をクリックします。
宛先をAQ JMS外部サーバーに追加します。
作成したAQ JMS外部サーバーを選択します。
「宛先」タブを選択します。
宛先の名前を入力します。これは、Oracle WebLogic Serverによって参照される論理名です。宛先名とは関係ありません。
Oracle BAMエンタープライズ・メッセージ・ソースが宛先を検索するために使用するローカルJNDI名を、「ローカルJNDI名」フィールドに入力します(例: jms/BAMAQQueue
)。
「リモートJNDI名」フィールドには、宛先がキューの場合は「Queues/
queue_name
」と入力し、宛先がトピックの場合は「Topics/
topic_name
」と入力します。
たとえば、Oracle B2B - Oracle BAM統合に対して作成されるAQキューのデフォルトの名前はQueues/B2B_BAM_QUEUE
です。
「OK」をクリックします。
Oracle WebLogic Serverを再起動します。
B2B データ・オブジェクトを作成する手順は、次のとおりです。
次のURLでOracle BAMにログインします。
http://host_name:port_number/OracleBAM
デフォルトのポート番号は9001です。
「アーキテクト」を選択して、Oracle BAMアーキテクト・アプリケーションを開きます。
ドロップダウン・リストで「データ・オブジェクト」を選択します。
「サンプル」フォルダを選択し、B2Bという名前のサブフォルダを作成します。
「データ・オブジェクトの作成」リンクをクリックします。
「名前」フィールドに「B2BDO
」と入力します。
「フィールドの追加」をクリックします。
「データ・オブジェクト内のフィールド」に値を入力します。
「フィールドの追加」を繰り返しクリックし、表23-2に示されているすべてのフィールドを追加します。
Oracle BAM データ・オブジェクトの作成の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のOracle BAMデータ・オブジェクトの定義と管理に関する項を参照してください。
JMSメッセージ・ソースを定義する手順は、次のとおりです。
次のURLでOracle BAMにログインします。
http://host_name:port_number/OracleBAM
デフォルトのポート番号は9001です。
「アーキテクト」を選択して、Oracle BAMアーキテクト・アプリケーションを開きます。
ドロップダウン・リストで「エンタープライズ・メッセージ・ソース」を選択します。
「作成」をクリックし、表23-1で示されているようにAQ JMSキューのエンタープライズ・メッセージ・ソース情報を入力します。表で示されていないフィールドはデフォルトまたは空白のままにします。
表23-1 AQ JMSキューのエンタープライズ・メッセージ・ソース・プロパティ
プロパティ | 値と例 |
---|---|
名前 |
エンタープライズ・メッセージ・ソースの表示名を入力します(例: |
初期コンテキスト・ファクトリ |
「weblogic.jndi.WLInitialContextFactory」と入力します |
JNDIサービス・プロバイダURL |
「t3://localhost:9001」と入力します 注意: Oracle BAMが管理サーバーにインストールされている場合は、ポート9001を使用します。Oracle BAMが管理対象サーバーにインストールされている場合は、デフォルトのポート7001、またはシステム管理者が構成したポート番号を使用します。 |
トピック/キュー・コネクション・ファクトリ名 |
コネクション・ファクトリの名前を入力します(例: jms/BAMAQQueueCF)。 |
トピック/キュー名 |
JJMSトピック(またはキュー)の名前を入力します(例: jms/BAMAQQueue)。 |
データ・オブジェクト名 |
AQ JMSサーバーから受信した値を送信するB2Bデータ・オブジェクトを選択します。 |
操作 |
使用方法に応じて、「挿入」操作または「アップサート」操作を選択します。 |
「ソース値フォーマット」を構成するには、「日時仕様」チェック・ボックスを選択し、ドロップダウン・リストで「MM/dd/yy H:mm:ss」形式を選択します。
注意: 受信XML値の日時の形式がMM/dd/yy HH24:MI:SS である場合は、データ・オブジェクトに正しく格納できるように、エンタープライズ・メッセージ・ソースで想定されているMM/dd/yy H:mm:ss という形式に変換する必要があります。 |
受信XMLのデータがB2Bデータ・オブジェクトの適切なフィールドにマップされるよう、「ソースからデータ・オブジェクト・フィールドへのマッピング」を設定します。B2Bインスタンス・テーブルから取得される受信XMLのフィールドのリストについては、表23-2を参照してください。
「保存」をクリックします。
B2B_EMS
エンタープライズ・メッセージ・ソースを選択し、「開始」をクリックします。数秒でステータスが「起動済」に変わります。
エンタープライズ・メッセージ・ソースを開始した後は、データベース・ジョブによってAQ JMSキューに挿入されたメッセージは、B2BDOデータ・オブジェクトですぐに使用できるようになります。
B2BDOデータ・オブジェクトの内容を見るには、Oracle BAMアーキテクトのドロップダウン・メニューから「データ・オブジェクト」を選択します。B2BDOオブジェクトを参照して選択します。内容を表示するには「コンテンツ」をクリックします。
データベース・ジョブがB2Bインスタンス・テーブルから受信メッセージを読み取り、それをAQ JMSキューに挿入すると、B2BDOに新しい行が挿入されます。
Oracle BAMエンタープライズ・メッセージ・ソースの作成の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のOracle BAMエンタープライズ・メッセージ・ソースの作成に関する項を参照してください。
表23-2に、Oracle B2Bインスタンス・メッセージのフィールドを示します。これらのフィールドを使用すると、Oracle BAMでデータ・オブジェクトとエンタープライズ・メッセージ・ソースを設計して、Oracle B2Bのパフォーマンスをリアルタイムで監視できます。
次の一覧にはペイロード(APP_PAYLOAD
、PAYLOAD
、WIREPAYLOAD
)は含まれないことに注意してください。パフォーマンスのためペイロードは転送されません。
表23-2 Oracle B2Bインスタンス・メッセージのフィールド
フィールド | 型 |
---|---|
ID |
NOT NULL VARCHAR2(256) |
REFERTOID |
VARCHAR2(256) |
B2BMESSAGEID |
NOT NULL VARCHAR2(256) |
ACKNOWLEDGEMODE |
VARCHAR2(256) |
MESSAGEDATETIME |
DATE |
MESSAGETYPE |
VARCHAR2(256) |
STATE |
VARCHAR2(256) |
REMAININGRETRY |
NUMBER(10) |
DIRECTION |
VARCHAR2(256) |
TIMETOACK |
VARCHAR2(256) |
TPA_NAME |
VARCHAR2(256) |
XPATH_EXPRESSION1 |
VARCHAR2(1024) |
XPATH_EXPRESSION2 |
VARCHAR2(1024) |
XPATH_EXPRESSION3 |
VARCHAR2(1024) |
XPATH_NAME1 |
VARCHAR2(256) |
XPATH_NAME2 |
VARCHAR2(256) |
XPATH_NAME3 |
VARCHAR2(256) |
XPATH_VALUE1 |
VARCHAR2(256) |
XPATH_VALUE2 |
VARCHAR2(256) |
XPATH_VALUE3 |
VARCHAR2(256) |
DOCUMENT_DEFINITION |
VARCHAR2(256) |
CREATED |
DATE |
MODIFIED |
DATE |
SEND_TIMESTAMP |
DATE |
RECEIVE_TIMESTAMP |
DATE |
NATIVE_MSG_SIZE |
NUMBER(10) |
TRANSLATED_MSG_SIZE |
NUMBER(10) |
BM_RESUBMIT_COUNT |
NUMBER(10) |
ERRORCODE |
VARCHAR2(256) |
ERRORTEXT |
VARCHAR2(1024) |
ERRORDESCRIPTION |
VARCHAR2(2000) |
PROCESSING_TIME |
NUMBER(10) |
DOCUMENTTYPE |
VARCHAR2(513) |
CORRELATIONID |
VARCHAR2(256) |
FABRIC_ECID |
VARCHAR2(512) |
FABRIC_COMPOSITE_NAME |
VARCHAR2(512) |
AM_RESUBMIT_COUNT |
NUMBER(10) |
TRANSACTIONCONTROLNUMBER |
VARCHAR2(256) |
GROUPCONTROLNUMBER |
VARCHAR2(256) |
INTERCHANGECONTROLNUMBER |
VARCHAR2(256) |
PROTOCOLWORKAREA |
CLOB |
B2BWIREMESSAGEID |
VARCHAR2(256) |
B2BTIMESTAMP |
DATE |
CONVERSATIONID |
VARCHAR2(1024) |
PROTOCOLMESSAGEID |
VARCHAR2(1024) |
URL |
VARCHAR2(1024) |
TRANSPORTPROTOCOL |
VARCHAR2(513) |
TRANSPORTHEADERS |
VARCHAR2(2000) |
WM_RESUBMIT_COUNT |
NUMBER(10) |
DOCUMENTPROTOCOL |
VARCHAR2(513) |
EXCHANGEPROTOCOL |
VARCHAR2(513) |
AGREEMENTID |
VARCHAR2(256) |
SENDERNAME |
VARCHAR2(256) |
SENDERID |
VARCHAR2(513) |
RECEIVERNAME |
VARCHAR2(256) |
RECEIVERID |
VARCHAR2(513) |
リアルタイム監視ダッシュボードは、Oracle BAMアクティブ・スタジオを使用して作成します。B2BDOデータ・オブジェクトを使用してOracle B2Bを監視するには、ダッシュボードを作成します。
簡単なレポートを作成する手順は、次のとおりです。
次のURLでOracle BAMにログインします。
http://host_name:port_number/OracleBAM
デフォルトのポート番号は9001です。
「アクティブ・スタジオ」を選択して、Oracle BAMアクティブ・スタジオ・アプリケーションを開きます。
「新規レポートの作成」をクリックします。
4分割の場合は「タイル表示レポート」を選択します。
左上の領域で、「棒グラフ」を選択します(2回クリックする必要がある場合があります)。
サンプルの棒グラフが表示されて、「Oracle BAMアクティブ・スタジオ」ウィンドウの下部にビュー・エディタが開きます。
ビュー・エディタの「データ・オブジェクト」の選択で、「B2BDO」を選択して「次へ」をクリックします。
「グループ化」リストで、「State」を選択します。
「グラフの値」リストで「b2bMessageId」を選択し、「次へ」をクリックします。
「ビュー・プロパティの変更」をクリックして、次の情報を入力します。
「ビュー・タイトル」フィールドには、「B2B State
」と入力します。
「凡例の表示」チェック・ボックスを選択します。
「OK」をクリックします。
同様に、『Oracle Fusion Middleware Oracle Business Activity Monitoringユーザーズ・ガイド』の説明に従って、ダッシュボードの他の領域の表示情報を作成します。
たとえば、他の3つの領域では、メッセージのdocumentProtocol
、exchangeProtocol
またはdirection
でグループ化できます。
各領域の表示の構成が終了したら、ダッシュボードを保存します。
Oracle BAMのメイン・ページに移動し、「アクティブ・ビューア」を選択します。
作成したダッシュボードを選択して、Oracle BAMアクティブ・ビューアで表示します。
b2b_instancemessage
ビューで新しいインスタンスが作成されるとダッシュボードの表示が自動的に更新され、データがB2BDO
データ・オブジェクトに格納されます。変更は即座に反映されます。
Oracle BAMダッシュボードの作成の詳細は、『Oracle Fusion Middleware Oracle Business Activity Monitoringユーザーズ・ガイド』を参照してください。
Oracle B2BでOracle BAMの統合を有効にするには、Oracle B2Bの「管理」→「構成」タブで次のプロパティを設定します。
「BAMの有効化」 - true
に設定します。b2b.enableBAM
をtrueに設定すると、Oracle B2Bのユーザー・インタフェースはデータベースでデータベース・ジョブを自動的に開始し、b2b_instancemessage
ビューで新しいインスタンスを監視します。b2b.enableBAM
をfalse
に設定すると、ユーザー・インタフェースはデータベース・ジョブをデータベースから自動的に削除します。
「BAMポーリング間隔」 – データベース・ジョブがOracle B2Bインスタンス・テーブルで更新をポーリングし、Oracle BAMによる取得のためにAQ JMSキューに格納する間隔(分単位)です。0.5分のように分未満の値も指定できます。