Ejemplo 4: actualización de una sesión de seguimiento

Mientras se ejecuta una sesión de seguimiento, puede actualizar las siguientes propiedades de una sesión de seguimiento en tiempo real o registrada:

• Convierta una sesión de seguimiento en tiempo real en una sesión de registro de seguimiento (mediante -f).

• Cree un nuevo registro de seguimiento para una sesión de registro de seguimiento existente (mediante -f).

• Agregue la entrega de mensajes de seguimiento en tiempo real a una sesión de registro de seguimiento existente (mediante -rt).

• Cambie el número máximo de búferes (mediante -max), pero no el número mínimo de búferes.

• Cambie el intervalo de tiempo de vaciado (mediante -ft).

• Vaciar los búferes de seguimiento (mediante -tracelog -flush).

No puede usar un comando tracelog -update para cambiar las marcas y el nivel de un proveedor de seguimiento. En su lugar, use el comando tracelog -enable , como se muestra en El ejemplo 5: Habilitar proveedores de seguimiento.

Los parámetros -rt y -f funcionan de forma diferente en un comando tracelog -update . El parámetro -rt agrega la entrega de mensajes en tiempo real a una sesión de registro de seguimiento. Como resultado, los nuevos mensajes de seguimiento se envían directamente al consumidor de seguimiento y al registro de seguimiento. Sin embargo, para poder agregar la entrega de mensajes en tiempo real a una sesión de registro de seguimiento, los búferes deben vaciarse mediante el comando tracelog -flush . Cuando se usa el parámetro -f para actualizar una sesión de seguimiento en tiempo real, reemplaza la entrega de mensajes en tiempo real por la entrega al registro de seguimiento. Como resultado, los nuevos mensajes de seguimiento solo se envían al registro de seguimiento; ya no se envían directamente al consumidor de seguimiento.

El comando siguiente cambia una sesión de seguimiento en tiempo real denominada "MyTrace" a una sesión de registro de seguimiento. El comando usa el parámetro -f para especificar la ubicación del archivo de registro, C:\tracing\MyTrace.etl. También usa el parámetro -max con un valor de 35 para aumentar el número máximo de búferes a 35.

tracelog -update MyTrace -f c:\tracing\mytrace.etl -max 35

En respuesta, Tracelog muestra las propiedades de la sesión de seguimiento, incluidas las propiedades que se acaban de cambiar.

Como resultado de este comando, todos los nuevos mensajes de seguimiento generados por el proveedor y los mensajes de seguimiento almacenados en el búfer cuando se envió el comando, solo se escriben en el archivo de registro. Ya no se envían directamente al consumidor de seguimiento, como en una sesión de seguimiento en tiempo real.

Para agregar un registro de seguimiento a una sesión de seguimiento en tiempo real, de modo que los mensajes de seguimiento se envíen al consumidor de seguimiento y al registro de seguimiento, incluyan los parámetros -rt y -f , como se muestra en el siguiente comando.

tracelog -update MyTrace -rt -f c:\tracing\mytrace.etl -max 35

También puede vaciar los búferes de seguimiento mientras se ejecuta una sesión. Se trata de un vaciado forzado que no está coordinado con el temporizador de vaciado. El sistema volverá a vaciar los búferes cuando expire el temporizador de vaciado y cuando se detenga la sesión de seguimiento.

Para vaciar los búferes de una sesión de seguimiento existente, use el parámetro -flush , como se muestra en el ejemplo siguiente. El parámetro -flush no es un subparámetro del comando tracelog -update .

tracelog -flush MyTrace

En respuesta, Tracelog muestra las propiedades revisadas de la sesión de seguimiento.