Créer une session Événements étendus à l'aide de la boîte de dialogue Nouvelle session
La boîte de dialogue Nouvelle session permet de définir une session Événements étendus qui capture, affiche et analyse vos données. La boîte de dialogue Nouvelle session expose toutes les fonctionnalités Événements étendus.
L'Assistant Nouvelle session vous permet également de définir une session Événements étendus, prenant en charge la plupart des fonctionnalités Événements étendus.
Pour commencer
Pour ouvrir la boîte de dialogue Nouvelle session, dans l'Explorateur d'objets, développez le nœud Gestion, puis Événements étendus. Cliquez avec le bouton droit sur Sessions, puis sélectionnez Nouvelle session.
Autorisations
Pour créer une session d'événements étendus, vous devez disposer de l'autorisation ALTER ANY EVENT SESSION.
Pour créer une session Événements étendus à l'aide de la boîte de dialogue Nouvelle session
Utilisez la page Général pour sélectionner un modèle et planifier une session d'événements.
Pour sélectionner un modèle et planifier une session d'événements
Dans l'Explorateur d'objets, développez le nœud Gestion, puis Événements étendus. Cliquez avec le bouton droit sur Sessions, puis cliquez sur Nouvelle session.
Sur la page Général, dans la zone Nom de session, tapez un nom explicite pour la session d'événements.
Dans la zone Modèle, sélectionnez le modèle à utiliser dans la liste déroulante.
Vous pouvez sélectionner un jeu de modèles préconfigurés conçu pour les problèmes courants ou vous pouvez sélectionner À partir du fichier pour utiliser un fichier modèle exporté d'une définition de session précédente. Notez que vous pouvez également modifier la configuration de la session après avoir appliqué le modèle.
Dans la section Planification, si vous souhaitez démarrer la session lorsque vous démarrez le serveur, activez la case à cocher Démarrer la session d'événements au démarrage du serveur.
Si vous souhaitez démarrer la session après avoir créé la session, activez la case à cocher Démarrer la session d'événements immédiatement après la création de la session.
Pour consulter les données actives de votre session d'événements, cliquez sur Observer les données actives à l'écran lors de leur capture. Les données actives commenceront à afficher la trace une fois la session créée.
Dans la section Suivi de la causalité, activez la case à cocher Assurer le suivi des liens entre les événements pour suivre un travail sur plusieurs tâches.
Pour plus d'informations sur le suivi de causalité, consultez « Contenu et caractéristiques de la session » dans la rubrique Sessions Événements étendus SQL Server.
Pour ajouter des événements à votre session, dans la section Sélectionner une page, cliquez sur Événements.
[!REMARQUE]
Ne cliquez pas sur OK avant d'avoir créé la session d'événements.
Utilisez la page Événements pour rechercher et ajouter les événements que vous souhaitez capturer pour la session.
Pour ajouter des événements à une session
Dans la boîte de dialogue Nouvelle session, dans la section Sélectionner une page, sélectionnez Événements.
Sur la page Événements, cliquez sur Sélectionner (le bouton Sélectionner est estompé si vous êtes déjà au niveau de l'écran Sélectionner les événements à capturer).
Vous pouvez rechercher un mot dans la table en entrant le texte à rechercher dans la zone Bibliothèque d'événements. Par exemple, si vous souhaitez rechercher l'événement lock_acquired, vous pouvez entrer lock ou lock acquire.
Dans la section Bibliothèque d'événements, sélectionnez comment vous souhaitez rechercher les événements à capturer dans la liste déroulante. Par exemple, vous pouvez rechercher des noms d'événements ou des noms d'événements et leurs descriptions. Entrez vos critères de recherche dans la zone Rechercher.
[!REMARQUE]
Les événements du canal de débogage sont masqués par défaut. Pour afficher des événements de débogage, sélectionnez Débogage dans la liste déroulante Canal.
Les détails des événements sélectionnés s'affichent dans le volet d'informations sous Bibliothèque d'événements.
Les événements sont triés par nom dans l'ordre alphabétique. Vous pouvez trier par d'autres détails de l'événement en cliquant sur l'en-tête de colonne approprié. Par exemple, vous pouvez trier par la colonne Catégorie ou Canal.
Sélectionnez le ou les événements à capturer, puis cliquez sur la flèche droit pour déplacer le ou les événements vers la section Événements sélectionnés.
[!REMARQUE]
Vous pouvez sélectionner simultanément plusieurs événements de la Bibliothèque d'événements à l'aide de la touche Ctrl ou Maj.
Pour configurer les événements sélectionnés, cliquez sur Configurer.
[!REMARQUE]
Ne cliquez pas sur OK avant d'avoir créé la session d'événements.
Vous utilisez la page Stockage de données pour ajouter des cibles à une session d'événements. Les cibles stockent des données d'événement et peuvent effectuer des actions telles que l'enregistrement des événements dans un fichier afin d'afficher et d'agréger ultérieurement les données d'événement pour la session. Pour plus d'informations sur les cibles des événements étendus, consultez Cibles des Événements étendus SQL Server.
Vous pouvez utiliser les cibles suivantes pour une session d'événements étendus :
etw_classic_sync_target. Permet de mettre en corrélation les événements SQL Server avec les données d'événement du système d'exploitation Windows ou des applications.
event_counter. Permet de comptabiliser tous les événements qui surviennent après avoir démarré une session d'événements étendus. Permet d'obtenir des informations sur les caractéristiques de charge de travail sans ajouter la surcharge de la collecte d'événements complète.
event_file. Permet d'enregistrer sur le disque les résultats d'une session d'événements stockés en mémoire tampon.
histogramme. À utiliser pour comptabiliser le nombre d'occurrences d'un événement donné, en fonction d'une colonne d'événement ou d'une action définie.
pair_matching. Permet de savoir si un événement jumelé n'entre pas dans le cadre d'une correspondance.
ring_buffer. Permet de conserver les événements en mémoire selon le principe FIFO (premier entré/premier sorti) ou au cas par cas.
Pour configurer des champs globaux pour une session
Sur la page Événements, après avoir sélectionné les événements à ajouter à la session d'événements, cliquez sur Configurer.
Après avoir cliqué sur Configurer, la section Bibliothèque d'événements est réduite, et la section Événements sélectionnés glisse à gauche de la page. La section Options de configuration d'événement que vous utilisez pour configurer les événements apparaît à droite de la page. Vous utilisez les onglets de cette page pour configurer des actions pour votre session d'événements.
Sous l'onglet Champs globaux, sélectionnez les champs à appliquer aux événements sélectionnés.
Vous pouvez sélectionner plusieurs champs pour chaque événement.
[!REMARQUE]
Si deux événements qui sont déjà sélectionnés ont des actions configurées différentes, les événements étendus afficheront les actions partiellement activées. Pour rechercher rapidement les actions activées, vous pouvez trier par l'état activé/désactivé en cliquant sur l'en-tête de colonne au-dessus des cases à cocher.
Sous l'onglet Filtres, appliquez les filtres (également appelés prédicats) pour limiter les événements à capturer.
Si un filtre est appliqué à l'événement sélectionné, une coche s'affiche dans la colonne.
[!REMARQUE]
Vous pouvez sélectionner plusieurs événements auxquels vous souhaitez appliquer un filtre à à l'aide des touches Ctrl ou Maj. Toutefois, seuls les champs d'événement communs apparaîtront pour la configuration. Si des filtres différents sont déjà configurés pour deux événements sélectionnés, le filtre n'apparaîtra pas. Reconfigurer des filtres permet de remplace des valeurs de filtre existantes.
[!REMARQUE]
Lorsque vous configurez une clause de groupe pour votre filtre, les parenthèses redondantes sont supprimées du filtre une fois le résultat enregistré. Par exemple, si vous créez un regroupement de filtre Clause 1 et Clause 2, les parenthèses apparaîtront autour des clauses. Une fois que vous avez enregistré le filtre, les parenthèses redondantes sont supprimées. La suppression des parenthèses n'affecte pas la logique de filtre.
Sous l'onglet Champs d'événements, vous sélectionnez les champs d'événements à appliquer à un événement sélectionné.
Les événements contiennent plusieurs champs qui sont toujours recueillis, lesquels sont affichés sous l'onglet Champs d'événements sans case à cocher. Un événement peut également avoir des champs facultatifs qui ne sont pas recueillis par défaut (par exemple, les champs facultatifs chers ne sont pas sélectionnés). Les champs facultatifs apparaissent également sous l'onglet Champs d'événements avec cases à cocher. Pour recueillir un champ facultatif, activez la case à cocher devant le champ facultatif.
[!REMARQUE]
Les options de champ d'événement afficheront des champs qui seront capturés et affichés dans les résultats de trace. (Les événements étendus affichent seulement des types de données de champs d'événements. Par exemple, les champs d'événements en lecture seule ne sont pas affichés.) Si vous sélectionnez deux événements ou plus, la boîte de dialogue Nouvelle session affiche un espace sous l'onglet Champs d'événements.
Pour ajouter des cibles à une session d'événements, dans la section Sélectionner une page, sélectionnez Stockage de données.
[!REMARQUE]
Ne cliquez pas sur OK avant d'avoir créé la session d'événements.
Pour ajouter des cibles à une session d'événements
Dans la boîte de dialogue Nouvelle session, dans la section Sélectionner une page, sélectionnez Stockage de données.
Sur la page Stockage de données, sélectionnez le type de cible dans la liste déroulante.
Une fois que vous avez sélectionné le type de cible, la description de la cible s'affiche. Vous pouvez ajouter une cible une seule fois. Si vous avez déjà ajouté la cible à la session, elle ne s'affichera pas dans la liste déroulante.
Cliquez sur Ajouter pour ajouter une cible pour la session d'événements. Pour supprimer une cible, cliquez sur Supprimer.
Les propriétés cibles apparaissent sous la section Cibles, selon la cible sélectionnée.
Vous pouvez spécifier les propriétés suivantes, en fonction des cibles sélectionnées :
Cible
Propriétés cibles
etw_classic_sync_target
Nom du fichier journal de la session sur le serveur. Entrez le nom du fichier journal et le répertoire sur le serveur, ou cliquez sur Parcourir pour rechercher et sélectionner le fichier journal.
Taille maximale du fichier journal. Entrez la taille maximale du fichier journal pour l'événement du Suivi d'événements pour Windows (ETW). La valeur par défaut est 20 mégaoctets (Mo). Vous pouvez sélectionner une unité différente de stockage dans la liste déroulante.
Taille de la mémoire tampon. Entrez la taille de la mémoire tampon pour la session d'événements. La valeur par défaut est 128 kilo-octets (Ko). Vous pouvez sélectionner une unité différente de stockage dans la liste déroulante.
Nom de session. Entrez un nom de session ETW explicite.
Réessayer en cas d'erreur d'écriture dans le suivi des événements ETW. Activez cette case à cocher pour effectuer une nouvelle tentative de publication de l'événement dans le sous-système ETW.
Nombre maximal de tentatives. Entrez le nombre maximal de nouvelles tentatives de publication de l'événement dans le sous-système ETW avant la suppression de l'événement. Le nombre de tentatives par défaut est zéro (0). Pour cette propriété cible, zéro (0) signifie aucune tentative.
event_counter
Il n'y a pas de propriété cible pour le compteur d'événements.
event_file
Nom du fichier sur le serveur. Entrez le répertoire et le nom du fichier cible sur le serveur, ou cliquez sur Parcourir pour rechercher et sélectionner le fichier cible.
Taille de fichier maximale Spécifiez la taille de fichier maximale pour la cible de fichier. Si vous ne spécifiez pas de taille de fichier maximale, la taille du fichier augmente jusqu'à ce que le disque soit saturé. La taille de fichier par défaut est 1 gigaoctet (Go). Vous pouvez sélectionner une unité différente de stockage dans la liste déroulante.
Activer la substitution de fichier. Activez cette case à cocher pour permettre la substitution de fichier pour la cible de fichier.
Nombre maximal de fichiers. Entrez le nombre maximal de fichiers à conserver dans le système de fichiers.
histogramme
Événement sur lequel filtrer. Sélectionnez l'événement sur lequel vous souhaitez filtrer dans la liste déroulante. Vous pouvez appliquer un filtre sur tout événement qui existe dans la session d'événements. Vous pouvez également sélectionner <Aucun> dans la liste déroulante pour inclure tous les événements et les compartiments de base sur l'action.
Baser les compartiments sur : Action. Sélectionnez cette option pour baser les compartiments sur le nom d'action utilisé comme source de données, puis sélectionnez l'action dans la liste déroulante.
Baser les compartiments sur : Champ. Sélectionnez cette option pour baser les compartiments sur le champ d'événement utilisé comme source de données, puis sélectionnez le champ dans la liste déroulante.
Nombre maximal de compartiments. Entrez le nombre maximal de compartiments à conserver. Lorsque cette valeur est atteinte, la session d'événements ignore tous les nouveaux événements qui n'appartiennent pas aux compartiments existants.
pair_matching
Événements : Commencer par. Sélectionnez le nom d'événement dans la liste déroulante qui spécifie l'événement de début dans une séquence appariée.
Événements : Se terminer par. Sélectionnez le nom d'événement dans la liste déroulante qui spécifie l'événement de fin dans une séquence appariée.
Champs et actions : Commencer par. Sélectionnez le champ de début et/ou l'action dans une séquence appariée dans la liste déroulante.
Champs et actions : Se terminer par. Sélectionnez le champ de fin et/ou l'action dans une séquence appariée dans la liste déroulante.
Ignorer les nouveaux événements non appariés en cas de sollicitation de la mémoire. Activez cette case à cocher pour cesser de collecter des événements dans la cible pair_matching lorsque la mémoire de l'ordinateur est sollicitée. Lorsque la mémoire ne sera plus sollicitée, la collecte des événements reprendra.
Nombre maximal d'événements orphelins. Spécifiez le nombre maximal d'événements orphelins à conserver dans la mémoire.
ring_buffer
Nombre d'événements à conserver. Utilisez les flèches haut et bas pour spécifier le nombre d'événements à conserver. La valeur par défaut est 1 000.
Taille maximale de la mémoire tampon. Entrez la quantité de mémoire maximale à utiliser. Les événements existants sont supprimés lorsque cette valeur est atteinte. La taille de la mémoire par défaut est 0 mégaoctet (Mo), c'est-à-dire, illimitée. Vous pouvez sélectionner une unité différente de stockage dans la liste déroulante.
Conserver un nombre spécifique d'événements (par type) lorsque la mémoire tampon est saturée. Sélectionnez cette option pour conserver un nombre spécifique d'événements de chaque type dans la mémoire tampon.
Nombre d'événements à conserver (par type). Entrez le nombre par défaut d'événements de chaque type à conserver dans la mémoire tampon.
Si vous souhaitez définir des propriétés de configuration avancées, sélectionnez Avancé dans la section Sélectionner une page.
[!REMARQUE]
Ne cliquez pas sur OK avant d'avoir créé la session d'événements.
Pour définir des configurations avancées
Dans la boîte de dialogue Nouvelle session, dans la section Sélectionner une page, sélectionnez Avancé.
Sur la page Avancé, pour spécifier les options Mode de rétention d'événement de la session d'événements, procédez comme suit :
Perte d'événement unique. Sélectionnez cette option pour autoriser la perte d'un événement unique.
Perte d'événements multiples. Sélectionnez cette option pour autoriser la perte de plusieurs événements.
Aucune perte d'événement. Sélectionnez cette option si vous souhaitez empêcher la perte d'événement. Cette option n'est pas recommandée.
[!REMARQUE]
Certains événements tels que l'événement sqlos.wait_info ne sont pas compatibles avec le mode de rétention d'événement Aucune perte d'événement.
Pour spécifier les options Latence maximale de répartition pour la session d'événements, procédez comme suit :
En secondes. Sélectionnez cette option pour prolonger ou raccourcir la latence de répartition maximale. Utilisez les flèches haut et bas pour spécifier la latence de répartition maximale en secondes.
Illimitée. Sélectionnez cette option si vous souhaitez distribuer les événements uniquement lorsque la mémoire tampon est saturée.
Dans la zone Taille de la mémoire maximale, entrez la taille de mémoire maximale. Les événements existants sont supprimés lorsque cette valeur est atteinte. Vous pouvez sélectionner une unité différente de stockage dans la liste déroulante.
Dans la zone Taille d'événement maximale, entrez la taille d'événement maximale pour les événements qui sont trop grands pour être contenus dans la Taille de la mémoire maximale. Si vous ne collectez pas d'événements très volumineux, vous n'avez pas besoin de configurer cette option. Vous pouvez sélectionner une unité différente de stockage dans la liste déroulante.
Pour spécifier les options Mode de partition mémoire pour la session d'événements, procédez comme suit :
Aucun. Sélectionnez cette option si vous ne souhaitez pas de mode de partition de la mémoire.
Par nœud. Sélectionnez cette option si vous souhaitez partitionner la mémoire par nœud.
Par UC. Sélectionnez cette option si vous souhaitez partitionner la mémoire par UC.
Pour restaurer les valeurs par défaut de configuration pour les propriétés de session précédentes, cliquez sur Paramètres par défaut.
Voir aussi
Tâches
Créer une session d'événements étendus à l'aide de l'Assistant (Explorateur d'objets)
Générer un script de session d'événements étendus
Concepts
Créer une session d'événements étendus à l'aide de l'éditeur de requête