Partager via


Configurer la journalisation des diagnostics dans SharePoint Server

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

Configuration requise

Le compte d'utilisateur qui exécute ces procédures à partir de l'Administration centraledoit être membre du groupe SharePoint Administrateurs de batterie.

Meilleures pratiques en matière de configuration de la journalisation des diagnostics

L’environnement de SharePoint Server peut nécessiter une configuration des paramètres de journalisation des diagnostics après le déploiement initial, après une mise à niveau et en cas de modification apportée à l’environnement, comme un ajout ou une suppression de serveur. Les instructions de la liste suivante peuvent vous aider à vous former aux meilleures pratiques pour un environnement spécifique.

  • Modifiez le lecteur sur lequel le serveur écrit les journaux.

    Par défaut, SharePoint Server écrit les journaux de diagnostic sur le même lecteur et la même partition que ceux sur lesquels il a été installé. Comme la journalisation des diagnostics peut utiliser une grande quantité d'espace disque et compromettre les performances de lecteur, vous devez configurer SharePoint Server de sorte que l'écriture s'effectue sur un autre lecteur sur lequel SharePoint Server n'est pas installé. Vous devez également penser à la vitesse de connexion au lecteur sur lequel SharePoint Server écrit les journaux. Si la journalisation détaillée est configurée, le serveur enregistre une grande quantité de données. Par conséquent, une connexion lente peut entraîner des performances de journalisation médiocres.

  • Restreignez l’utilisation de l’espace disque.

    Par défaut, la quantité d'espace disque que la journalisation des diagnostics peut utiliser est illimitée. Par conséquent, restreignez l'espace disque utilisé par la journalisation, particulièrement si vous configurez la journalisation afin d'écrire des événements détaillés. Lorsque le disque atteint la restriction, SharePoint Server supprime les journaux les plus anciens avant d'enregistrer de nouvelles données de journalisation.

  • Utilisez le paramètre Détaillé avec modération.

    Vous pouvez configurer la journalisation des diagnostics pour enregistrer des événements détaillés. En d'autres termes, SharePoint Server enregistre toutes les actions effectuées. La journalisation détaillée peut rapidement utiliser l'espace disque et réduire les performances du lecteur et du serveur. Vous pouvez utiliser la journalisation détaillée pour enregistrer davantage d'informations lorsque vous effectuez des modifications importantes, puis reconfigurer la journalisation pour que seuls les événements de niveau supérieur soient enregistrés une fois la modification faite.

  • Sauvegardez régulièrement les journaux.

    Les journaux de diagnostics contiennent des données importantes. Par conséquent, sauvegardez-les régulièrement pour vous assurer que ces données sont préservées. Lorsque vous limitez l'utilisation de l'espace disque du journal, ou que vous ne conservez les journaux que quelques jours, SharePoint Server supprime automatiquement les fichiers journaux, en commençant par les fichiers les plus anciens, lorsque le seuil est atteint.

  • Activez la protection de flux du journal des événements.

    Lorsque vous activez ce paramètre, SharePoint Server détecte les événements récurrents dans le journal des événements Windows et les supprime jusqu’à ce que les conditions redeviennent normales.

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
Aucune
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. Vous devez examiner tous les événements d'erreur.
Avertissement
Ce type de message indique un problème potentiel pouvant nécessiter une attention particulière. Il est conseillé d'examiner et de suivre les messages d'avertissement au fur et à mesure afin que des situations types soient dégagées.
Informations
Les messages d'information ne requièrent pas d'action. En revanche, 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
Aucune
Aucun journal de suivi n’est écrit.
Inattendu
Ce niveau permet d'enregistrer les messages relatifs aux événements qui engendrent un arrêt de traitement pour les solutions. Lorsque ce niveau est défini, le journal inclut les événements des niveaux Inattendu, Exception, Assertion et Critique.
Suivi
Ce niveau permet d'enregistrer les messages relatifs à tous les événements irrécupérables qui limitent la fonctionnalité de la solution sans arrêter pour autant l'application. Lorsque ce niveau est défini, le journal inclut également les événements enregistrés par le paramètre Inattendu.
Importante
Ce niveau permet d'enregistrer tous les événements qui sont inattendus, mais qui n'arrêtent pas le traitement d'une solution. Lorsque ce niveau est défini, le journal inclut également tous les événements enregistrés par le paramètre Suivi.
Moyenne
Lorsque ce niveau est défini, le journal de suivi comprend tous les messages, à l'exception des messages de niveau Détaillé et VerboseEx. Ce niveau permet d'enregistrer toutes les informations de haut niveau sur les opérations effectuées. Il fournit suffisamment de détails pour construire le flux de données et la séquence des opérations. Les administrateurs ou professionnels du support technique peuvent utiliser ce niveau de journalisation pour résoudre des problèmes. Lorsque ce niveau est défini, le journal inclut également tous les événements enregistrés par le paramètre Élevé.
Détaillé
Lorsque ce niveau est défini, le journal inclut la plupart des actions. 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. Lorsque ce niveau est défini, le journal inclut également tous les événements enregistrés par le paramètre Moyen.
VerboseEx
Ce niveau est uniquement pris en charge par l'applet de commande PowerShell Set-SPLogLevel et inclut des données de diagnostic de très faible niveau. Ce niveau doit uniquement être utilisé dans un environnement de développement. Lorsque ce niveau est défini, le journal inclut tous les événements enregistrés par le paramètre Détaillé.

Configurer la journalisation des diagnostics à l’aide de l’Administration centrale

Vous pouvez utiliser l'le site Web Administration centrale de SharePoint pour configurer la journalisation des diagnostics.

Pour configurer la journalisation des diagnostics à l'aide de l'administration centrale

  1. Dans Administration centrale, sur la page d'accueil, cliquez sur Analyse.

  2. Sur la page Analyse, dans la section Rapports, cliquez sur Configuration de la journalisation des diagnostics.

  3. Sur la page de journalisation des diagnostics, dans la section Limitation des événements, configurez la limitation des événements comme suit :

    Pour configurer la limitation pour toutes les catégories d’événements :

  4. Cochez la case Toutes les catégories.

  5. Sélectionnez le niveau du journal des événements dans la liste Événement le moins critique à enregistrer dans le journal d'événements.

  6. Sélectionnez le niveau de journal de suivi dans la liste Événement le moins critique à enregistrer dans le journal de suivi.

    Pour configurer la limitation des événements des différentes catégories :

  7. Cochez les cases associées aux catégories souhaitées.

  8. Sélectionnez le niveau du journal des événements dans la liste Événement le moins critique à enregistrer dans le journal d'événements.

  9. Sélectionnez le niveau de journal de suivi dans la liste Événement le moins critique à enregistrer dans le journal de suivi.

    Pour configurer une limitation des événements pour des sous-catégories (vous pouvez développer les catégories et sélectionnez une sous-catégorie) :

  10. Cliquez sur le signe plus (+) à côté de la catégorie pour la développer.

  11. Cochez la case de la sous-catégorie.

  12. Sélectionnez le niveau du journal des événements dans la liste Événement le moins critique à enregistrer dans le journal d'événements.

  13. Sélectionnez le niveau de journal de suivi dans la liste Événement le moins critique à enregistrer dans le journal de suivi.

    Pour rétablir les paramètres par défaut de limitation des événements pour toutes les catégories :

  14. Cochez la case Toutes les catégories.

  15. Sélectionnez Rétablir les valeurs par défaut dans la liste Événement le moins critique à enregistrer dans le journal d'événements.

  16. Sélectionnez Rétablir les valeurs par défaut dans la liste Événement le moins critique à enregistrer dans le journal de suivi.

  17. Dans la section Protection de flux du journal des événements, cochez la case Activer la protection de flux du journal des événements.

  18. Dans la section Journal de suivi, dans la zone Chemin d'accès, entrez le chemin d'accès du dossier dans lequel écrire les journaux.

  19. Dans la zone Nombre de jours de conservation des fichiers journaux, entrez le nombre de jours (1-366) pendant lesquels vous souhaitez conserver les journaux. Après cette période de temps, les journaux seront supprimés automatiquement.

  20. Pour limiter l'espace disque que les journaux peuvent utiliser, activez la case à cocher Limiter l'utilisation de l'espace disque pour les journaux de suivi, puis entrez le nombre maximal de gigaoctets (Go) auquel vous voulez limiter les fichiers journaux. Quand les journaux atteignent cette valeur, les journaux les plus anciens sont supprimés automatiquement.

  21. Une fois que vous avez effectué les modifications souhaitées sur la page Journalisation des diagnostics, cliquez sur OK.

Configurer la journalisation des diagnostics à l’aide de PowerShell

Vous pouvez utiliser PowerShell pour configurer la journalisation des diagnostics.

Pour configurer la journalisation des diagnostics à 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 la cmdlet Add-SPShellAdmin pour accorder des autorisations d'utilisation des cmdlets PowerShell.

    Notes

    [!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.

  2. Ouvrez SharePoint Management Shell et modifiez le lecteur sur lequel le serveur écrit les journaux.

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

    Set-SPDiagnosticConfig -LogLocation D:\DiagnosticLogs
    
  4. Pour limiter l'utilisation de l'espace disque par les journaux, à l'invite de commandes PowerShell, tapez la commande suivante :

    Set-SPDiagnosticConfig -LogMaxDiskSpaceUsageEnabled
    

Sinon, attribuez l’espace disque minimal aux journaux :

Set-SPDiagnosticConfig -LogDiskSpaceUsageGB 500
  1. Pour visualiser le niveau de journalisation actuel, à l'invite de commandes PowerShell, tapez la commande suivante :

    Get-SPLogLevel
    
  2. Pour modifier le niveau de journalisation, à l'invite de commandes PowerShell, tapez la commande suivante :

    Set-SPLogLevel -TraceSeverity Monitorable
    

Pour rétablir les niveaux par défaut de toutes les catégories, à l'invite de commandes PowerShell, tapez la commande suivante, puis appuyez sur Entrée :

Clear-SPLogLevel
  1. Pour activer la protection de flux du journal des événements, à l'invite de commandes PowerShell, tapez la commande suivante :

    Set-SPDiagnosticConfig -EventLogFloodProtectionEnabled
    

Pour plus d'informations, voir Set-SPDiagnosticConfig, Set-SPLogLevel et Get-SPLogLevel.

Voir aussi

Concepts

Vue d'ensemble de l'analyse dans SharePoint Server 2016