Cible du suivi d'événements pour Windows
Avant d'utiliser le suivi d'événements pour Windows (ETW) comme cible, il est recommandé d'avoir une connaissance pratique du Suivi d'événements pour Windows. Le suivi ETW est utilisé conjointement avec les Événements étendus ou en tant que consommateur d'événements des Événements étendus. Les liens externes suivants fournissent un point de départ pour obtenir des informations générales sur le suivi ETW :
La cible du suivi ETW est une cible singleton, bien qu'elle puisse être ajoutée à plusieurs sessions. Si un événement est déclenché sur plusieurs sessions, l'événement sera propagé uniquement à la cible ETW une fois par occurrence de l'événement. Le moteur des Événements étendus est limité à une seule instance par processus.
Important
Pour que la cible du suivi ETW fonctionne, le compte de démarrage du service SQL Server doit être membre du groupe Utilisateurs du journal de performances.
La configuration des événements présents dans une session ETW est contrôlée par le processus qui héberge le moteur des Événements étendus. Le moteur contrôle quels événements déclencher et quelles conditions doivent être respectées pour qu'un événement se déclenche.
Après avoir créé une liaison à une session Événements étendus, ce qui joint la cible ETW pour la première fois pendant la durée de vie d'un processus, la cible ETW ouvre une session ETW unique sur le fournisseur SQL Server. Si une session ETW existe déjà, la cible ETW obtient une référence à la session existante. Cette session ETW est partagée sur toutes les instances de SQL Server sur un ordinateur donné. Cette session ETW reçoit tous les événements à partir des sessions qui possèdent la cible ETW.
Comme ETW a besoin de fournisseurs pour pouvoir consommer des événements et les transmettre en aval au suivi ETW, tous les packages des Événements étendus sont activés sur la session. Lorsqu'un événement est déclenché, la cible ETW envoie l'événement à la session sur laquelle le fournisseur pour l'événement est activé.
La cible ETW prend en charge la publication synchrone d'événements sur le thread qui déclenche l'événement. Cependant, la cible ETW ne prend pas en charge la publication asynchrone d'événements.
La cible ETW ne prend pas en charge le contrôle à partir de contrôleurs ETW externes tels que Logman.exe. Pour produire des traces ETW, une session d'événements doit être créée avec la cible ETW. Pour plus d'informations, consultez CREATE EVENT SESSION (Transact-SQL).
[!REMARQUE]
L'activation de la cible ETW crée une session ETW nommée XE_DEFAULT_ETW_SESSION. Si une session XE_DEFAULT_ETW_SESSION existe déjà, elle est utilisée sans modifier la moindre propriété de la session existante. La session XE_DEFAULT_ETW_SESSION est partagée entre toutes les instances de SQL Server. Après avoir démarré XE_DEFAULT_ETW_SESSION, vous devez l'arrêter à l'aide d'un contrôleur ETW, tel que l'outil Logman. Par exemple, vous pouvez exécuter la commande suivante à l'invite de commandes : logman stop XE_DEFAULT_ETW_SESSION -ets.
Le tableau suivant décrit les options disponibles pour configurer la cible ETW.
Option |
Valeurs autorisées |
Description |
|---|---|---|
default_xe_session_name |
Toute chaîne incluant jusqu'à 256 caractères. Cette valeur est facultative. |
Nom de la session Événements étendus. Par défaut, il s'agit de la session XE_DEFAULT_ETW_SESSION. |
default_etw_session_logfile_path |
Toute chaîne incluant jusqu'à 256 caractères. Cette valeur est facultative. |
Chemin d'accès du fichier journal pour la session Événements étendus. Par défaut, il s'agit de %TEMP%\ XEEtw.etl. |
default_etw_session_logfile_size_mb |
Entier quelconque non signé. Cette valeur est facultative. |
Taille du fichier journal, en mégaoctets (Mo), de la session Événements étendus. La valeur par défaut est 20 Mo. |
default_etw_session_buffer_size_kb |
Entier quelconque non signé. Cette valeur est facultative. |
Taille des tampons en mémoire, en kilo-octets (Ko), pour la session Événements étendus. La valeur par défaut est 128 Ko. |
retries |
Entier quelconque non signé. |
Nombre de nouvelles tentatives de publication de l'événement dans le sous-système ETW avant la suppression de l'événement. La valeur par défaut est 0. |
La configuration de ces paramètres est facultative. La cible ETW utilise les valeurs par défaut de ces paramètres.
La cible ETW est chargée des opérations suivantes :
Création de la session ETW par défaut.
Enregistrement de tous les packages des Événements étendus auprès d'ETW. Cela garantit que les événements ne seront pas supprimés par ETW.
Gestion de l'envoi du flux d'événements à ETW. La cible ETW crée un événement ETW avec les données des Événements étendus et l'envoie à la session ETW appropriée. Si l'événement est plus grand que la taille de la mémoire tampon ou si les données ne peuvent pas s'ajuster dans un événement ETW, le suivi ETW fractionne l'événement en fragments.
Conservation des packages des Événements étendus activés à tout instant.
Les emplacements de fichier par défaut suivants sont utilisés par ETW :
Le fichier de sortie ETW se trouve dans %TEMP%\XEEtw.etl.
Important
Le chemin d'accès ne peut pas être modifié une fois la première session démarrée.
Les fichiers MOF (Managed Object Format) se trouvent dans le dossier <your install path>\Microsoft SQL Server\Shared. Pour plus d'informations, consultez Format d'objet managé sur MSDN.
Ajout de la cible à une session
Pour ajouter la cible ETW à une session Événements étendus lorsque vous créez ou modifiez une session d'événements, vous devez inclure l'instruction suivante :
ADD TARGET package0.etw_classic_sync_target
Pour plus d'informations et un exemple complet indiquant comment utiliser la cible ETW et notamment afficher des données, consultez Surveiller l'activité système à l’aide d’événements étendus.
Voir aussi
Référence
sys.dm_xe_session_targets (Transact-SQL)
CREATE EVENT SESSION (Transact-SQL)
ALTER EVENT SESSION (Transact-SQL)