Options des paramètres de session de journal

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

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 suivi. 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 du journal .

Drapeaux
Spécifie les indicateurs de trace pour le fournisseur de trace. Les indicateurs de trace déterminent les messages de trace 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 suivi (.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 du journal .

Temps de vidage (S)
Spécifie la fréquence à laquelle (en secondes) les mémoires tampons de session de suivi sont vidées dans un journal de trace ou dans 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 vidages forcés.

Pour vider plus d’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 Heure de vidage 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 suivi.

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, davantage de mémoires tampons sont allouées jusqu’à ce que le nombre de mémoires tampons atteigne la valeur spécifiée dans l’option Maximum Buffers . 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 utilisé. 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 suivi. 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 utilisé. Vous ne pouvez pas modifier cette valeur pendant l’exécution de la session de trace.

Temps de désintégration (minutes)
Spécifie la durée pendant laquelle les tampons de trace inutilisés (en minutes) sont conservés avant d’être libérés. La valeur par défaut est 15. La valeur de cette option s’affiche dans la colonne Âge de la liste des sessions de suivi.

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, de 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 tampons de suivi sont séquentiels 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 tampons de trace sont séquentiels 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 tampons de trace sont séquentiels, et non circulaires, et sont chacun de 200 Mo.

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

Démarrer le nouveau fichier après la taille de la mémoire tampon (Mo)
Crée un fichier journal de suivi (.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 des sessions de suivi.

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 Log Trace Event Data to File dans la page Options de session de journal . Cette option n’a aucun effet sur les mémoires tampons circulaires ou sur les journaux d’une session de trace NT Kernel Logger. Il n’est pas pris 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 d’une session de suivi de l’enregistreur d’événements 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 au sein d’une session de suivi.

Cette option n’est pas prise en charge sur Windows 2000 et n’a aucun effet sur les journaux d’une session de suivi de l’enregistreur d’événements du noyau NT.

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 suivi (.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 du journal .

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

Windbg
Redirige les messages de suivi vers KD ou WinDbg, selon la valeur activée, 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 outils de débogage pour Windows En outre, pour permettre au débogueur de rechercher les fichiers de format de message de trace (.tmf) pour les messages de suivi, 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 suivi WinDbg et WMI, consultez Outils de débogage pour Windows.

Ignorer TraceView
Supprime les messages de suivi qui résultent 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 pour faire de la place pour les 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. Des valeurs plus grandes peuvent entraîner des retards importants.

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