Afficher les données de la base de données de journalisation dans SharePoint Server
S’APPLIQUE À :
2013
2016
2019
Subscription Edition
SharePoint in Microsoft 365
Introduction à la base de données de journalisation de SharePoint
Vues SQL prédéfinies dans la base de données de journalisation de SharePoint
Vues SQL personnalisées dans la base de données de journalisation de SharePoint
Notes
[!REMARQUE] SharePoint Server 2016 s'exécutant en tant que sites web dans Internet Information Services (IIS), les administrateurs et les utilisateurs dépendent des fonctionnalités d'accessibilité fournies par les navigateurs. SharePoint Server 2016 prend en charge les fonctionnalités d'accessibilité des navigateurs pris en charge. Pour plus d’informations, voir les ressources suivantes : > Plan browser support > Accessibility guidelines in SharePoint > Accessibility in SharePointKeyboard > shortcuts > Touch.
Introduction à la base de données de journalisation de SharePoint
Pour analyser les serveurs qui exécutent SharePoint Server 2016 et les services qui s'exécutent sur les serveurs, vous pouvez accéder directement à divers journaux tels que les journaux des événements Windows Server, les journaux du service ULS (Unified Logging Service) de SharePoint (également appelés journaux de suivi) ou les journaux de données d'utilisation. Vous pouvez également accéder au le site Web Administration centrale de SharePoint de SharePoint Server 2016 pour consulter divers rapports. Les rapports de l'analyseur d'intégrité SharePoint contiennent des règles pour les serveurs ou les services. Les rapports d'administration (diagnostics) contiennent des informations liées aux recherches. Les rapports Web Analytics contiennent des mesures d'analyse web. Pour plus d'informations sur les rapports, voir Afficher des rapports et des journaux dans SharePoint Server 2016.
Toutes les méthodes d'analyse mentionnées précédemment ont des limites. Par exemple, les journaux des événements Windows Server, les journaux ULS de SharePoint et les journaux de données d'utilisation ne sont pas stockés à un emplacement unique. Vous devez accéder à différents endroits pour trouver les journaux associés. De même, bien que les rapports de l'Administration centrale contiennent les mesures et informations d'analyse les plus fréquemment utilisées, si vous souhaitez ajouter d'autres informations d'analyse à ces rapports, vous ne pouvez pas le faire car ils sont prédéfinis et ne peuvent pas être modifiés.
Vous pouvez augmenter l'efficacité d'analyse en utilisant la base de données de journalisation dans SharePoint Server 2016. La base de données de journalisation est un référentiel à l'échelle de la batterie de serveurs des informations d'analyse SharePoint Server 2016 pour chaque serveur dans la batterie. La base de données de journalisation offre la possibilité de visualiser et de personnaliser diverses informations d'analyse dans un emplacement unique. En outre, la base de données de journalisation est la seule base de données de journalisation de base de données SharePoint Server 2016 pour laquelle vous pouvez personnaliser les rapports en modifiant directement la base de données.
Notes
Pour plus d'informations sur les bases de données SharePoint Server 2016, voir Types et descriptions des bases de données dans SharePoint Server.
Notes
Le nom par défaut de la base de données est SharePoint_Logging. Vous pouvez changer ce nom par défaut et l'emplacement du serveur de base de données SharePoint à l'aide de Microsoft PowerShell. Pour plus d'informations sur le nom de la base de données de journalisation et l'emplacement du serveur de base de données, voir Configurer la collecte de données relatives à l'utilisation et à l'intégrité dans SharePoint Server.
Un emplacement unique qui stocke diverses informations d'analyse vous aide à analyser efficacement les serveurs et les services SharePoint Server 2016. Plus important, vous pouvez créer vos propres rapports pour des besoins d'analyse, de rapport et de dépannage uniques basés sur des tables de la base de données de journalisation. Cet article décrit la création de rapports à l'aide de tables et de vues existantes. Vous pouvez écrire vos propres fournisseurs pour créer de nouvelles tables.
Notes
Une vue SQL est une table virtuelle. Une différence entre une vue SQL et une table est vous pouvez modifier les données à l’intérieur d’une table, alors que cette modification est impossible dans une vue SQL.
Vous utilisez SharePoint Administration centrale de Server 2016 pour configurer les journaux importés dans la base de données de journalisation. Pour plus d'informations sur la configuration des catégories de journaux, des niveaux de journaux et du chemin du journal de suivi (ULS), voir Configurer la journalisation des diagnostics dans SharePoint Server. Pour plus d'informations sur l'activation des informations écrites dans la base de données de journalisation, voir Configurer la collecte de données relatives à l'utilisation et à l'intégrité dans SharePoint Server. Pour plus d'informations sur la spécification du serveur, du nom et des informations d'authentification de la base de données de journalisation, les événements à écrire dans la base de données de journalisation et la fréquence d'écriture des journaux dans cette base de données (c'est-à-dire les travaux du minuteur associés à l'importation de la base de données d'utilisation), voir Configurer des travaux du minuteur de l'analyseur d'intégrité SharePoint dans SharePoint Server 2016.
Les procédures dans cet article utilisent SQL Server Management Studio pour accéder à la base de données de journalisation. Management Studio est un composant de SQL Server 2008.
Notes
Pour accéder à la base de données de journalisation, vous devez avoir l'authentification Windows (recommandée) ou l'authentification SQL. Les informations d'authentification de base de données sont configurées dans l'Administration centrale de SharePoint Server 2016. Pour plus d'informations sur les méthodes d'authentification, voir Configurer la collecte de données relatives à l'utilisation et à l'intégrité dans SharePoint Server.
Vues SQL prédéfinies dans la base de données de journalisation de SharePoint
Cette section décrit les tables de partition et les vues SQL à l'intérieur de la base de données de journalisation de SharePoint Server 2016, et inclut les trois procédures suivantes :
Pour accéder à la base de données de journalisation en utilisant SQL Server Management Studio
Pour afficher les informations de journalisation à partir de vues par défaut
Pour exporter et afficher des données de journalisation en utilisant Excel
La base de données de journalisation utilise une table de partition séparée pour les données quotidiennes de chaque catégorie. Par exemple, les données d'utilisation du travail du minuteur pour la première journée sont écrites dans la table dbo.TimerJobUsage_Partition0 et les données pour 32 jours plus tard sont écrites dans la table dbo.TimerJobUsageUsage_Partition31. Les journaux d'un jour sont écrits dans une table de partition. Cela signifie que pour chaque catégorie de journal, chaque table de partition stocke les journaux d'un jour particulier.
Notes
Le mappage entre une table de partition et la date exacte dépend de la période de rétention de la base de données de journalisation et de la date de début d'écriture des journaux dans la base de données de journalisation. Vous pouvez obtenir le mappage en observant les informations temporelles dans chaque table. Par exemple, si la période de rétention est de 14 jours et si les journaux d'aujourd'hui sont écrits dans la table de partition 2, les journaux de demain seront écrits dans la table de partition 3, etc. Après 14 jours, tous les journaux sont supprimés et les nouveaux journaux sont écrits dans ces tables de partition en commençant à partir de la table de partition 0.
Vous pouvez utiliser les vues SQL prédéfinies dans Management Studio pour afficher toutes les informations d'analyse à un seul endroit. Chaque vue prédéfinie collecte les données des 32 tables de partition pour la catégorie de journal spécifique. Par exemple, vous pouvez afficher les informations d'analyse dans 32 tables de dbo.TimerJobUsage_Partition0 à dbo.TimerJobUsageUsage_Partition31.
Pour accéder aux vues prédéfinies, vous devez accéder à la base de données de journalisation de SharePoint Server 2016. Ensuite, à partir de la base de données de journalisation, vous affichez les informations d'analyse.
Pour accéder à la base de données de journalisation à l'aide de Management Studio
Vérifiez que le compte d'utilisateur qui exécute cette procédure a le rôle de base de données fixe db_owner.
Dans la barre des tâches, cliquez sur Démarrer, pointez sur Tous les programmes, cliquez sur Microsoft SQL Server 2008 ou sur la dernière version de Microsoft SQL Server qui est installée, puis cliquez sur SQL Server Management Studio.
Notes
Si vous n'avez pas Management Studio sur le serveur, réinstallez SQL Server 2008 et ajoutez le composant Management Studio. Pour plus d'informations, voir la page relative à l'installation de SQL Server.
Dans la boîte Connecter serveur, choisissez Moteur de base de données. Spécifiez ensuite le nom du serveur, par exemple, ServerName\SharePoint. Sélectionnez le type d'authentification ( Authentification Windows ou Authentification SQL Server) que vous avez configuré par l'Administration centrale de SharePoint Server 2016. Si vous utilisez l' Authentification SQL Server, spécifiez les informations d'identification pour l'administrateur de la base de données. Une fois les informations définies, cliquez sur Connecter.
Accédez à la vue Explorateur d'objets en cliquant sur Vue, puis en cliquant sur Explorateur d'objets. Développez Bases de données pour voir la base de données de journalisation qui porte le nom par défaut SharePoint_Logging ou un nom que vous avez configuré dans l'Administration centrale.
Développez éventuellement la base de données de journalisation pour voir les tables et les vues.
Pour afficher les informations de journalisation à partir des vues par défaut
Vérifiez que le compte d'utilisateur qui exécute cette procédure a le rôle de base de données fixe db_owner.
Dans Management Studio, accédez au nœud de la base de données de journalisation en utilisant la procédure précédente.
Développez le nœud Vues de la base de données pour voir les vues par défaut. Cliquez avec le bouton droit sur la vue, par exemple dbo.RequestUsage, et choisissez Sélectionner les 1000 lignes du haut.
L'opération Sélectionner les 1000 lignes du haut est le script de requête T-SQL suivant :
/****** Script for SelectTopNRows command from SSMS ******/ SELECT TOP 1000 [PartitionId] ,[RowId] ,[LogTime] ,[MachineName] ,[FarmId] ,[SiteSubscriptionId] ,[UserLogin] ,[CorrelationId] ,[WebApplicationId] ,[ServerUrl] ,[SiteId] ,[SiteUrl] ,[WebId] ,[WebUrl] ,[DocumentPath] ,[ContentTypeId] ,[QueryString] ,[BytesConsumed] ,[HttpStatus] ,[SessionId] ,[ReferrerUrl] ,[ReferrerQueryString] ,[Browser] ,[UserAgent] ,[UserAddress] ,[RequestCount] ,[QueryCount] ,[QueryDurationSum] ,[ServiceCallCount] ,[ServiceCallDurationSum] ,[OperationCount] ,[Duration] ,[RequestType] ,[Title] ,[RowCreatedTime] FROM [SharePoint_Logging].[dbo].[RequestUsage]Les 1 000 premières lignes de la catégorie de table Request Usage apparaissent dans la fenêtre de résultats.
Vous pouvez modifier la requête T-SQL dans la fenêtre de l'éditeur SQL. Par exemple, s'il y a plus de 1 000 lignes dans les tables, vous pourriez souhaiter afficher les 5 000 premières lignes. Pour cela, changez le script en remplaçant « SELECT TOP 1000 » par « SELECT TOP 5000 », puis cliquez sur Exécuter.
Si vous souhaitez afficher les journaux en utilisant des outils autres que Management Studio, vous pouvez extraire les informations d'analyse des vues et les enregistrer sous forme de fichier texte ou de fichier CSV. Dans la procédure suivante, Excel est utilisé comme exemple.
Pour exporter et afficher des données de journalisation à l'aide d'Excel
Vérifiez que le compte d'utilisateur qui exécute cette procédure a le rôle de base de données fixe db_owner.
Dans Management Studio, accédez au nœud de base de données de journalisation.
Développez le nœud Vues, cliquez avec le bouton droit sur la vue depuis laquelle vous souhaitez extraire des données, puis cliquez sur Sélectionner les 1000 lignes du haut.
Dans la fenêtre de résultats, cliquez avec le bouton droit, puis cliquez sur Sélectionner tout. Cliquez ensuite avec le bouton droit, puis cliquez sur Enregistrer les résultats….
Dans la fenêtre Enregistrer les résultats de la grille, spécifiez le dossier dans lequel vous souhaitez enregistrer le fichier, spécifiez le Type de fichier CSV (Séparé par des virgules), puis spécifiez un nom de fichier approprié.
Ouvrez le fichier CSV en double-cliquant dessus dans Excel.
Vues SQL personnalisées dans la base de données de journalisation de SharePoint
La base de données de journalisation dans SharePoint Server 2016 permet de créer des rapports personnalisés de deux manières. Vous pouvez générer de nouvelles vues en combinant les informations associées de tables existantes, ou vous pouvez écrire des fournisseurs pour générer de nouvelles tables de partition dans la base de données de journalisation. Les exemples de cette section illustrent uniquement la première méthode.
Dans les tables d'utilisation et les tables ULSTraceLog, CorrelationId est un paramètre important pour le dépannage. En effet, chaque message d'erreur contient un identifiant CorrelationId unique. CorrelationId est un GUID qui lit toutes les informations associées à une demande. La procédure suivante montre comment créer une vue personnalisée qui lie plusieurs catégories de journaux en utilisant l'identifiant CorrelationId.
Pour créer une vue SQL personnalisée qui utilise des tables existantes
Vérifiez que le compte d'utilisateur qui exécute cette procédure a le rôle de base de données fixe db_owner.
Dans Management Studio, accédez au nœud de base de données de journalisation.
Dans la base de données de journalisation, développez le nœud Vues. Choisissez l'une des vues pour lequel vous souhaitez collecter des informations. Cliquez avec le bouton droit sur la vue, puis cliquez sur Nouvelle vue….
Dans la fenêtre Ajouter une table, choisissez les tables à ajouter. Par exemple, si vous souhaitez obtenir des informations sur les demandes du site d'utilisation de composants fonctionnels pour un jour particulier, vous pouvez ajouter dbo.FeatureUsage_Partion1 et dbo.RequestUsage_Partion1.
La requête T-SQL applique automatiquement une jointure interne sur la clé unique PartionId dans ces deux tables.
SELECT
FROM dbo.FeatureUsage_Partition1 INNER JOIN
dbo.RequestUsage_Partition1 ON dbo.FeatureUsage_Partition1.PartitionId = dbo.RequestUsage_Partition1.PartitionId
Annulez la jointure entre les deux tables en cliquant avec le bouton droit sur le lien entre ces tables et en sélectionnant Suppression.
Pour appliquer une jointure interne entre les deux tables en utilisant CorrelationId, cliquez sur la colonne CorrelationId d'une table et positionnez le pointeur sur CorrelationId dans une autre table. Sinon, vous pouvez modifier la requête SQL directement dans l'Éditeur de requête.
SELECT
FROM dbo.FeatureUsage_Partition1 INNER JOIN
dbo.RequestUsage_Partition1 ON dbo.FeatureUsage_Partition1.CorrelationId = dbo.RequestUsage_Partition1.CorrelationId
Choisissez les colonnes dans chaque table que vous souhaitez afficher dans la nouvelle vue.
Cliquez avec le bouton droit et choisissez Exécuter SQL. Les résultats apparaissent dans la fenêtre de résultats.
Voir aussi
Concepts
Afficher des rapports et des journaux dans SharePoint Server 2016