Vue d’ensemble de la journalisation des diagnostics dans Business Connectivity Services (SharePoint Server 2010)

Article
01/19/2017

S’applique à : SharePoint Server 2010

Dernière rubrique modifiée : 2016-11-30

Vous pouvez résoudre les problèmes liés aux Services Microsoft Business Connectivity sur les serveurs exécutant Microsoft SharePoint Server 2010 et sur les applications clientes Microsoft Office 2010 à l’aide des journaux des événements et des journaux de suivi sur le client ou le serveur. En outre, à chaque entrée du journal des événements ou du journal de suivi est associé un ID d’activité qui permet d’effectuer le suivi d’un problème entre le client ou le serveur et la source de données externe.

Notes

Outre les méthodes de journalisation présentées dans cette rubrique, vous pouvez utiliser le Pack d’administration de Microsoft System Center Operations Manager pour surveiller une solution basée sur les Services Microsoft Business Connectivity. Pour plus d’informations sur la configuration du Pack d’administration de System Center Operations Manager, voir le guide inclus dans le téléchargement du pack d’administration disponible à partir de la page Pack d’administration des produits Microsoft SharePoint 2010 (éventuellement en anglais) (https://go.microsoft.com/fwlink/?linkid=184971&clcid=0x40C).

Dans cet article :

Journalisation des diagnostics dans Business Connectivity Services
À propos des ID d’activité
Journalisation des diagnostics sur les serveurs
Journalisation des diagnostics sur les clients Office 2010
Exemple : utilisation de la journalisation des diagnostics

Journalisation des diagnostics dans Business Connectivity Services

Pour les solutions basées sur les Services Microsoft Business Connectivity, la journalisation des diagnostics se produit à la fois sur les serveurs exécutant SharePoint Server 2010 et sur les clients Office 2010. Il existe deux journaux : le journal des événements et le journal de suivi. Tous deux enregistrent des informations de diagnostic générées par les Services Microsoft Business Connectivity. Les journaux des événements enregistrent des messages d’erreur. Les journaux de suivi contiennent des informations plus précises, telles que les traces de pile et les messages d’information. En général, les journaux de suivi fournissent plus de détails que les journaux des événements.

Chaque élément d’information journalisé comprend un ID d’activité, qui est une valeur GUID unique. En outre, les valeurs d’ID d’activité peuvent être envoyées à des systèmes externes lorsqu’une opération de création, de mise à jour ou de suppression se produit sur un élément. Grâce aux ID d’activité, une action peut faire l’objet d’un suivi entre le serveur ou le client et la source de données externe. Pour plus d’informations sur les ID d’activité, voir À propos des ID d’activité.

Vous pouvez définir le niveau de journalisation des diagnostics pour le journal des événements et pour le journal de suivi. Cela limite les types et la quantité d’informations à écrire dans chaque journal. Les tableaux suivants définissent les niveaux de journalisation disponibles pour le journal des événements et pour le journal de suivi :

Niveaux du journal des événements

Niveau	Définition
Aucun	Aucune journalisation ne se produit.
Critique	Ce type de message indique une erreur grave ayant entraîné un échec majeur dans la solution.
Erreur	Ce type de message indique une situation d’urgence. Tous les événements d’erreur doivent être analysés.
Avertissement	Ce type de message indique un problème potentiel pouvant nécessiter une attention particulière. Les messages d’avertissement doivent être examinés et suivis dans le temps afin que des situations types soient dégagées.
Informations	Les messages d’information ne requièrent pas d’action, mais ils peuvent fournir des données précieuses pour la surveillance de l’état de votre solution.
Détaillé	Ce niveau de journal des événements correspond à des événements ou messages longs.

Niveaux du journal de suivi

Niveau	Définition
Aucun	Aucun journal de suivi n’est écrit.
Inattendu	Ce niveau permet de journaliser les messages relatifs aux événements qui entraînent l’arrêt du traitement des solutions. Lorsque ce niveau de journalisation est activé, le journal comprend uniquement des événements correspondant à ce niveau.
Suivi	Ce niveau permet de journaliser les messages relatifs aux événements irrécupérables qui limitent les fonctionnalités de la solution, mais qui n’arrêtent pas l’application. Lorsque ce niveau de journalisation est activé, le journal comprend également les erreurs critiques (niveau Inattendu).
Élevé	Ce niveau permet de journaliser les événements inattendus, mais qui n’entravent pas le traitement d’une solution. Lorsque ce niveau de journalisation est activé, le journal comprend les avertissements, les erreurs (niveau Suivi) et les erreurs critiques (niveau Inattendu).
Moyen	Lorsque ce niveau de journalisation est activé, le journal de suivi comprend tous les messages, à l’exception des messages de niveau Détaillé. Ce niveau permet de journaliser toutes les informations de haut niveau relatives aux opérations qui ont été réalisées. À ce niveau, les informations journalisées sont suffisamment détaillées pour permettre la construction du flux de données et de la séquence des opérations. Ce niveau de journalisation peut être utilisé par des administrateurs ou un support technique à des fins de résolution de problèmes.
Détaillé	Lorsque ce niveau de journalisation est activé, le journal comprend les messages correspondant à tous les autres niveaux. Pratiquement toutes les actions réalisées sont journalisées lorsque vous utilisez ce niveau. Le suivi détaillé génère de nombreux messages de journal. En règle générale, ce niveau n’est utilisé que pour le débogage dans un environnement de développement.

Les journaux de diagnostic sont utiles à la fois dans les environnements de développement et dans les environnements de production, mais le niveau de journalisation nécessaire dépendra probablement du type d’environnement. Lors de la planification de la journalisation des diagnostics dans les Services Microsoft Business Connectivity, prenez en compte les besoins de l’entreprise et la phase du cycle de vie de l’environnement avant de définir le niveau de journalisation.

Par exemple, pendant la conception d’une solution, vous pouvez, à des fins de débogage, définir les deux niveaux de journalisation sur Détaillé afin de capturer tous les messages générés au sujet de l’état du système. À l’inverse, dans un environnement de production, vous pouvez ne souhaiter capturer que les messages des catégories Élevé, Suivi et Inattendu des journaux de suivi et des catégories Critique et Erreur des journaux des événements. Cela permet d’utiliser moins d’espace disque pour la journalisation et de limiter les effets négatifs de la journalisation sur les performances.

À propos des ID d’activité

Une valeur GUID unique appelée ID d’activité est générée sur le serveur et sur le client Office pour chaque opération de création, de mise à jour ou de suppression sur les données externes dans une solution basée sur les Services Microsoft Business Connectivity. Toute activité concernant l’opération journalisée dans le journal de suivi ou dans le journal des événements possède sa propre valeur d’ID d’activité.

Important

Dans les journaux des événements et les fichiers de journal de suivi sur le serveur, les valeurs d’ID d’activité sont étiquetées en tant que valeurs « CorrelationId ».

La valeur d’ID d’activité générée pour une opération de création, de mise à jour ou de suppression est envoyée au système externe, ainsi que d’autres informations relatives à cette opération. Si le système externe possède un mécanisme de journalisation, cette valeur peut être capturée et journalisée sur ce système. Par conséquent, si une opération génère des entrées dans les journaux du serveur SharePoint ou du client Office, la même opération peut faire l’objet d’un suivi sur le système externe grâce à sa valeur d’ID d’activité. Cela facilite la résolution des problèmes de bout en bout.

Il est fréquent qu’une opération telle qu’une création entraîne l’écriture de plusieurs événements dans les journaux. Lorsque cela se produit, la même valeur d’ID d’activité est utilisée pour tous les événements journalisés pour l’opération. Cela est utile pour la résolution des problèmes, car la valeur récurrente de l’ID d’activité facilite la recherche de tous les événements liés à une opération particulière. À l’inverse, lorsque le même type d’opération se produit régulièrement, une valeur d’ID d’activité unique est générée pour chaque instance de l’opération. Par exemple, si un élément d’un type de contenu externe est mis à jour deux fois, chaque opération de mise à jour est associée à une valeur d’ID d’activité unique.

Conseil

Dans certaines circonstances, le Service Business Data Connectivity essaie une opération si celle-ci n’a pas pu aboutir au système externe. Dans ces cas, le même ID d’activité est utilisé pour l’opération renouvelée.

Journalisation des diagnostics sur les serveurs

Par défaut, la journalisation des Services Microsoft Business Connectivity est activée sur les serveurs SharePoint Server. Les niveaux de journalisation par défaut sont les suivants :

Pour le journal des événements : Critique et Erreur
Pour le journal de suivi : Moyen

Si la journalisation des diagnostics des Services Microsoft Business Connectivity est désactivée, activez-la en sélectionnant Business Connectivity Services dans la page Journalisation des diagnostics dans l’Administration centrale de SharePoint Server. Vous pouvez également utiliser Windows PowerShell pour configurer les journaux des événements et les journaux de suivi sur le serveur. Par exemple, vous pouvez choisir un lecteur différent pour l’écriture des opérations de journalisation et vous pouvez définir le niveau de détail de la journalisation.

Pour plus d’informations sur la journalisation dans SharePoint Server, par exemple, sur la définition de l’emplacement des fichiers journaux, voir Configurer la journalisation des diagnostics (SharePoint Server 2010).

Vous pouvez utiliser Windows PowerShell pour afficher les journaux des événements sur le serveur et vous pouvez exporter les journaux, par exemple vers un tableur. Pour plus d’informations, voir Afficher les journaux de diagnostic (SharePoint Server 2010).

Les Services Microsoft Business Connectivity génèrent deux catégories dans le journal de suivi sur les serveurs Web frontaux SharePoint Server : BDC_Shared_Services et SS_Shared_Service. Vous pouvez utiliser l’Observateur d’événements pour ouvrir le journal de suivi et filtrer les entrées de journal appropriées en effectuant une recherche sur « SPS_BusinessData » (pour les sorties des Services Microsoft Business Connectivity) et sur « SPS_SecureStoreService ».

Journalisation des diagnostics sur les clients Office 2010

Les journaux des événements et les journaux de suivi pour les solutions des Services Microsoft Business Connectivity sont disponibles sur les clients des Suites Microsoft Office 2010 qui utilisent l’infrastructure des Services Microsoft Business Connectivity. Par défaut, la journalisation des événements pour les Services Microsoft Business Connectivity est activée sur les clients. Toutefois, afin que les performances soient protégées, seules les erreurs et les erreurs critiques sont journalisées et ce paramétrage ne peut pas être modifié. Les ordinateurs clients Windows comprennent un Observateur d’événements qui vous permet d’afficher les journaux des événements. Pour plus d’informations sur l’affichage des journaux des événements pour une version spécifique de Windows, voir la documentation du produit.

Par défaut, la journalisation du suivi est désactivée sur les ordinateurs clients afin que les performances soient améliorées. Vous ne devez activer la journalisation du suivi sur les ordinateurs clients que si vous rencontrez des problèmes que vous souhaitez diagnostiquer. Par exemple, si une entrée du journal des événements indique qu’une erreur pourrait être provoquée par une activité liée aux Services Microsoft Business Connectivity, activez la journalisation du suivi afin de rassembler des données supplémentaires la prochaine fois que l’événement se produit.

La méthode suivie pour l’activation de la journalisation du suivi et la lecture des journaux dépend de la version de Windows installée sur l’ordinateur. Par exemple, sur les ordinateurs exécutant Windows XP, vous activez le suivi en exécutant un script qui utilise la commande logman. Sur les ordinateurs exécutant les versions Windows Vista et supérieures, des outils système tels que Performances et Moniteur de fiabilité sont disponibles en plus de la commande logman. Pour plus d’informations sur l’activation du suivi et la capture des résultats, voir la documentation du produit Windows.

L’exemple de script suivant utilise la commande logman pour activer la journalisation du suivi :

rem This script will enable logging, directing log messages to a file specified by the "%FILE_NAME%" given by the user.

@setlocal
@echo off
pushd %~dp0
set PATH_NAME=%TEMP%\BCS
set FILE_NAME=%PATH_NAME%\ETWTraceLog
set TRACE_COLLECTION=BCS
::tracelog -start BCS -guid #b8622a02-c377-46b1-b861-38a787a8e44a -b 128 -flags 0xFFFF -level 5 -f "%FILE_NAME%.etl"
md "%PATH_NAME%" 1>nul 2>nul
logman create trace %TRACE_COLLECTION% -p "{b8622a02-c377-46b1-b861-38a787a8e44a}" 0xFFFF 5 -o "%FILE_NAME%.etl" -ets
echo.
echo Business Connectivity Services tracing has been started. To end press any key.
echo.
pause

Comme sur le serveur, une valeur d’ID d’activité unique est générée pour chaque opération de création, de mise à jour ou de suppression sur un élément dans le client. Ces valeurs sont enregistrées dans les journaux et envoyées aux systèmes externes, ainsi que d’autres informations sur les opérations. En outre, une solution peut être configurée de manière à ce que les valeurs d’ID d’activité s’affichent dans les messages d’erreur. Cela facilite la résolution des problèmes rencontrés par les utilisateurs de la solution.

Important

Étant donné que la version requise de l’interface de programmation du suivi d’événements pour Windows dont dépend la génération des ID d’activité n’est pas disponible sur le système d’exploitation Windows XP, la génération des ID d’activité n’est pas prise en charge sur les clients exécutant Windows XP.

Exemple : utilisation de la journalisation des diagnostics

Ce scénario court et simplifié illustre l’utilisation de la journalisation des diagnostics dans un environnement de production. Une entreprise a déployé une nouvelle solution d’envoi de feuille de présence basée sur les Services Microsoft Business Connectivity. Cette solution utilise un système externe pour stocker les informations de feuille de présence relatives aux employés, telles que les vacances ou les congés maladie, et pour interagir avec les employés et le système de paye automatisé lorsque les employés signalent une absence du travail. Les employés utilisent un composant WebPart pour interagir avec le système.

Sur la batterie de serveurs, les niveaux de journalisation sont définis sur les valeurs par défaut pour les Services Microsoft Business Connectivity :

Pour le journal des événements : Critique et Erreur
Pour le journal de suivi : Moyen

Dans ce scénario, un employé envoie une valeur pour le nombre d’heures de congé maladie, mais ni l’employé ni son responsable ne reçoivent un message électronique de confirmation indiquant que l’envoi de la durée du congé maladie s’est correctement déroulé. L’employé appelle le support technique interne et signale le problème.

Le technicien du support technique détermine que l’application de feuille de présence est basée sur les Services Microsoft Business Connectivity. Il vérifie le journal des événements, mais ne trouve aucune erreur associée à l’identité de l’utilisateur au moment où celui-ci a envoyé la demande de feuille de présence. Il vérifie alors le journal de suivi, où il trouve la preuve de l’activité : une opération de mise à jour associée à l’utilisateur au moment approprié. L’opération de mise à jour dans le journal de suivi comprend une valeur d’ID d’activité que note le technicien du support technique.

Le technicien du support technique sait que la journalisation est également prise en charge sur le système externe. À l’aide de l’ID d’activité, il recherche l’élément journalisé sur le système externe et trouve la preuve d’une erreur écrite dans le journal à la fin de l’opération de mise à jour : la mise à jour a échoué, car l’employé avait utilisé toute la période de congé maladie allouée. Le technicien note également l’absence d’une entrée de journal confirmant qu’un message électronique a été généré sur le système externe dès la fin de l’opération de mise à jour. Il conclut qu’il existe une erreur dans la logique de l’application de feuille de présence. Bien que l’application ait logiquement refusé d’allouer une indemnité de congé maladie à l’employé en raison du dépassement par celui-ci du quota d’heures qui lui était alloué, elle n’a pas généré un message électronique informant l’employé du problème. Le technicien signale le problème à l’équipe de développement qui a créé l’application, puis l’équipe de développement met celle-ci à jour.