Journalisation des diagnostics dans la vue d'ensemble de services Business Connectivity (SharePoint Foundation 2010)

Article
03/04/2017

S’applique à : SharePoint Foundation 2010

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

Vous pouvez résoudre les problèmes liés à Services Microsoft Business Connectivity sur les serveurs qui exécutent Microsoft SharePoint Foundation 2010 à l'aide de journaux des événements et de journaux de suivi sur le client ou le serveur. En outre, chaque entrée dans le journal des événements ou le journal de suivi possède un ID d'activité associé qui peut être utilisé pour suivre un problème à partir du serveur jusqu'à la source de données externe.

Notes

Avec les méthodes de journalisation présentées dans cette rubrique, vous pouvez utiliser Pack d’administration de Microsoft System Center Operations Manager pour contrôler une solution basée sur Services Microsoft Business Connectivity. Pour plus d'informations sur la façon de configurer le Pack d’administration de System Center Operations Manager, consultez le guide inclus avec le téléchargement du pack d'administration à l'adresse Pack d'administration de Microsoft SharePoint 2010 produits (éventuellement en anglais) (https://go.microsoft.com/fwlink/?linkid=184971&clcid=0x40C).

Dans cet article :

Journalisation des diagnostics dans les services Business Connectivity
À propos des ID d'activité
Journalisation des diagnostics sur les serveurs
Exemple : utilisation de la journalisation des diagnostics

Journalisation des diagnostics dans les services Business Connectivity

Pour les solutions qui reposent sur Services Microsoft Business Connectivity, la journalisation des diagnostics s'effectue sur les serveurs qui exécutent Microsoft SharePoint Foundation. Il existe deux journaux : le journal des événements et le journal de suivi. Ils enregistrent tous deux les informations de diagnostics que Services Microsoft Business Connectivity génère. Les journaux des événements permettent d'enregistrer des messages d'erreur. Les journaux de suivi contiennent plus d'informations détaillées, telles que les traces de pile et les messages d'information. En règle générale, les journaux de suivi fournissent plus de détails que les journaux des événements.

Chaque élément d'information consigné inclut un ID d'activité, qui est une valeur GUID unique. Les valeurs d'ID d'activité peuvent également être envoyées à des systèmes externes lorsqu'un élément fait l'objet d'une opération de création, de mise à jour ou de suppression. En utilisant des identificateurs de l'activité, il est possible de suivre une action à partir du serveur ou du client jusqu'à la source de données externe. Pour plus d'informations sur les ID d'activité, consultez À propos des ID d'activité.

Vous pouvez définir le niveau de journalisation des diagnostics pour le journal des événements et du journal de suivi. Cela limite les types et la quantité d'informations qui sont écrites dans chaque journal. Les tableaux ci-dessous définissent les niveaux de journalisation disponibles pour le journal des événements et le journal de suivi :

Niveaux du journal des événements

Niveau	Définition
Aucune	Aucune journalisation n'a lieu.
Critique	Ce type de message indique une erreur grave qui a provoqué une défaillance majeure dans la solution.
Erreur	Ce type de message indique un état d'urgence. Tous les événements d'erreur doivent être analysés.
Avertissement	Ce type de message indique un problème potentiel ou un problème qui peut nécessiter une attention particulière. Les messages d'avertissement doivent faire l'objet d'un examen et d'un suivi pour les tendances à long terme.
Informations	Les messages d'information ne nécessitent pas tous une action, mais ils peuvent fournir des données précieuses pour surveiller l'état de votre solution.
Commentaires	Ce niveau de journal des événements correspond à des messages ou des événements longs.

Niveaux de journal de suivi

Niveau	Définition
Aucune	Aucun journal de suivi n'est écrit.
Inattendu	Ce niveau permet de consigner des messages sur les événements qui provoquent l'arrêt du traitement effectué par les solutions. Lorsqu'il est configuré pour journaliser à ce niveau, le journal comprend uniquement les événements de ce niveau.
Suivi	Ce niveau permet de consigner les messages sur n'importe quels événements irrécupérables qui limitent le fonctionnement de la solution, mais n'arrêtent pas l'application. Lorsqu'il configuré pour journaliser à ce niveau, le journal inclut également les erreurs critiques (niveau inattendu).
Élevé	Ce niveau est utilisé pour consigner tous les événements inattendus, mais qui n'interrompent pas le traitement d'une solution. Lorsqu'il configuré pour journaliser à ce niveau, le journal contient des avertissements, des erreurs (niveau Suivi) et les erreurs critiques (niveau Inattendu).
Moyen	Lorsqu'il configuré pour journaliser à ce niveau, le journal de suivi inclut tout, à l'exception des messages commentés. Ce niveau est utilisé pour toutes les informations de haut niveau sur les opérations qui ont été effectuées. À ce niveau, les détails consignés sont suffisants pour reconstituer le flux de données et la séquence des opérations. Ce niveau de journalisation peut être utilisé par les administrateurs ou les techniciens du support technique pour résoudre les problèmes.
Commentaires	Lorsqu'il configuré pour journaliser à ce niveau, le journal inclut les messages tous les autres niveaux. Presque toutes les actions effectuées sont consignées lorsque vous utilisez ce niveau. Le suivi avec commentaires génère de nombreux messages de journalisation. Ce niveau est généralement utilisé uniquement 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 de production, mais les besoins en termes de niveau de journalisation vont probablement différer en fonction du type d'environnement. Lors de la planification pour la journalisation des diagnostics Services Microsoft Business Connectivity, réfléchissez aux besoins et à l'étape de cycle de vie de l'environnement avant de définir le niveau de journalisation.

Par exemple, au cours de la conception d'une solution, vous pouvez, à des fins de débogage, définir les deux niveaux de journalisation sur Commentaires pour capturer tous les messages qui sont générés sur l'état du système. À l'inverse, dans un environnement de production, vous pouvez souhaiter capturer les messages uniquement dans les catégories Élevé, Suivi et Inattendu pour les journaux de suivi et les catégories Critique et Erreur pour les journaux des événements. Cette opération permet d'économiser l'espace disque de journalisation et de limiter les effets négatifs sur les performances dus à l'exécution de la journalisation.

À propos des ID d'activité

Une valeur GUID unique appelée ID d'activité est générée pour chaque opération de création (Create), de mise à jour (Update) ou de suppression (Delete) appliquée aux données externes dans une solution basée sur Services Microsoft Business Connectivity. Tout ce qui est lié à l'opération qui est consignée dans le journal de suivi ou le journal des événements inclut sa valeur d'ID d'activité.

Important

Dans les journaux des événements et de suivi présent sur le serveur, des 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 Create, Update ou Delete est envoyée au système externe ainsi que d'autres informations liées à cette opération. Si le système externe possède un mécanisme de journalisation, cette valeur peut être capturée et consignée sur ce système. Par conséquent, une opération entraîne des entrées dans les journaux SharePoint, la même opération peut être suivie jusqu'au système externe par le biais de sa valeur d'ID d'activité. Cela facilite le dépannage de bout en bout des problèmes.

Souvent, une opération telle que Create entraîne l'écriture de plusieurs événements dans les journaux. Dans ce cas, la même valeur d'ID d'activité est utilisée pour tous les événements qui sont journalisés pour l'opération. Cette option est utile pour la résolution des problèmes, car la valeur récurrente de l'ID de l'activité facilite la recherche de tous les événements d'une opération particulière. Inversement, lorsque le même type d'opération se produit à plusieurs reprises, une valeur d'ID d'activité unique est générée pour chaque instance d'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 va réessayer une opération s'il n'a pas pu atteindre le système externe. Dans ce cas, le même ID d'activité est utilisé pour l'opération retentée.

Journalisation des diagnostics sur les serveurs

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

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

La journalisation des diagnostics de Services Microsoft Business Connectivity est alors désactivée ; activez-la en sélectionnant Services Business Connectivity sur la page Journalisation des diagnostics dans l'administration centrale SharePoint Foundation. 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 modifier le lecteur d'écriture utilisé pour la journalisation et définir le niveau de détail de la journalisation.

Pour plus d'informations sur la journalisation dans SharePoint Foundation 2010, comme par exemple comment définir l'emplacement des fichiers journaux, voir Configurer la journalisation des diagnostics (SharePoint Foundation 2010).

Vous pouvez utiliser Windows PowerShell pour consulter les journaux des événements sur le serveur et vous pouvez ensuite exporter les journaux, par exemple vers une feuille de calcul. Pour plus d'informations, voir Afficher les journaux de diagnostic (SharePoint Foundation 2010).

Services Microsoft Business Connectivity sort deux catégories dans le journal de suivi sur les serveurs Web frontaux SharePoint Foundation : BDC_Shared_Services et SS_Shared_Service. Vous pouvez utiliser l'Observateur d'événements pour ouvrir le journal de suivi et filtrer sur les entrées pertinentes du journal en recherchant « SPS_BusinessData » (pour les sorties Services Microsoft Business Connectivity) et « SPS_SecureStoreService ».

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 de soumission de fiche de pointage fondée sur Services Microsoft Business Connectivity. Cette solution utilise un système externe pour stocker les informations de la carte de pointage des employés, telles que le temps des vacances et des congés de maladie, et pour interagir avec les employés et le système de paie lorsque des employés signalent une absence au travail. Les employés utilisent un composant WebPart pour interagir avec le système.

Dans la batterie de serveurs, les niveaux de journalisation sont définis selon les valeurs par défaut pour 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 correspondant au nombre d'heures de congé-maladie, mais ni l'employé, ni son responsable ne reçoit un message électronique de confirmation signalant que le temps de congé-maladie a été envoyé avec succès. L'employé appelle le service de support technique interne et signale le problème.

Le technicien reconnaît que l'application de la fiche de pointage est basée sur 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 soumis la demande de fiche de pointage. Il vérifie ensuite le journal de suivi, où il constate 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 inclut un ID d'activité que relève le technicien de support.

Le technicien sait que la journalisation est également prise en charge sur le système externe. À l'aide de l'ID de l'activité, il localise l'élément journalisé sur le système externe et détecte la preuve d'une erreur écrite dans le journal à la fin de l'opération de mise à jour : la mise à jour a échoué parce que l'employé avait utilisé tout son temps imparti aux congés-maladie. Il note également qu'il n'existe dans le journal aucune entrée confirmant qu'un message électronique a été généré sur le système externe immédiatement après l'opération de mise à jour. Le technicien du support technique conclut qu'il existe une erreur dans la logique de l'application de la fiche de pointage. Bien que l'application n'ait pas alloué pas le salaire correspondant aux jours de maladie lorsque l'employé a dépassé son nombre d'heures alloué, elle n'a pas généré un message électronique informant celui-ci du problème. Le technicien signale le problème à l'équipe de développement qui a créé l'application et l'équipe de développement met alors à jour l'application.

Partager via