Partager via

  • Article

Afficher les journaux du service ULS pour les entrées de travaux en file d'attente

 

Dernière rubrique modifiée : 2015-02-27

Vous pouvez utiliser les journaux du service ULS de votre serveur pour résoudre les problèmes de file d'attente dans Microsoft Office Project Server 2007. Les informations des entrées de file d'attente dans les journaux du service ULS sont particulièrement utiles en association avec les informations contenues dans la page Gérer la file d'attente de Project Web Access ou avec l'Observateur d'événements Windows Server.

Cet article décrit :

  • comment configurer les paramètres du fichier journal du service ULS ;

  • comment configurer Microsoft Office Excel 2007 pour afficher les fichiers journaux du service ULS ;

  • comment rechercher des tâches de file d'attente spécifiques dans les journaux du service ULS ;

  • types d'entrées de tâche de file d'attente dans les journaux du service ULS ;

  • paramètres des entrées de file d'attente ;

  • meilleures pratiques pour la résolution des problèmes de file d'attente.

Configuration des paramètres du fichier journal du service ULS

Vous pouvez configurer les paramètres du fichier journal du service ULS à l'aide du site Web de l'administration centrale de SharePoint. Sur cette page, vous pouvez :

  • spécifier un emplacement par défaut pour stocker les fichiers journaux ;

  • spécifier le nombre maximal de fichiers journaux à stocker sur le serveur ;

  • spécifier la quantité de temps (en minutes) que couvre chaque fichier journal ;

NoteRemarque :
Les paramètres de fichier journal s'appliquent à tous les serveurs de la batterie de serveurs.

Configurer les paramètres de fichier journal du service ULS

  1. Dans l’Administration centrale, cliquez sur Opérations. Dans la section Journalisation et création de rapports, cliquez sur Journalisation des diagnostics.

  2. Dans la page de journalisation des diagnostics, à la section Journal de suivi, vérifiez l'emplacement spécifié dans le champs Chemin. L'emplacement par défaut est C:\Program Files\Common Files\Microsoft Shared\Web server extensions\12\LOGS. Pour modifier l'emplacement, tapez-en un nouveau dans le champ Chemin.

  3. Dans le champ Nombre de fichier journal, spécifiez le nombre maximum de fichiers journaux enregistrés sur chaque serveur de la batterie de serveurs. La valeur par défaut est 96.

  4. Dans le champ Nombre de minutes d'utilisation d'un fichier journal, entrez la durée voulue (en minutes) pour chaque fichier journal. La valeur par défaut est 30.

  5. Cliquez sur OK.

Les nouveaux fichiers journaux sont nommés selon le format suivant : nom_serveur-année/mois/jour-heure.log

Par exemple, un fichier journal créé le 8 juin 2008 à 13 h 20 sur un serveur nommé « Contoso » va être intitulé contoso-20080608 1320.log. Si le champ Nombre de minutes d'utilisation d'un fichier journal est défini sur 30, les fichiers suivants seront créés : contoso-20080608-1320.log, contoso-20080608-1350.log, contoso-20080608-1420.log, contoso-20080608-1450.log, ainsi de suite.

Configuration d'Office Excel 2007 pour afficher les fichiers journaux du service ULS

Les fichiers journaux s'affichent facilement dans la plupart des éditeurs de texte et via Microsoft Office Excel. Excel permet de trier les fichiers journaux par colonne et fournit également une meilleure lisibilité (en particulier pour les lignes qui contiennent de longues chaînes de données).

Configurer Office Excel 2007 pour afficher les fichiers journaux de suivi

  1. Dans Office Excel 2007, cliquez sur le bouton Office, puis sur Ouvrir

  2. Dans la boîte de dialogue Ouvrir, recherchez l'emplacement de vos fichiers journaux.

  3. Dans la liste Fichiers de types (située à droite du champ Nom de fichier), sélectionnez Tous les fichiers (*.*) afin d'afficher les fichiers journaux.

    NoteRemarque :
    Pour trier la liste de fichiers par date, cliquez avec le bouton droit sur une zone ouverte de la liste de fichiers, cliquez sur Ordre de tri puis sur Date de modification.

  4. Dans la liste de fichiers, sélectionnez le fichier journal que vous souhaitez afficher.

  5. Une fois que le fichier journal s'affiche, sous l'onglet Accueil, cliquez sur Trier et filtrer, puis sur Filtrer. Cela vous permet de filtrer toutes les lignes selon des critères spécifiques. Par exemple, pour afficher uniquement les entrées Project Server, cliquez sur le menu Filtrer dans la colonne Zone et effacez toutes les options excepté Project Server.

  6. Sélectionnez la colonne Message. Dans l'onglet Accueil, cliquez sur Format, puis sur Format de cellule. Dans la page Format de cellule, cliquez sur Alignement, puis dans la section Contrôle du texte, sélectionnez Habillage de texte. Cliquez sur OK. Les données de message peuvent être très longues, par conséquent la configuration de la colonne pour habiller le texte facile la visibilité de ces données.

Recherche de tâches de file d'attente spécifiques

Pour rechercher une entrée spécifique dans un fichier journal, vous devez utiliser la page Gérer les travaux de file d'attente de Project Web Access en association avec les journaux du service ULS.

Chaque travail de file d'attente possède un numéro de groupe de travail. Ces données vous permettent de rechercher un fichier journal. En premier lieu, vous devez ajouter la colonne ID JobGroup à votre grille de travail. Une fois cela terminé, vous pouvez ensuite rechercher une valeur particulière dans le fichier journal du service ULS.

Ajouter la colonne N° du groupe de travail à la grille de travail

  1. Dans la page Paramètres du serveur dans Project Web Access, à la section File d'attente, cliquez sur Gérer la file d'attente

  2. Dans la page Gérer les travaux de file d'attente, cliquez sur Colonnes.

  3. Dans la liste de Colonnes disponibles, sélectionnez N° du groupe de travail. Cliquez sur Ajouter pour ajouter le numéro du groupe de travail à la liste Colonnes sélectionnées.

  4. Dans la barre d'outils Grille de travail, cliquez sur Actualiser l'état et vérifiez que la colonne a été ajoutée.

Après avoir ajouté la colonne N° du groupe de travail, vous pouvez vérifier les entrées de file d'attente de travail dans les journaux du service ULS par rapport à la valeur du numéro de groupe de travail correspondant qui s'affiche sur la page Gérer les travaux de file d'attente. Imaginez, par exemple, que dans la grille de travail de la page Gérer les travaux de file d'attente, un travail de publication de projet a échoué le 8 juin 2008 à 13 h 22. D'après l'heure de la défaillance, vous savez que vous pouvez rechercher le fichier journal correct contenant les informations sur la défaillance. Par exemple, contoso-20080608-1320.log contiendra les informations de la défaillance si la durée du fichier journal (le nombre de minutes d'utilisation d'un paramètre de fichier journal) est définie sur 30 minutes, car la plage est de 13 h 20 à 13 h 50.

Après avoir ouvert le fichier journal, vous pouvez rechercher toutes les entrées relatives au travail de file d'attente spécifique en utilisant les filtres de colonne. Par exemple, la colonne Corrélations peut vous permettre de filtrer en fonction du numéro du groupe de travail. Vous pouvez également affiner votre recherche en filtrant la colonne Horodateur (en fonction de l'heure de la défaillance), la colonne Zone (filtre pour « Project Server »), ou colonne de catégorie (filtre pour « File d'attente de Project Server »).

Affichage des composants d'entrée de file d'attente

Lorsque vous consultez les journaux du service ULS pour les entrées de file d'attente, notez qu'elles peuvent être divisées en deux types de fonctions :

  • Travaux envoyés à la file d'attente: le travail est envoyé à partir de Project Server à la file d'attente pour être traité.

  • Travaux récupérés pour être traités: après un envoi réussi du travail à la file d'attente, un thread de travail de file d'attente essaie de le traiter.

Travaux envoyés à la file d'attente

Lorsqu'un travail est envoyé correctement à la file d'attente, généralement trois types d'entrées s'affichent dans le journal du service ULS pour le travail de file d'attente :

  • une entrée de groupe de message de début ;

  • des entrés envoyant des données relatives au travail à la file d'attente ;

  • une entrée de groupe de message de fin.

Entrée de groupe de message de début: l'entrée initiale dans le journal du service ULS pour un travail de file d'attente est une balise qui représente le début du travail. Elle indique à la file d'attente que des données supplémentaires relatives au travail vont lui être envoyées. L'exemple suivant correspond à une entrée de travail de file d'attente du groupe de message de début :

05/13/2008 11:24:09.05 w3wp.exe(0x0E38) 0x0160 ProjectServer ProjectServerQueue 8the Medium PWA:hppt://contoso/PWA, SSP:SharedService1, User:Contoso\EvaCorets, PSI: Project.QueueCreateProjectAndCheckOut [QUEUE][SENDER] ProjectQ: BeginMessageGroup(95e48e6e-71ad-4a6b-b997-86693cac4f66,41398775-d4a6-4c10-a523-4d0251d192c1,ProjectCreate,StandardPriority): JobUID: 6c2c97af-06b4-4038-8ee8-d83de92e59a9 ca5ca0b6-1dce-4d76-aefb-fec966aa8fe1

Entrées envoyant des données relatives au travail à la file d'attente: après l'envoi par le travail en file d'attente de l'entrée de groupe de message de début, il se peut que des entrées relatives au travail envoyées à la file d'attente s'affichent. Vous pouvez suivre la séquence de ces entrées par le biais de la valeur du paramètre de numéro. Ces entrées peuvent se produire séquentiellement dans le journal ou elles peuvent être réparties sur une période donnée, mélangées à d'autres entrées du journal. Vous pouvez utiliser le numéro UID du groupe de travail pour suivre les entrées pour le travail dans le fichier journal. À ce stade, le travail est à l'état de mise en file d'attente. Voici un exemple d'une entrée relative au travail :

05/13/2008 11:24:09.07 w3wp.exe (0x0E38) 0x0160 ProjectServer ProjectServerQueue 8thf Medium PWA:http://contoso/PWA, SSP:SharedServices1, User:Contoso\EvaCorets, PSI: Project.QueueCreateProjectAndCheckOut  [QUEUE][SENDER] ProjectQ: Send( Microsoft.Office.Project.Server.BusinessLayer.QueueMsg.ProjectAddToMessage ): ID: 1 GroupUID: 95e48e6e-71ad-4a6b-b997-86693cac4f66  ca5ca0b6-1dce-4d76-aefb-fec966aa8fe1

Entrée de groupe de message de fin: lorsque la file d'attente a reçu toutes les données du travail en file d'attente de travail, une entrée de groupe de message de fin est envoyée à la file d'attente. Tant que cette entrée n'est pas reçue, le travail en file d'attente est en état de mise en file d'attente. Si l'entrée de groupe de message de fin est reçue correctement, le travail passe à l'état « en attente de traitement ». Voici un exemple d'une entrée de groupe de messge de fin :

05/13/2008 11:24:09.09 w3wp.exe(0x0E38) 0x0160 ProjectServer ProjectServerQueue 8the Medium PWA:hppt://contoso/PWA, SSP:SharedService1, User:Contoso\EvaCorets, PSI: Project.QueueCreateProjectAndCheckOut [QUEUE][SENDER] ProjectQ: EndMessageGroup(): GroupUID: 6c2c97af-06b4-4038-8ee8-d83de92e59a9 ca5ca0b6-1dce-4d76-aefb-fec966aa8fe1

Travaux récupérés pour être traités

Une fois un travail envoyé correctement à la file d'attente, il est ensuite récupéré pour être traité par les threads de travail de traitement. Deux types de travaux sont associés à ce processus :

  • Entrée de démarrage de groupe

  • Entrée de groupe terminée correctement

Entrée de démarrage de groupe: une entrée de démarrage de groupe dans le journal du service ULS signifie qu'un travail a été prélevé pour être traité. À ce stade, l'état du travail est « Traitement en cours ». Voici un exemple d'une entrée de démarrage de groupe :

05/13/2008 11:24:09.55 Microsoft.Office.Project.Server (0x0E9C) 0x1378  ProjectServer   ProjectServerQueue 7h52 Medium PWA:http://Contoso/PWA, SSP:SharedServices1, User:Contoso\EvaCorets, PSI:[QUEUE] ProjectQ: Starting group 95e48e6e-71ad-4a6b-b997-86693cac4f66 type = ProjectCreate priority = StandardPriority   59d07fb9-158f-42b6-ac09-824d592c06c7

Entrée de groupe terminée correctement: lorsque le traitement d'un travail s'effectue correctement, une entrée de groupe terminée correctement est ajoutée au journal du service ULS. Le travail a l'état « opération réussie ». Voici un exemple d'une entrée de groupe terminée correctement.

05/13/2008 11:24:11.52 Microsoft.Office.Project.Server (0x0E9C) 0x1378  ProjectServer  ProjectServerQueue 7h5o Medium PWA:http://Contoso/PWA, SSP:SharedServices1, User:Contoso\EvaCorets, PSI:[QUEUE] ProjectQ: Group completed successfully: 95e48e6e-71ad-4a6b-b997-86693cac4f66 type = ProjectCreate 59d07fb9-158f-42b6-ac09-824d592c06c7

Paramètres d'entrée de file d'attente

Les paramètres suivants font partie de toutes les différentes entrées de travaux en file d'attente dans les journaux du service ULS :

Paramètre Description

PWA:http://contoso/PWA

Décrit l'instance de Project Server sur laquelle le travail en file d'attente est en cours de traitement. Dans le présent exemple, il s'agit de « http://contoso/PWA » .

SSP:ShareService1

Décrit le fournisseur de services partagés pour l'instance de Project Server à laquelle le travail s'est produit. Dans le présent exemple, il s'agit de « SharedService1 ».

User:Contoso\EvaCorets

Décrit le propriétaire du travail en file d'attente. Dans le présent exemple, il s'agit d'un utilisateur de Windows doté de l'alias EvaCorets.

PSI: WinProj.PreSaveProject

Décrit l'appel PSI (interface Project Server) effectué via le travail. Dans le présent exemple, WinProj.PreSaveProject signifie que l'appel PSI est une opération d'enregistrement de projet via Project Professional.

[EXPÉDITEUR]

Indique que le message est en cours d'envoi à la file d'attente.

[FILE]

Définit les threads principaux de la file d'attente et les threads de travaux en file d'attente.

[SERVICE]

Définit le processus de surveillance de file d'attente.

[QSERVICE]

Définit le processus de travail en file d'attente.

ProjectQ :

Définit la file d'attente Project (par rapport à la file d'attente de feuille de temps).

ProjectSave

Indique que le type de travail est Enregistrer à partir du client Project. Le type de travail sera ajouté aux entrées Type = in Starting Group ou Group Completed Successfully .

StandardPriority

Indique la priorité de travail. Les travaux de faible priorité (par exemple, une écriture dans la base de données de création de rapport générée via un travail de publication de projet) sont prélevés pour être traités une fois que les travaux de haute priorité ont été prélevés. La priorité est ajoutée aux entrées Priority = in Starting Group ou Group Completed Successfully entries.

JobUID : de2f…

Définit le numéro UID du travail en file d'attente. La valeur UID du travail correspond à la valeur de l'identifiant du travail pour les travaux en file d'attente dans la page Gérer les travaux en file d'attente, dans les paramètres du serveur Project Web Access.

NoteRemarque :
Les valeurs UID de la dernière colonne d'une entrée de travail en file d'attente dans les journaux du service ULS peuvent être associés à la valeur UID du groupe de travail de la page Gérer les travaux en file d'attente, dans les paramètres du serveur Project Web Access.

Pour plus d'informations sur les processus et les threads de file d'attente, voir Système de mise en attente de Microsoft Office Project Server 2007.