Exemple 4 : Mise à jour d’une session de trace
Pendant qu’une session de trace est en cours d’exécution, vous pouvez mettre à jour les propriétés suivantes d’une session de trace en temps réel ou journalisée :
Convertissez une session de trace en temps réel en session de journal de suivi (à l’aide de -f).
Créez un journal de suivi pour une session de journal de suivi existante (à l’aide de -f).
Ajoutez la remise des messages de suivi en temps réel à une session de journal de suivi existante (à l’aide de -rt).
Modifiez le nombre maximal de mémoires tampons (à l’aide de -max), mais pas le nombre minimal de mémoires tampons.
Modifiez l’intervalle de temps de vidage (à l’aide de -ft).
Videz les mémoires tampons de trace (à l’aide de -tracelog -flush).
Vous ne pouvez pas utiliser une commande tracelog -update pour modifier les indicateurs et le niveau d’un fournisseur de trace. Utilisez plutôt la commande tracelog -enable, comme illustré dans l’exemple 5 : Activation des fournisseurs de trace.
Les paramètres -rt et -f fonctionnent différemment dans une commande tracelog -update . Le paramètre -rt ajoute la remise de messages en temps réel à une session de journal de trace. Par conséquent, les nouveaux messages de suivi sont envoyés directement au consommateur de trace et au journal de suivi. Toutefois, avant de pouvoir ajouter une remise de messages en temps réel à une session de journal de suivi, les mémoires tampons doivent être vidées à l’aide de la commande tracelog -flush . Lorsque le paramètre -f est utilisé pour mettre à jour une session de trace en temps réel, il remplace la remise de messages en temps réel par remise au journal de suivi. Par conséquent, les nouveaux messages de suivi sont envoyés uniquement au journal de suivi ; ils ne sont plus envoyés directement au consommateur de trace.
La commande suivante modifie une session de trace en temps réel nommée « MyTrace » en une session de journal de suivi. La commande utilise le paramètre -f pour spécifier l’emplacement du fichier journal, C :\tracing\MyTrace.etl. Il utilise également le paramètre -max avec une valeur de 35 pour augmenter le nombre maximal de mémoires tampons à 35.
tracelog -update MyTrace -f c:\tracing\mytrace.etl -max 35
En réponse, Tracelog affiche les propriétés de la session de trace, y compris les propriétés qui viennent d’être modifiées.
À la suite de cette commande, tous les nouveaux messages de trace générés par le fournisseur et tous les messages de trace stockés dans la mémoire tampon lorsque la commande a été envoyée, sont écrits uniquement dans le fichier journal. Ils ne sont plus envoyés directement au consommateur de trace, comme dans une session de trace en temps réel.
Pour ajouter un journal de suivi à une session de trace en temps réel, afin que les messages de suivi soient envoyés au consommateur de trace et au journal de suivi, incluez les paramètres -rt et -f , comme indiqué dans la commande suivante.
tracelog -update MyTrace -rt -f c:\tracing\mytrace.etl -max 35
Vous pouvez également vider les mémoires tampons de trace pendant qu’une session est en cours d’exécution. Il s’agit d’un vidage forcé qui n’est pas coordonné avec le minuteur de vidage. Le système vide à nouveau les mémoires tampons lorsque le minuteur de vidage expire et lorsque la session de trace s’arrête.
Pour vider les mémoires tampons d’une session de trace existante, utilisez le paramètre -flush , comme illustré dans l’exemple suivant. Le paramètre -flush n’est pas un sous-paramètre de la commande tracelog -update .
tracelog -flush MyTrace
En réponse, Tracelog affiche les propriétés révisées de la session de trace.