Activation du suivi dans BAM

Vous pouvez activer le suivi dans BAM afin de faciliter la résolution des problèmes susceptibles de survenir dans les cinq composants BAM suivants :

• utilitaire de gestion de l'analyse BAM

• Bus d'événements BAM

• Portail BAM

• Alertes BAM

• Intercepteur WCF BAM

Activation du suivi pour l'utilitaire de gestion de l'analyse BAM

En activant le suivi de cet utilitaire, vous pouvez récupérer des informations sur les échecs de déploiement. Vous pouvez le faire de deux façons. activer le suivi depuis la ligne de commande pour certaines commandes BM.exe, ou modifier le fichier de configuration de l'utilitaire de gestion de l'analyse BAM afin d'activer le suivi, pour toutes les commandes BM.exe.

Utilisation de la ligne de commande

BM.exe suivi de ligne de commande est activé à l’aide du commutateur -Trace :on|off . L'utilisation de l'option Trace remplace les paramètres du fichier de configuration.

L'option est utilisée conjointement avec toute commande BM.exe classique.

Par exemple :

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

Utilisation du fichier de configuration

Vous pouvez activer le suivi en modifiant le fichier de configuration BM.exe.config situé dans le dossier \Program Files (x86)\Microsoft BizTalk Server <VERSION>Tracking. Ce fichier contient une section system.diagnostics qui contient les éléments de suivi. Supprimez les commentaires pour activer le suivi. Par défaut, le suivi est désactivé.

<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>

-->

Activation du suivi pour le bus d'événements BAM

L'activation du suivi pour le bus d'événements BAM peut vous permettre de diagnostiquer deux catégories d'erreurs de stockage de base de données :

• les erreurs issues d'événements du service BizTalk Server lors de l'utilisation de l'Éditeur de modèle de suivi ;

• les erreurs générées lors de l'utilisation des API de flux d'événements mis en mémoire tampon.

  Pour activer le suivi pour le bus d’événements BAM, modifiez ou ajoutez la section suivante du fichier BTSNTSvc.exe.config situé dans le dossier \Program Files (x86)\Microsoft BizTalk Server <VERSION>.

  <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>

Pour activer le suivi pour le bus d'événements BAM

1. Modifiez le fichier deBTSNTSvc.exe.config \Program Files (x86)\Microsoft BizTalk Server <VERSION>.

2. Recherchez les <balises system.diagnostics> et </system.diagnostics>. Si vous ne les trouvez pas dans le fichier, copiez le code indiqué plus haut et collez-le dans le fichier de configuration.

3. Supprimez les marques de commentaire de la section Uncomment du système diagnostics en déplaçant le délimiteur de commentaire de fin ('-->') après la <balise /system.diagnostics> vers avant la <balise system.diagnostics>.

4. Enregistrez le fichier .

Activation du suivi pour le portail BAM

L'activation du suivi pour le portail BAM vous permet de résoudre les problèmes de connectivité.

Le portail BAM est une application ASP.NET qui suit le protocole standard de suivi. Dans le fichier \Program Files (x86)\Microsoft BizTalk Server <VERSION>BAMPortal\web.config, il existe une section appelée trace> que <vous pouvez activer.

Pour activer le suivi pour le portail BAM

1. Modifiez le fichier deBAMPortal\web.config \Program Files (x86)\Microsoft BizTalk Server <VERSION>.

2. Recherchez les <balises system.diagnostics> et </system.diagnostics>.

3. Supprimez les marques de commentaire de la section diagnostics système en déplaçant le délimiteur de commentaire de fin ('-->') après la <balise /system.diagnostics> vers avant la <balise system.diagnostics>.

4. Modifiez l'attribut initializeData afin d'indiquer l'emplacement d'écriture du journal des suivis.

5. Recherchez <la balise system.web> .

6. Dans la section system.web, recherchez la balise de trace et supprimez les marques de commentaire de la commande de trace en déplaçant le délimiteur ('-->') de après la balise de trace vers avant.

7. Enregistrez le fichier .

   <!--

   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" />

   -->

Alertes BAM

L'activation du suivi pour les alertes BAM vous permet de résoudre les erreurs de notification d'alertes.

Les alertes BAM reposent sur l’infrastructure SQL Server Notification Services. Pour activer le suivi sur les alertes BAM, consultez les rubriques de résolution des problèmes de Notification Services à l’adresse https://go.microsoft.com/fwlink/?LinkId=79416.

Intercepteurs BAM

Pour activer le suivi de bout en bout des intercepteurs BAM, modifiez le fichier de configuration de l'application : le fichier Web.config pour les applications hébergées sur le Web, ou le fichier Appname.config pour les applications auto-hébergées. L'exemple suivant illustre la modification du fichier :

<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>

Les intercepteurs BAM de Windows Workflow Foundation et Windows Communication Foundation sont écrits dans la source nommée « Microsoft BizTalk Bam Interceptors ».

La définition du paramètre switchValue permet de contrôler le niveau de suivi. Le tableau suivant récapitule les différents niveaux de suivi disponibles.

Affichage du fichier de suivi WCF

Utilisez l'outil WCF Service Trace Viewer pour analyser le suivi WCF. Pour plus d’informations sur l’outil Visionneuse de traces de service, consultez https://go.microsoft.com/fwlink/?LinkId=75218.

Voir aussi

Gestion de l’analyse BAM