B Oracle Service Busでのデバッグ

この章ではOracle Service Busの各種モジュールのデバッグを有効にする方法について説明します。

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

B.1項「Oracle Service Busのデバッグ」
B.2項「Eclipseでのプロキシ・サービスおよび分割-結合のデバッグ」

B.1 Oracle Service Busでのデバッグ

デバッグを有効または無効にするには、Oracle Service Busドメインのルート・ディレクトリにある次のデバッグXMLファイル内の対応するエントリを変更します。

alsbdebug.xml - Oracle Service Bus関連のデバッグ・フラグが含まれます。
configfwkdebug.xml - 構成関連のデバッグ・フラグが含まれます。

これらのXMLファイルがルート・ディレクトリにない場合、または削除されている場合は、サーバーの起動時に内容を含まないファイルが再度作成されます。例B-1は、すべてのモジュールのデバッグを無効にした(すべてのエントリをfalseに設定した)alsbdebug.xmlファイルの内容の例を示しています。

例B-1 alsbdebug.xmlファイル

<java:sb-debug-logger xmlns:java="java:com.bea.wli.debug">
  <java:alsb-stages-transform-runtime-debug>true</java:alsb-stages-transform-runtime-debug> 
  <java:alsb-alert-manager-debug>false</java:alsb-alert-manager-debug> 
  <java:alsb-credential-debug>false</java:alsb-credential-debug> 
  <java:alsb-jms-reporting-provider-debug>false</java:alsb-jms-reporting-provider-debug> 
  <java:alsb-management-credential-debug>false</java:alsb-management-credential-debug> 
  <java:alsb-management-dashboard-debug>false</java:alsb-management-dashboard-debug> 
  <java:alsb-management-debug>false</java:alsb-management-debug> 
  <java:alsb-management-user-mgt-debug>false</java:alsb-management-user-mgt-debug> 
  <java:alsb-module-debug>true</java:alsb-module-debug> 
  <java:alsb-monitoring-aggregator-debug>false</java:alsb-monitoring-aggregator-debug> 
  <java:alsb-monitoring-debug>false</java:alsb-monitoring-debug> 
  <java:alsb-pipeline-debug>true</java:alsb-pipeline-debug> 
  <java:alsb-security-wss-debug>true</java:alsb-security-wss-debug> 
  <java:alsb-service-account-manager-debug>false</java:alsb-service-account-manager-debug> 
  <java:alsb-service-provider-manager-debug>false</java:alsb-service-provider-manager-debug> 
  <java:alsb-service-repository-debug>false</java:alsb-service-repository-debug> 
  <java:alsb-service-security-manager-debug>false</java:alsb-service-security-manager-debug> 
  <java:alsb-service-validation-debug>false</java:alsb-service-validation-debug> 
  <java:alsb-test-console-debug>false</java:alsb-test-console-debug> 
  <java:alsb-transports-debug>true</java:alsb-transports-debug> 
  <java:alsb-uddi-debug>true</java:alsb-uddi-debug> 
  <java:alsb-wsdl-repository-debug>false</java:alsb-wsdl-repository-debug> 
  <java:alsb-wspolicy-repository-debug>true</java:alsb-wspolicy-repository-debug> 
  <java:alsb-security-encryption-debug>false</java:alsb-security-encryption-debug> 
  <java:alsb-security-module-debug>false</java:alsb-security-module-debug> 
  <java:alsb-sources-debug>false</java:alsb-sources-debug> 
  <java:alsb-proxy-server-manager-debug>true</java:alsb-proxy-server-manager-debug> 
  <java:alsb-custom-resource-debug>false</java:alsb-custom-resource-debug> 
  <java:alsb-mqconnection-debug>false</java:alsb-mqconnection-debug> 
  <java:alsb-throttling-debug>true</java:alsb-throttling-debug> 
  <java:alsb-flow-resource-debug>false</java:alsb-flow-resource-debug> 
  <java:alsb-flow-transport-debug>false</java:alsb-flow-transport-debug> 
  <java:alsb-flow-deployment-debug>false</java:alsb-flow-deployment-debug> 
  <java:alsb-soa-codec-debug>true</java:alsb-soa-codec-debug> 
  <java:alsb-message-tracing-debug>true</java:alsb-message-tracing-debug> 
  <java:alsb-result-caching-debug>true</java:alsb-result-caching-debug> 
  <java:alsb-console-debug>false</java:alsb-console-debug> 
  <java:alsb-bpel-debug>false</java:alsb-bpel-debug> <!-- Split-Join processing details -->
  <java:alsb-jca-framework-adapter-debug>true</java:alsb-jca-framework-adapter-debug> 
</java:sb-debug-logger>

例B-2は、configfwkdebug.xmlファイルの内容の例を示しています。

例B-2 configfwkdebug.xmlファイル

<java:config-fwk-debug-logger xmlns:java="java:com.bea.wli.config.debug">
  <n1:Name xmlns:n1="java:weblogic.diagnostics.debug">configfwkdebug</n1:Name> 
  <java:config-fwk-debug>false</java:config-fwk-debug> 
  <java:config-fwk-transaction-debug>false</java:config-fwk-transaction-debug> 
  <java:config-fwk-deployment-debug>false</java:config-fwk-deployment-debug> 
  <java:config-fwk-component-debug>false</java:config-fwk-component-debug> 
  <java:config-fwk-security-debug>false</java:config-fwk-security-debug> 
</java:config-fwk-debug-logger>

デバッグは、通常のOracle Service Busの操作では無効にしておく必要がありますが、開発中のソリューションを初めてテストするときには一定のデバッグ・フラグをオンにしておくと便利です。たとえば、アラートの開発中にアラート・エンジンの動作を確認する場合、アラートのデバッグ・フラグを有効にすることができます。

使用可能なOracle Service Busデバッグ・フラグの一部を、表B-1に示します。

表B-1 Oracle Service Busデバッグ・フラグ

デバッグ・フラグ	アクション
alsb-stages-transform-runtime-debug	トランスフォーメーション関連のアクションに関する情報を提供します。
alsb-alert-manager-debug	アラートの評価を出力します。
alsb-jms-reporting-provider-debug	すぐに使用可能なJMSベースのレポート・プロバイダに関する情報を提供します。
alsb-management-debug	コンソールでのユーザーとグループの管理に関する情報を提供します。
alsb-monitoring-debug	統計システムに関する情報を提供します。
alsb-pipeline-debug	パイプライン内で生成されるエラーに関する情報を提供します。
alsb-service-repository-debug	サービス関連の様々な構成操作に関する情報を提供します。
alsb-service-security-manager-debug	アクセス制御に関する情報を提供します。
alsb-transports-debug	トランスポート・ヘッダーなど、トランスポート関連のデバッグ情報を提供します。この情報は、メッセージ単位で出力されます。注意: JCAトランスポート、フレームワークおよびアダプタでは、alsb-jca-framework-adapter-debugを使用します。
alsb-jca-framework-adapter-debug	JCAトランスポート、フレームワークおよびアダプタのデバッグ情報を提供します。
alsb-wsdl-repository-debug	WSDL関連の構成操作に関する情報を提供します。
alsb-wspolicy-repository-debug	WSポリシーに関する情報を提供します。
alsb-custom-resource-debug	カスタム・リソースに関する情報を提供します。
alsb-mqconnection-debug	MQ接続リソースに関する情報を提供します。
alsb-throttling-debug	スロットル機能に関する情報を提供します。
alsb-result-caching-debug	ビジネス・サービスの結果キャッシュに関する情報を提供します。

表B-2は、構成フレームワークの使用可能なデバッグ・フラグを示します。

表B-2 構成フレームワークのデバッグ・フラグ

デバッグ・フラグ	アクション
config-fwk-debug	Oracle Service Busの構成に関する一般的な情報を取得します。
config-fwk-transaction-debug	メモリー内のデータ構造とファイルの変更に関する低レベルのデバッグ情報を提供します。このデバッグ・フラグにより、サーバーの起動時の回復ログも生成されます。
config-fwk-deployment-debug	セッションの作成、アクティブ化、およびクラスタ内の構成の配布に関するデバッグ情報を提供します。
config-fwk-component-debug	作成、更新、削除、およびインポートの各操作に関する低レベルのデバッグ情報を提供します。
config-fwk-security-debug	インポートおよびエクスポート時の暗号化と復号化に関するデバッグ情報を提供します。

その他のすべてのデバッグ・フラグは、名前から内容がわかります。

すべてのフラグのデバッグ情報は、サーバー・ログ(DOMAIN_DIRECTORY/servers/servername/logs/servername.log.)に記録されます。

B.2 Eclipseでのプロキシ・サービスおよび分割-結合のデバッグ

『Oracle Fusion Middleware Oracle Service Bus開発者ガイド』のOracle Service Busデバッガの使用に関する項を参照してください。