Options des paramètres de session de journal

Sous l’onglet Options des paramètres de session de journal , vous pouvez spécifier les valeurs des fonctionnalités de variable d’une session de trace.

Vous pouvez définir et modifier les valeurs des options suivantes lors de la création d’une session de trace. Plusieurs options peuvent être modifiées pendant l’exécution d’une session de trace. Les options que vous ne pouvez pas modifier apparaissent grisées (« grisées ») dans la boîte de dialogue Options des paramètres de session de journal .

Drapeaux
Spécifie les indicateurs de trace pour le fournisseur de trace. Les indicateurs de trace déterminent les messages de suivi générés par le fournisseur. La signification des indicateurs est déterminée indépendamment par chaque fournisseur.

Si TraceView peut trouver un fichier de contrôle de message de trace (.tmc) pour le fournisseur, vous pouvez sélectionner des indicateurs et un niveau dans une liste affichée dans la boîte de dialogue Indicateurs de suivi et sélection de niveau . Pour ouvrir la boîte de dialogue Indicateurs de suivi et sélection de niveau , cliquez sur la valeur SET de l’option Indicateurs ou Niveau dans la boîte de dialogue Options des paramètres de session de journal .

Durée de vidage (S)
Spécifie la fréquence (en secondes) à laquelle les mémoires tampons de la session de trace sont vidées dans un journal de suivi ou sur l'affichage TraceView. La valeur par défaut est 1 (seconde).

Ces vidages forcés se produisent en plus des vidages qui se produisent automatiquement lorsqu’une mémoire tampon est pleine. La valeur 0 signifie qu’il n’y a pas de vidage forcé.

Pour vider plus fréquemment qu’une fois par seconde, utilisez l’option Taille de la mémoire tampon pour réduire la taille de chaque mémoire tampon.

Vous pouvez modifier la valeur Flush Time pendant l’exécution de la session de trace.

Mémoires tampons maximales
Spécifie le nombre maximal de mémoires tampons allouées pour la session de trace.

La valeur par défaut est déterminée par le nombre de processeurs, la quantité de mémoire physique et le système d’exploitation que vous utilisez. Vous pouvez modifier cette valeur pendant l’exécution de la session de trace.

Mémoires tampons minimales
Spécifie le nombre de mémoires tampons initialement allouées pour le stockage des messages de trace.

Lorsque les mémoires tampons sont pleines, d’autres mémoires tampons sont allouées jusqu’à ce que le nombre de mémoires tampons atteigne la valeur spécifiée dans l’option Mémoires tampons maximales . La valeur par défaut est déterminée par le nombre de processeurs, la quantité de mémoire physique et le système d’exploitation en cours d’utilisation. Vous ne pouvez pas modifier cette valeur pendant l’exécution de la session de trace.

Taille de la mémoire tampon
Spécifie la taille, en kilo-octets (Ko), de chaque mémoire tampon allouée pour la session de trace. La valeur par défaut est déterminée par le nombre de processeurs, la quantité de mémoire physique et le système d’exploitation en cours d’utilisation. Vous ne pouvez pas modifier cette valeur pendant l’exécution de la session de trace.

Temps de décomposition (minutes)
Spécifie la durée (en minutes) des mémoires tampons de trace inutilisées conservées avant qu’elles ne soient libérées. La valeur par défaut est 15. La valeur de cette option est affichée dans la colonne Âge de la liste de sessions de trace.

Ce paramètre est valide uniquement sur Windows 2000. Vous ne pouvez pas modifier cette valeur pendant l’exécution de la session de trace.

Taille de mémoire tampon circulaire (Mo)
Spécifie que les mémoires tampons de trace sont circulaires et spécifie la taille maximale (en Mo) de chaque mémoire tampon.

Lorsqu’une mémoire tampon circulaire est pleine, les nouveaux messages de trace sont écrits au début de la mémoire tampon, en remplaçant les messages de trace les plus anciens. Par défaut, les mémoires tampons de trace sont séquentielles, et non circulaires.

Vous ne pouvez pas modifier cette valeur pendant l’exécution de la session de trace.

Taille de mémoire tampon séquentielle (Mo)
Spécifie si les mémoires tampons de trace sont séquentielles et spécifie la taille maximale (en Mo) de chaque mémoire tampon.

Lorsqu’une mémoire tampon séquentielle est pleine, les messages de trace sont écrits dans une autre mémoire tampon ou sont perdus. Par défaut, les mémoires tampons de trace sont séquentielles, pas circulaires et sont chacune de 200 Mo.

Vous ne pouvez pas modifier cette valeur pendant l’exécution de la session de trace.

Démarrer un nouveau fichier après la taille de la mémoire tampon (Mo)
Crée un fichier journal de trace (.etl) chaque fois que le journal existant atteint la valeur spécifiée. La valeur spécifie la taille maximale de chaque fichier journal en Mo.

La valeur de cette option s’affiche dans la colonne Nouveau fichier de la liste de sessions de trace.

Cette option n’est effective que lorsque le fournisseur génère des journaux de suivi, c’est-à-dire lorsque vous avez sélectionné l’option Données d’événement de suivi du journal sur fichier dans la page Options de session du journal . Cette option n’a aucun effet sur les mémoires tampons circulaires ou sur les journaux d’activité d’une session de trace de l’enregistreur d’événements du noyau NT. Elle n’est pas prise en charge sur Windows 2000.

Utiliser des numéros de séquence globaux
Génère un numéro de séquence global pour chaque message de trace.

Les numéros de séquence globaux sont uniques pour toutes les sessions de suivi sur l’ordinateur. La valeur par défaut de cette option est FALSE.

Cette option n’est pas prise en charge sur Windows 2000 et n’a aucun effet sur les journaux générés par une session de trace du Logger du noyau NT.

Utiliser le numéro de séquence local
Génère un numéro de séquence local pour chaque message de trace. La valeur par défaut est TRUE.

Les numéros de séquence locaux sont uniques dans une session de trace.

Cette option n’est pas prise en charge sur Windows 2000 et n’a aucun effet sur les journaux d’une session de trace NT Kernel Logger.

Niveau
Spécifie un niveau de trace pour le fournisseur de trace. Le niveau de trace détermine les messages de suivi générés par le fournisseur. La signification de la valeur de niveau est déterminée indépendamment par chaque fournisseur. En règle générale, il représente des niveaux de détail croissants.

Si TraceView peut trouver un fichier de contrôle de message de trace (.tmc) pour le fournisseur, vous pouvez sélectionner des indicateurs et un niveau dans une liste affichée dans la boîte de dialogue Indicateurs de suivi et sélection de niveau . Pour ouvrir la boîte de dialogue Indicateurs de suivi et sélection de niveau , cliquez sur la valeur SET de l’option Indicateurs ou Niveau dans la boîte de dialogue Options des paramètres de session de journal .

Pour plus d’informations sur les niveaux de trace, consultez la description du paramètre EnableLevel de la fonction EnableTrace dans le Kit de développement logiciel (SDK) Microsoft Windows.

WinDbg
Redirige les messages de suivi vers KD ou WinDbg, selon ce qui est activé, en plus de les afficher dans la fenêtre TraceView. Cette option définit également la taille de la mémoire tampon sur 3 Ko, la taille maximale autorisée par WinDbg. La valeur affichée pour l’option Taille de la mémoire tampon est ignorée.

Pour afficher les messages de trace dans un débogueur, wmitrace.dll et traceprt.dll doivent se trouver dans le chemin de recherche du débogueur sur l’ordinateur hôte. Ces DLL sont incluses dans les outils de débogage pour Windows également, pour permettre au débogueur de rechercher les fichiers de format de message de trace (.tmf) pour les messages de trace, les fichiers TMF doivent se trouver dans le chemin de recherche du débogueur sur l’ordinateur hôte. Pour définir le chemin de recherche du débogueur, utilisez l’extension de débogueur spécialisé !wmitrace.searchpath ou définissez la valeur de la variable d’environnement %TRACE_FORMAT_SEARCH_PATH%. Pour plus d'informations sur les extensions de traçage WinDbg et WMI, consultez les Outils de Débogage pour Windows.

Ignorer TraceView
Supprime les messages de suivi résultant des opérations TraceView.

Taille de fichier virtuel
Indique le nombre maximal de messages de trace que TraceView stocke avant de commencer à remplacer les messages les plus anciens afin de rendre place aux messages plus récents.

La valeur 0 signifie qu’il n’y a pas de valeur maximale. TraceView conserve tous les messages et ne les remplace jamais. La valeur par défaut de cette option, 65536, est la valeur recommandée pour la plupart des systèmes. Les valeurs plus importantes peuvent entraîner des retards importants.

Cette valeur apparaît dans la colonne Nombre maximal d’enregistrements de trace de la liste des sessions de trace.