Si vous êtes un utilisateur qui rencontre des problèmes avec un site web public ou une enquête, un e-mail ou une autre application, appelez l’entreprise propriétaire du site web pour lui demander de l’aide. Vous trouverez généralement les coordonnées d’un site web ou d’une enquête en bas d’une page ou dans les sections À propos de ou Nous contacter de leurs menus de navigation.
Si vous êtes un utilisateur au sein d’une entreprise et que vous rencontrez des erreurs, contactez la personne qui gère le site web interne de votre entreprise. Le webmaster (administrateur SharePoint) ou quelqu’un de votre entreprise est souvent le seul à pouvoir résoudre ces types de problèmes.
Si vous êtes un administrateur SharePoint, un webmaster ou un gestionnaire de site, et que vos utilisateurs posent des questions sur les ID de corrélation, cet article peut vous aider.
Ce qu’est et ce que n’est pas un ID de corrélation
L’ID de corrélation n’est pas un numéro d’erreur ni un code. Il s’agit simplement d’un GUID (identificateur global unique) généré automatiquement pour chaque requête que le serveur SharePoint reçoit. Il est propre à chaque requête, et non à chaque erreur. Toutefois, lorsqu’une erreur se produit, le message d’erreur contient l’ID de corrélation qui était valide pour la requête à ce moment-là.
L’ID de corrélation est destiné à aider un administrateur SharePoint à suivre ce qui s’est passé au moment d’une erreur. Il n’a de valeur qu’en tant qu’outil interactif pour aider l’administrateur à localiser votre erreur. Un administrateur utilise l’ID de corrélation comme « fil d’Ariane » pour retracer une requête ou des processus dans le SharePointsystème de journalisation unifiée (ULS) pour trouver ce qui a conduit à un problème et l’a causé. Si SharePoint rencontre une erreur qu’il ne peut pas identifier lors de l’exécution de cette tâche, il publie un message « Une erreur inattendue s’est produite » et inclut l’ID de corrélation. L’ID de corrélation peut vous aider à déterminer ce qui s’est passé, mais n’identifie pas ce qui s’est passé.
Les requêtes réussies sont marquées avec un ID de corrélation, ainsi que celles ayant échoué. L’ID est unique et différent pour chaque nouvelle requête, et ne dure que la durée de la requête. Ce n’est pas comme une erreur Windows qui vous donne un nombre 80xxxxxx qui identifie le problème exact. Il n’est pas utile de rechercher un ID de corrélation spécifique sur le web, car chacun d’eux est différent et unique à votre serveur et à ce moment-là.
L’ID de corrélation est particulièrement utile pour le suivi d’un processus. SharePoint crée un journal (ULS) de tout ce qu’il fait lors du traitement des requêtes, et l’ID de corrélation est essentiellement le thread qui relie chaque étape entre elles. Étant donné que SharePoint effectue des milliers de requêtes en même temps, vous pouvez utiliser l’ID de corrélation pour filtrer uniquement les étapes que SharePoint effectuait pour une requête donnée.
Pour l’administrateur, un ID de corrélation peut être utilisé pour suivre les erreurs, ainsi que les problèmes de performances et d’autres problèmes. En utilisant les ID de corrélation pour les requêtes qui présentent le comportement problématique, ils peuvent mener une enquête plus approfondie. Si aucune défaillance ne se produit et qu’aucun message d’erreur n’est généré, vous pouvez utiliser le tableau de bord du développeur pour afficher l’ID de corrélation généré par les processus.
Si vous êtes un utilisateur final, vous n’aurez probablement pas accès aux journaux qui fournissent les informations où un ID de corrélation peut être utile. Dans ce cas, vous pouvez vous arrêter à cette étape et appeler votre support technique ou votre administrateur. Expliquez votre problème et aidez-les à le diagnostiquer. Donnez-leur l’ID de corrélation que vous voyez sur votre message d’erreur, car ils peuvent en avoir besoin.
En tant que professionnel de l’informatique ou administrateur, pour comprendre ce qui s’est passé, vous devez trouver les journaux ULS au moment où l’événement s’est produit et rechercher l’ID de corrélation dans ces journaux. Vous devrez peut-être examiner plusieurs serveurs frontaux web pour trouver celui qui contient l’ID de corrélation que vous recherchez. L’ID de corrélation ne résout pas votre erreur, mais il peut vous aider à suivre une requête pour peut-être voir ce qui s’est passé. Vous pouvez obtenir des informations sur ce qui s’est passé juste avant la génération de l’erreur, sur les messages d’erreur affichés ou sur les événements déclenchés à cause de cette erreur (le cas échéant). Vous pouvez utiliser un outil tel que ULSViewer pour faciliter l’analyse de ces données et filtrer les requêtes que vous n’avez pas besoin de voir. Pour plus d’idées et de conseils, consultez le billet de blog Journalisation et résolution des problèmes SharePoint à l’aide d’ULSViewer.
Voici un scénario classique d’utilisation d’un ID de corrélation par un administrateur :
-
L’utilisateur rencontre une erreur lors de l’ouverture d’un fichier dans Excel, ce qui donne à l’administrateur l’ID de corrélation et la date/heure de l’incident :
-
Recherchez le répertoire des journaux et la date que vous recherchez, puis ouvrez ce fichier dans Excel :
-
Trouvez l’ID de corrélation que vous recherchez. Vous pouvez également filtrer par niveau des événements pour avoir une idée de ce qui se passe :
-
Si vous ne trouvez pas l’ID de corrélation, essayez un autre serveur web qui était en rotation au moment du problème signalé.
Voici d’autres ressources d’administrateur pour vous aider à déboguer les erreurs SharePoint. En plus de ces liens, essayez de faire des recherches sur le web, car il existe de nombreux sites et communautés tiers qui offrent un support et des outils pour travailler avec SharePoint. Étant donné que SharePoint est une plateforme, il existe une communauté de milliers de développeurs, de professionnels de l’informatique et d’utilisateurs qui développent des outils, des applications et de la documentation pour s’entraider.
