[SQL Server] Réplication : capture du détail de l’exécution pas-à-pas d’un agent de réplication (HistoryVerboseLevel)

Ce billet traite de la capture d’informations détaillées relatives au travail d’un agent de réplication.


Intérêt de la démarche

Lors de l’audit d’une réplication, il est très commode de configurer les paramètres des agents de façon à ce qu’ils puissent fournir des informations détaillées sur leur exécution. Cela consiste en l’ajout du paramètre HistoryVerboseLevel qui, par défaut, ne fournit pas le détail de l’exécution d’un agent.

Modus operandi de la configuration de la capture via HistoryVerboseLevel

Pour permettre aux principaux agents de réplication de fournir le détail de l’exécution de leurs travaux dans un fichier texte, il suffit d’aller dans leurs propriétés (soit via le Replication Monitor, soit via la liste des jobs du SQL Agent au sein de l’explorateur d’objets de SQL Server Management Studio (SSMS)) :

• Log Reader Agent : allez dans le Replication Monitor, puis dans les propriétés du Log Reader Agent ciblé :
  

  
  

  Dans les propriétés de l’agent, aller dans la section Etapes, puis dans la sous-étape 2 appelée Exécution de l’Agent :
  

  
  

  En fin de fenêtre de commandes, ajoutez le paramètre –Output suivi du chemin d’accès et du nom du fichier à créer (conventionnellement appelons-le LogReader.out) :
  

  
  

  On suppose, bien sûr, que le dossier C:\temp (choix, ici, arbitraire) existe.
  

  On rappelle que la démarche ci-dessus peut également se faire via l’accès direct aux propriétés du job d’exécution du Log Reader Agent concerné (dans la liste des jobs du SQL Agent, au sein de l’explorateur d’objets de SSMS).
  

• Merge Agent : allez dans les propriétés du Merge Agent concerné (dans notre exemple, celui de l’abonné de l’instance SRV-SQL03) au sein de l’explorateur d’objets :
  

  
  

  Allez dans Etapes, puis sélectionnez la seconde sous-étape du travail du Merge Agent :
  

  Entrez le paramètre –Output avec le chemin d’accès (préexistant) et le nom du rapport que l’on souhaite générer (MergeAgentMaBase3.out, dans notre exemple) :
  

  
  

• Distribution Agent : suivez la même chose que pour ce qui a été montré pour le Merge Agent, puis donnez comme paramètre : -Output C:\temp\DistributionAgentMaBaseX.out, où X est la base abonnée ciblée (sinon, adaptez en fonction de vos besoin, comme par exemple : DistributionAgentNomPublication.out) :
  

  
  

• Snapshot Agent : idem que pour ci-dessus, avec le paramètre suivant : -Output SnapshotAgentMaBase1.out. Ou alors –Output C:\temp\SnapshotAgentNomPublication.out si plusieurs Snapshot Agents existent sur le même éditeur.