Événements étendus

fonctionnel

Listez les sessions Extended Events avec leur état d'exécution et le détail de chaque session ; le démarrage et l'arrêt passent d'abord par des scripts.

Deux grilles côte à côte : la gauche liste les sessions avec leur état de démarrage et si chacune est actuellement en cours ; sélectionnez-en une et Afficher les événements et cibles remplit la grille de droite avec les événements et cibles de cette session. Démarrer et arrêter une session est orienté script: Script de démarrage et Script d'arrêt ouvrent l'instruction exacte ALTER EVENT SESSION … STATE = START|STOP dans un onglet pour examen plutôt que de l'exécuter depuis la boîte de dialogue - le pied de page le précise.

Conscient de la portée. Ouverte depuis une base de données, elle liste les sessions propres à cette base de données (sys.database_event_sessions). Ouvert depuis la palette de commandes, il liste les sessions de l'instance au niveau du serveur ; sur Azure SQL Database, qui n'a que des sessions au niveau de la base de données, il s'y rabat automatiquement.
SQLly
Volet SQLly Extended Events
Événements étendus : la liste des sessions avec état d'exécution, le détail des événements/cibles par session, et le démarrage/arrêt avec script d'abord.

Ouverture

  • Pour une base de données : faites un clic droit sur la base de données dans l'explorateur et choisissez Outils › Événements étendus.... SQLly rend d'abord cette base de données active. Le titre de la boîte de dialogue se termine par (portée de la base de données).
  • Pour l'ensemble de l'instance : exécuter Événements étendus... depuis la palette de commandes. Le titre se termine par (portée du serveur). Si le catalogue à l'échelle du serveur ne peut pas être lu, comme sur Azure SQL Database - le volet réessaie à l'échelle de la base de données et le titre l'indique.

Vérifier une session et l'arrêter

Supposons qu'un collègue ait laissé une session de traçage en cours et que vous vouliez confirmer ce qu'elle capture avant de l'arrêter :

  1. Ouvrez Événements étendus. La grille de gauche liste chaque session par nom avec startup_state (qu'il commence par le serveur) et is_running (1 quand il est actif en ce moment).
  2. Sélectionnez la ligne de la session et appuyez sur Afficher les événements et cibles. La grille de droite, intitulée Événements et cibles - <session>, liste event_name et target_name des paires, telles que sql_batch_completed écrites sur une event_file cible.
  3. Appuyez sur Script d'arrêt. La boîte de dialogue se ferme et un onglet de requête s'ouvre avec l'instruction, que vous examinez et exécutez vous-même :
ALTER EVENT SESSION [long_running_queries] ON SERVER STATE = STOP;

Depuis une base de données, l'instruction indique ON DATABASE à la place. Script de démarrage produit la même instruction avec STATE = START. Les noms de session sont cités entre crochets, tout ] doublé, donc les noms inhabituels sont sûrs.

Boutons

BoutonCe que cela fait
ActualiserRelit la liste des sessions et efface la grille de détails.
Afficher les événements et ciblesCharge les événements et cibles de la session sélectionnée dans la grille de droite.
Script de démarrage / Script d'arrêtOuvre le ALTER EVENT SESSION instruction pour la session sélectionnée dans un nouvel onglet de requête. Rien ne s'exécute depuis la boîte de dialogue.

Sans ligne sélectionnée, les actions vous indiquent de sélectionner d'abord une session plutôt que de deviner.

Autorisations et limites

  • La lecture des métadonnées des événements étendus nécessite VIEW SERVER STATE, ou VIEW DATABASE STATE sur Azure SQL. Si la liste ne peut pas être lue, le panneau affiche l'erreur du serveur avec ce rappel.
  • Le volet liste les sessions et leur configuration ; il ne crée pas de sessions ni ne lit les données d'événements capturées. Écrivez CREATE EVENT SESSION dans un onglet de requête, et lisez les cibles avec les fonctions habituelles telles que sys.fn_xe_file_target_read_file.

Pour la famille SQL Server, Extended Events est une fonctionnalité de SQL Server. Sur les autres moteurs, l'élément de menu l'indique ; sur ClickHouse, il vous renvoie vers system.query_log et system.trace_log, qui Query Insights lit déjà.