BAM のトレースを有効にする方法

BAM のトレースを有効にすると、次の 5 つの BAM コンポーネント内で発生した問題のトラブルシューティングに役立ちます。

• BAM 管理ユーティリティ

• BAM イベント バス

• BAM ポータル

• BAM アラート

• BAM WCF インターセプタ

BAM 管理ユーティリティのトレースの有効化

BAM 管理ユーティリティのトレースを有効にすることによって、展開エラーに関する情報を取得することができます。 これは 2 つの方法で行えます。 コマンド ラインを使用して特定の BM.exe コマンドのトレースを有効にする方法と、BAM 管理ユーティリティの構成ファイルを変更してすべての BM.exe コマンドのトレースを有効にする方法です。

コマンド ラインの使用

BM.exe コマンド ライン トレースは、 -Trace:on|off スイッチを使用してアクティブ化されます。 Trace スイッチを使用すると、構成ファイルの設定がオーバーライドされます。

このスイッチは、通常の BM.exe コマンドと組み合わせて使用します。

次に例を示します。

deploy-all -DefinitionFile:PO.xml –Trace:On のbm.exe

構成ファイルの使用

トレースを有効にするには、\Program Files (x86)\Microsoft BizTalk Server VERSION>Tracking フォルダーにある BM.exe.config <構成ファイルを変更します。 このファイルには、トレース要素を含む system.診断 セクションが含まれています。 このセクションのコメントを解除すると、トレースが有効になります。 既定では、トレースは無効になっています。

<system.diagnostics>

<!-- To turn on BAM tracing, remove this comment or use the "-trace:on" command-line switch

<switches>

<add name="bm" value="1" />

<add name="Microsoft.BizTalk.Bam.Management" value="1" />

</switches>

-->

BAM イベント バスのトレースの有効化

BAM イベント バスのトレースを有効にすると、2 種類のデータベース ストレージ エラーの診断に役立ちます。

• 追跡プロファイル エディターの使用時に BizTalk Server サービスのイベントから発生したストレージ エラー

• バッファーに格納されたイベント ストリーム API の使用時に生成されたストレージ エラー

  BAM イベント バスのトレースを有効にするには、\Program Files (x86)\Microsoft BizTalk Server <VERSION> フォルダーにある BTSNTSvc.exe.config ファイルの次のセクションを編集または追加します。

  <system.diagnostics>

  <switches>

  <add name="Microsoft.BizTalk.Bam.EventBus" value="1" />

  </switches>

  <trace autoflush="true" indentsize="4">

  <listeners>

  <add name="Text" type="System.Diagnostics.TextWriterTraceListener" initializeData="c:\tdds.log"/>

  </listeners>

  </trace>

  </system.diagnostics>

BAM イベント バスのトレースを有効にするには

1. \Program Files (x86)\Microsoft BizTalk Server <VERSION>BTSNTSvc.exe.config ファイルを編集します。

2. <system.診断> タグと </system.診断 タグを>見つけます。 該当するタグがファイル内に存在しない場合は、上記のコードをコピーして構成ファイルに貼り付けます。

3. 終了コメント区切り記号 ('-->') を /system.診断 タグの後<から system.診断 タグの前<に移動して、システム> 診断> セクションのコメントを解除します。

4. ファイルを保存します。

BAM ポータルのトレースの有効化

BAM ポータルのトレースを有効にすると、接続の問題のトラブルシューティングを行うことができます。

BAM ポータルは ASP.NET アプリケーションであり、トレースの標準プロトコルに準拠しています。 \Program Files (x86)\Microsoft BizTalk Server <VERSION>BAMPortal\web.config ファイル内には、有効にできる trace> という<セクションがあります。

BAM ポータルのトレースを有効にするには

1. \Program Files (x86)\Microsoft BizTalk Server <VERSION>BAMPortal\web.config ファイルを編集します。

2. <system.診断> タグと </system.診断> タグを見つけます。

3. /system.診断 タグの後<から system.診断 タグの前<に終了コメント区切り記号 ('-->') を移動して、システム 診断>> セクションのコメントを解除します。

4. initializeData 属性を変更して、トレース ログの書き込み先を指定します。

5. system.web> タグを見つけます<。

6. system.web セクションでトレース タグを見つけ、トレース タグの後から前に区切り記号 ('-->') を移動してトレース コマンドのコメントを解除します。

7. ファイルを保存します。

   <!--

   TRACING: To turn tracing on:

   1) Uncomment this tag and specify a file path for trace output

   2) Uncomment the <trace tag> under <system.web>

   The trace will be saved to the file pointed to by "initializeData" below.

   Ensure that the target directory exists (C:\temp by default).

   Make sure that the IIS worker process user account (usually Network Service or ASPNET)

   and the BAM Portal user have write permissions for the trace log file directory (C:\temp below).

   To turn tracing on, you will need to uncomment the <trace> tag under <system.web>

   <system.diagnostics>

   <trace autoflush="true" indentsize="2">

   <listeners>

   <add name="BAMPortalListener"

   type="System.Diagnostics.TextWriterTraceListener"

   initializeData="C:\temp\BAMPortalTrace.log" />

   </listeners>

   </trace>

   </system.diagnostics>

   -->

   <!--

   TRACING: To turn tracing on:

   1) Uncomment this tag

   2) Uncomment the <system.diagnostics> tag above and specify a file path for trace output

   <trace enabled="true"

   requestLimit="40"

   pageOutput="false"

   traceMode="SortByTime"

   localOnly="true"

   writeToDiagnosticsTrace="true" />

   -->

BAM 警告

BAM 警告のトレースを有効にすると、警告配信エラーのトラブルシューティングに役立ちます。

BAM アラートは、SQL Server Notification Services インフラストラクチャ上に構築されています。 BAM アラートのトレースを有効にするには、 の Notification Services のトラブルシューティングに関するトピック https://go.microsoft.com/fwlink/?LinkId=79416を参照してください。

BAM インターセプター

BAM インターセプターのエンド ツー エンドトレースを有効にするには、アプリケーションの構成ファイル (Web ホスト型アプリケーションの場合は Web.config、セルフホステッド アプリケーションの場合は Appname.config) を変更します。 ファイルの変更方法の例を次に示します。

<system.diagnostics>
  </sources>
    <source name="Microsoft BizTalk Bam Interceptors" switchValue="All">
      <listeners>

        <add name="myListener"
             type="System.Diagnostics.TextWriterTraceListener"
             initializeData="TextWriterOutput.log" />
      </listeners>
    </source>
  </sources>
</system.diagnostics>

Windows Workflow Foundation および Windows Communication Foundation 用の BAM インターセプターが、"Microsoft BizTalk Bam Interceptors" という名前のソースに書き込まれます。

Note

ソース文字列では大文字と小文字が区別されるため、上記のとおりに記述する必要があります。 記述した文字列が上記の文字列と異なっていると、BAM インターセプターからトレース情報を受け取れません。

トレース レベルは switchValue の設定によって制御します。 指定できるトレース レベルを次の表にまとめます。

トレース レベル	説明
重大	フェールファストとイベント ログのエントリをログに記録し、関連付け情報をトレースします。
エラー	すべての例外をログに記録します。
警告	エラーまたは重大なエラーにつながる可能性のある条件が存在します。
情報	システム ステータスの監視と診断、パフォーマンスの計測、またはプロファイリングに有用なメッセージが生成されます。 キャパシティ プランニングやパフォーマンス管理のためにこの情報を利用できます。
"詳細"	ユーザー コードとサービスの両方を対象とするデバッグ レベルのトレースです。
すべて	すべてのメッセージが対象になります。

Note

トレースはパフォーマンスに影響することがあります。 トレースを有効にするのは、トラブルシューティングの操作を実行する場合に限ってください。

WCF トレース ファイルの表示

WCF トレースを分析するには、WCF Service Trace Viewer ツールを使用します。 サービス トレース ビューアー ツールの詳細については、「」を参照してください https://go.microsoft.com/fwlink/?LinkId=75218。

参照

BAM の管理