Afficher les journaux de diagnostic dans SharePoint Server

  • Article

S’APPLIQUE À :oui-img-132013 oui-img-162016 oui-img-192019 oui-img-seÉdition d’abonnement no-img-sopSharePoint dans Microsoft 365

Vous pouvez résoudre les problèmes liés à la batterie de serveurs à l'aide des données des journaux ULS (Unified Logging Service) dans SharePoint Server. Les journaux ULS peuvent recueillir des données à différents niveaux en fonction des paramètres de journalisation. Utilisez PowerShell pour filtrer les données, les afficher de différentes manières et les insérer dans une grille de données avec laquelle vous pouvez filtrer, trier, grouper et exporter des données vers Excel 2016.

Afficher et filtrer les événements de journal à l’aide de PowerShell

Vous pouvez utiliser PowerShell pour afficher et filtrer des événements de journaux. Il est impossible d'afficher ou de filtrer des événements de journaux à l'aide du le site Web Administration centrale de SharePoint.

Pour afficher et filtrer les événements de journal à l’aide de PowerShell

  1. Vérifiez que vous êtes membre :

  • du rôle serveur fixe securityadmin sur l'instance SQL Server.

  • du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;

  • du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.

    Un administrateur peut utiliser l'applet de commande Add-SPShellAdmin pour accorder des autorisations.

    Remarque

    [!REMARQUE] Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.

  1. Accédez à SharePoint Management Shell.

  2. À partir de l’invite de commandes PowerShell, entrez la commande suivante :

  • Tous les événements de suivi:
Get-SPLogEvent
  • Par niveau:
Get-SPLogEvent | Where-Object {$_.Level -eq "Information" }
  • Par zone:
Get-SPLogEvent | Where-Object {$_.Area -eq <Area>}

Où <Area> est la valeur de la propriété Area .

  • Par catégorie:
Get-SPLogEvent | Where-Object {$_.Category -eq <Category>

Où <Category> est la valeur de la propriété Category .

  • Par ID d'événement:
Get-SPLogEvent | Where-Object {$_.EventID -eq <EventID>}

Où <EventID> est la valeur de la propriété EventID .

  • Par texte de message:
Get-SPLogEvent | Where-Object {$_.Message -like "<string>"}

Où <string> est la chaîne trouvée dans le message d’événement.

  • Par processus:
Get-SPLogEvent | Where-Object {$_.Process -like "<Process>"}

Où <Process> est la valeur de la propriété Process .

Par défaut, la commande extrait les données du dossier de journaux ULS par défaut. Pour afficher et filtrer les événements de suivi qui se trouvent dans un dossier partagé sur un réseau, utilisez le paramètre Directory de l'applet de commande Get-SPLogEvent.

Pour afficher davantage de détails concernant chaque événement de suivi, utilisez l'applet de commande Format-List à la fin de la commande. Par exemple,

Get-SPLogEvent | Where-Object {$_.Area -eq "SharePoint Foundation"} | Format-List

Pour plus d'informations, voir Get-SPLogEvent.

Afficher et exporter les journaux de diagnostic à l’aide de l’applet de commande PowerShell Out-GridView

PowerShell fournit une fonctionnalité puissante et facile à utiliser qui affiche les données tabulaires résultant des commandes PowerShell dans une grille de données filtrable et pouvant faire l’objet d’une recherche dans une fenêtre distincte. Vous pouvez utiliser cette grille pour afficher les événements de journaux et effectuer les opérations suivantes sur les données :

  • trier les données selon une colonne quelconque ;

  • afficher les données dans des groupes ;

  • filtrer les données par niveau, zone, catégorie, message, ID d’événement ou horodatage ;

  • rechercher une chaîne quelconque dans les données ;

  • exporter des données brutes, triées ou filtrées vers une feuille de calcul.

Remarque

[!REMARQUE] L'applet de commande Out-GridView ne peut pas être utilisée avec des applets de commande qui utilisent le verbe Format. L'applet de commande Out-GridView reçoit des objets, alors que les applets de commande qui utilisent le verbe Format retournent uniquement du texte mis en forme. > Vous pouvez afficher un sous-ensemble des données à l’aide de l’applet de commande Where-Object qui filtre et transmet les résultats à l’applet de commande Out-GridView . Par exemple : Get-SPLogEvent | Where-Object {$_.Area -eq "SharePoint Foundation"} | Out-GridView. > Si la grille affiche plus de plusieurs centaines de lignes, elle peut s’exécuter lentement, en particulier si vous effectuez des opérations de filtrage complexes. Pour accroître les performances, exportez les données vers Excel 2016.

Pour afficher et filtrer des journaux de diagnostic à l’aide de Windows PowerShell, procédez comme suit :

  1. Vérifiez que vous êtes membre :

  • du rôle serveur fixe securityadmin sur l'instance SQL Server.

  • du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;

  • du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.

    Un administrateur peut utiliser l'applet de commande Add-SPShellAdmin pour accorder des autorisations.

    Remarque

    [!REMARQUE] Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.

  1. Accédez à SharePoint Management Shell.

  2. À partir de l’invite de commandes PowerShell, entrez la commande suivante :

Get-SPLogEvent | Out-GridView

  1. Pour trier les colonnes, cliquez sur l’en-tête de colonne.

  2. Pour rechercher une chaîne spécifique, tapez la chaîne dans la zone Filtrer. La recherche est exécutée sur toutes les colonnes et toutes les lignes. Pour effacer la recherche, cliquez sur X.

  3. Pour filtrer les données en fonction d'un seul critère, tapez ce qui suit dans la zone Rechercher: <nom de propriété>:<valeur>. Par exemple, pour rechercher toutes les entrées de journal générées par SharePoint Foundation 2013, tapez ce qui suit : Area:SharePoint Foundation. Pour effacer le filtre, cliquez sur X.

  4. Pour filtrer les données selon plusieurs critères ou à l’aide de critères tels que « contient, commence par, se termine par » ou d’autres méthodes :

  5. Cliquez sur le bouton Ajouter un critère.

  6. Activez la case à cocher des propriétés sur lesquelles vous souhaitez filtrer, puis cliquez sur Ajouter.

  7. Cliquez sur contient pour basculer vers une méthode de filtrage différente. Les méthodes disponibles sont contient, ne contient pas, commence par, égal à, est différent de, se termine par, est vide et n'est pas vide.

  8. Tapez une valeur dans la zone de texte.

  9. Répétez les étapes « c » et « d » pour chaque propriété sélectionnée à l’étape « b ».

  10. Une fois tous les critères de filtrage spécifiés, les données qui satisfont les critères apparaissent.

  11. Pour effacer un filtre spécifique, cliquez sur le bouton X.

  12. Pour effacer tous les filtres, réduisez l'affichage de requête, puis cliquez sur le bouton Effacer tout.

Pour exporter les données de grille vers une feuille de calcul

  1. Sélectionnez les lignes que vous souhaitez exporter. Vous pouvez sélectionner plusieurs lignes en utilisant Maj+glisser pour sélectionner un bloc de lignes, Ctrl+clic pour sélectionner des lignes spécifiques ou Ctrl+A pour sélectionner toutes les lignes.

    Vous pouvez également filtrer et trier les résultats avant de copier les données dans une feuille de calcul. Lorsque vous triez ou filtrez des données, seules les données affichables résultantes sont copiées.

  2. Copiez les lignes sélectionnées à l’aide de Ctrl+C.

  3. Ouvrez la page de feuille de calcul et collez les lignes copiées à l’aide de Ctrl+V.

Pour plus d’informations, consultez Out-GridView et Out-GridView Revisited.