Gérer les sessions d’événements dans l’Explorateur d’objets

Article
03/29/2023

S’applique à :SQL Server Azure SQL Database Azure SQL Managed Instance

Cette rubrique décrit les actions effectuées dans l' Explorateur d'objets qui affectent les événements étendus :

Créer une session d’événements étendus
Démarrer ou arrêter une session d'événements étendus
Exporter une session d'événements étendus
Importer un modèle de session d'événements étendus
Modifier une session d'événements étendus
Supprimer une session d'événements étendus

Créer une session d’événements étendus

Pour plus d'informations sur la création d'une session d'événements étendus, consultez Create an Extended Events Session.

Démarrer ou arrêter une session d'événements étendus

Vous pouvez démarrer ou arrêter une session d'événements étendus via l' Éditeur de requête en utilisant l'instruction ALTER EVENT SESSION , ou en utilisant le nœud Événements étendus de l' Explorateur d'objets.

Quand vous arrêtez une session d’événements, la session n’apparaît plus comme une session active dans la vue de gestion dynamique sys.dm_xe_sessions. Toutefois, la définition de session reste intacte, et vous pouvez redémarrer la session. Pour supprimer complètement une définition de session, vous devez supprimer la session.

Pour démarrer ou arrêter une session d'événements étendus, vous devez disposer de l'autorisation ALTER ANY EVENT SESSION.

Quand vous arrêtez une session qui utilise une cible en mémoire, telle que la cible de mémoire tampon en anneau, la cible de création de compartiments, la cible d’appariement d’événements ou la cible de compteur d’événements synchrone, toutes les informations stockées dans la mémoire tampon de la session (colonne target_data de la vue de gestion dynamique sys.dm_xe_session_targets) sont perdues. Pour accéder aux données d'un événement après avoir interrompu une session, vous devez enregistrer les données avant de mettre fin à la session ou configurer la session pour pouvoir utiliser un fichier cible.

Démarrer ou arrêter une session d'événements étendus à l'aide de l'Éditeur de requête

Pour démarrer une session, émettez les instructions suivantes, en remplaçant session_name par le nom de la session d’événements étendus :

ALTER EVENT SESSION [session_name]  
ON SERVER  
STATE = START

Pour arrêter une session, émettez les instructions suivantes, en remplaçant session_name par le nom de la session d’événements étendus :

ALTER EVENT SESSION [session_name]  
ON SERVER  
STATE = STOP

Démarrer ou arrêter une session d'événements étendus dans l'Explorateur d'objets

Pour démarrer ou arrêter une session Événements étendus dans l’Explorateur d’objets, développez la gestion, les événements étendus, puis les nœuds Sessions , puis cliquez avec le bouton droit sur une session, puis cliquez sur Démarrer la session ou arrêter la session.

Exporter un modèle de session d'événements étendus

Vous pouvez exporter une session d'événements étendus à l'aide de l' Explorateur d'objets, puis l'enregistrer en tant que fichier modèle .xml. Par exemple, vous pouvez exporter une session, puis appliquer le modèle à une nouvelle session d'événements à l'aide de l' Assistant Nouvelle session ou de l'interface Nouvelle session .

Lorsque vous exportez une session, assurez-vous d'enregistrer le fichier modèle à un emplacement qui utilise le système de fichiers NTFS, et que vous limitez l'accès aux utilisateurs autorisés à afficher les informations.

Pour exporter une session d'événements étendus à l'aide de l' Explorateur d'objets:

Développez les nœuds Gestion, Événements étendus, puis Sessions .
Cliquez avec le bouton droit sur la session à exporter, puis sélectionnez Exporter une session.
Dans la boîte de dialogue Enregistrer sous , sélectionnez un emplacement pour enregistrer le fichier, tapez le nom du fichier dans la zone Nom de fichier , puis cliquez sur Enregistrer.

Si vous enregistrez le fichier à l’emplacement de modèle SQL Server Management Studio par défaut, le modèle apparaît dans la liste déroulante des modèles prédéfinis lorsque vous utilisez l’Assistant Nouvelle session et la boîte de dialogue Nouvelle session.

Importer un modèle de session d'événements étendus

À l'aide de l' Explorateur d'objets, vous pouvez importer un modèle pour une session d'événements étendus. Par exemple, vous souhaiterez peut-être créer une session à partir d’un modèle exporté à partir d’une autre instance de SQL Server.

Pour importer une session d'événements étendus, vous devez disposer des autorisations ALTER ANY EVENT SESSION nécessaires.

Avant d'importer un fichier modèle, vérifiez que le fichier provient d'une source approuvée. Les fichiers modèles doivent être enregistrés dans un emplacement qui utilise le système de fichiers NTFS et où l'accès est limité aux utilisateurs qui sont autorisés à afficher les informations.

Pour importer une session d'événements étendus :

Dans l' Explorateur d'objets, développez les nœuds Gestion, puis Événements étendus .
Cliquez avec le bouton droit sur Sessions et sélectionnez Nouvelle session.
Donnez un nom à la session.
Développez la zone déroulante Modèle .
Cliquez sur <Fichier à partir de ...>Ouvrez et recherchez la session (fichier XML) à importer.

La session apparaît sous le nœud Sessions . Par défaut, la session n'est pas démarrée.

Modifier une session d'événements étendus

Vous pouvez modifier une session d'événements étendus dans l'Explorateur d'objets.

Pour modifier une session d'événements étendus :

Dans l' Explorateur d'objets, développez les nœuds Gestion, Événements étendus, puis Sessions .
Cliquez avec le bouton droit sur une session et sélectionnez Propriétés.
Dans la section Sélectionner une page , sélectionnez la ou les pages que vous souhaitez modifier.
Après avoir modifié la session d'événements, cliquez sur OK.

Script d’une définition de session d’événements à l’aide de Transact-SQL

L’Assistant Nouvelle session et la boîte de dialogue Nouvelle session ont une option de script qui génère la session Transact-SQL qui définit la session Événements étendus.

Vous pouvez accéder à Transact-SQL pour une session d’événements étendus existante en cliquant avec le bouton droit sur le nom de la session, en sélectionnant Session de script comme, puis en sélectionnant Créer.

Supprimer une session d'événements étendus

Vous pouvez supprimer une session d'événements étendus :

Dans l'Éditeur de requête, à l'aide de DROP EVENT SESSION.
Dans l' Explorateur d'objets.

Quand vous supprimez une session d’événements, toutes les informations de configuration sont supprimées, et la définition de session ne s’affiche plus dans l’affichage catalogue sys.server_event_sessions.

Note

system_health et Always On_health sont inclus dans SQL Server ; ne les supprimez pas. system_health est activée par défaut (pour plus d’informations, consultez Utiliser la session system_health). Always On_health est désactivée par défaut. Ces sessions collectent des données qui peuvent être utiles pour le diagnostic des problèmes de performances.

Pour supprimer une session d'événements étendus, vous devez disposer de l'autorisation ALTER ANY EVENT SESSION.

Pour supprimer une session d'événements étendus dans l' Explorateur d'objets:

Développez les nœuds Gestion, Événements étendus, puis Sessions .
Cliquez avec le bouton droit sur une session et sélectionnez Supprimer.
Dans la boîte de dialogue Supprimer l'objet , cliquez sur OK.
Après avoir modifié la session d'événements, cliquez sur OK.

Pour supprimer une session d’événements étendus dans l’ Éditeur de requête, émettez les instructions suivantes en remplaçant session_name par le nom de la session d’événements étendus à supprimer :

DROP EVENT SESSION [session_name]  
ON SERVER