Elemento trace (Esquema de configuración de ASP.NET)

Artículo
10/07/2008

Actualización: noviembre 2007

Configura el servicio de seguimiento de código de ASP.NET que controla cómo se recopilan, se almacenan y se muestran los resultados de seguimiento.

Elemento configuration (Esquema de configuración general)
Elemento system.web (Esquema de configuración de ASP.NET)
Elemento trace (Esquema de configuración de ASP.NET)

<trace 
   enabled="true|false"
   localOnly="true|false"
   pageOutput="true|false"
   requestLimit="integer" 
   mostRecent="true|false"
   writeToDiagnosticsTrace="true|false"
   traceMode="SortByTime|SortByCategory"
/>

Atributos y elementos

Las siguientes secciones describen atributos, elementos secundarios y elementos primarios.

Atributos

Atributo	Descripción
enabled	Atributo Boolean opcional. Especifica si el seguimiento está habilitado o no para una aplicación. Para poder utilizar el visor Trace.axd, el seguimiento debe estar habilitado. De forma predeterminada, el visor Trace.axd se agrega al elemento httpHandlers. El valor predeterminado es false.
localOnly	Atributo Boolean opcional. Especifica si el visor de seguimiento (Trace.axd) sólo está disponible en el servidor Web del host. Si es false, el visor de seguimiento está disponible en cualquier equipo. De forma predeterminada, el visor Trace.axd se agrega al elemento httpHandlers. El valor predeterminado es true.
mostRecent	Atributo Boolean opcional. Especifica si se muestran los resultados de seguimiento de aplicación más recientes y se descartan los datos de seguimiento más antiguos que superen los límites indicados por requestLimit. Si es false, se muestran los datos de seguimiento de las solicitudes hasta alcanzar el valor del atributo requestLimit. Se trata de un atributo nuevo en .NET Framework, versión 2.0. El valor predeterminado es false.
pageOutput	Atributo Boolean opcional. Especifica si se debe representar el resultado del seguimiento al final de cada página. Si es false, el acceso al resultado del seguimiento sólo es posible a través de la herramienta de seguimiento. El valor predeterminado es false.
requestLimit	Atributo Int32 opcional. Especifica el número de solicitudes de seguimiento que deben almacenarse en el servidor. Si se alcanza el límite y el atributo mostRecent es false, se deshabilita el seguimiento automáticamente. El límite máximo de la solicitud es 10.000. Si se especifica un valor superior, ASP.NET lo redondeará automáticamente a la baja hasta 10.000. El valor predeterminado es 10.
traceMode	Atributo TraceDisplayMode opcional. Especifica el orden en el que se mostrará la información de seguimiento. El atributo traceMode puede ser uno de los siguientes valores posibles: Valor Descripción SortByCategory Especifica que la información de seguimiento debe mostrarse ordenada alfabéticamente por las categorías definidas por el usuario. SortByTime Especifica que la información de seguimiento se muestra en el orden en que se procesa. El valor predeterminado es SortByTime.
writeToDiagnosticsTrace	Atributo Boolean opcional. Especifica si los mensajes de seguimiento de ASP.NET se han de reenviar a la infraestructura de seguimiento de System.Diagnostics para que los agentes de escucha registrados muestren los mensajes de Trace. Para obtener más información, vea el elemento trace de system.diagnostics. Se trata de un atributo nuevo en .NET Framework, versión 2.0. El valor predeterminado es false.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento	Descripción
configuration	Es el elemento raíz necesario de cada archivo de configuración que utilizan las aplicaciones basadas en Common Language Runtime y .NET Framework.
system.web	Especifica el elemento raíz de los valores de configuración de ASP.NET de un archivo de configuración y contiene elementos de configuración que configuran las aplicaciones Web ASP.NET y controlan el comportamiento de las aplicaciones.

Comentarios

El elemento trace configura el servicio de seguimiento de código de ASP.NET que controla cómo se recopilan, se almacenan y se muestran los resultados de seguimiento.

Cuando el seguimiento está habilitado, cada solicitud de página genera mensajes de seguimiento que se pueden anexar a los resultados de la página o se pueden almacenar en un registro de seguimiento de aplicación. Puede utilizar el visor de seguimiento de ASP.NET (Trace.axd) para ver el contenido del registro de seguimiento. De forma predeterminada, Trace.axd se agrega al elemento httpHandlers.

Nota

Por lo general no se recomienda habilitar el seguimiento en un sitio Web activo, ya que se puede revelar información de configuración confidencial a cualquiera que vea las páginas del sitio Web. El seguimiento está pensado únicamente para la depuración. Si el atributo localOnly es true, la información de seguimiento sólo se muestra para las solicitudes localhost. Además, si se establece <deployment retail=true> en el archivo Web.config, se deshabilita el seguimiento.

Puede utilizar las propiedades y los métodos de la clase Trace para instrumentar las versiones de lanzamiento. La instrumentación permite supervisar el estado de una aplicación ejecutándola con la configuración real. El seguimiento ayuda a aislar los problemas y corregirlos sin interrumpir un sistema en ejecución.

Para que el seguimiento surta efecto, necesita volver a compilar su aplicación con el marcador de seguimiento establecido. Para ello, establezca el atributo compilerOptions en ="/d:TRACE" en la línea de configuración del compilador de lenguaje que desea que admita el seguimiento. Vea Elemento <compiler>.

Configuración predeterminada

El siguiente elemento trace predeterminado no se configura explícitamente en el archivo Machine.config o en el archivo Web.config raíz. Sin embargo, es la configuración predeterminada que la aplicación devuelve en .NET Framework 2.0.

<trace 
   enabled="false" 
   localOnly="true" 
   mostRecent="false" 
   pageOutput="false" 
   requestLimit="10" 
   traceMode="SortByTime" 
   writeToDiagnosticsTrace="false" 
/>

En la versión 1.0 y 1.1 de .NET Framework, el siguiente elemento element predeterminado se configura en el archivo Machine.config.

<trace
   enabled="false"
   localOnly="true"
   pageOutput="false"
   requestLimit="10"
   traceMode="SortByTime"
/>

Ejemplo

En el ejemplo de código siguiente se muestra cómo especificar las opciones de configuración del seguimiento.

<configuration>
  <system.web>
    <trace enabled="true" 
      pageOutput="true"
      requestLimit="15"
      mostRecent="true" />
    <system.web>
</configuration>

Información de elemento

Controlador de la sección de configuración	TraceSection
Miembro de configuración	TraceSection
Ubicaciones configurables	Machine.config Web.config del nivel raíz Web.config del nivel de aplicaciones Web.config del nivel de directorios virtuales o físicos
Requisitos	Microsoft Internet Information Services (IIS) 5.0, 5.1 ó 6.0 .NET Framework 1.0, 1.1 ó 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Elemento trace (Esquema de configuración de ASP.NET)

Atributos y elementos

Atributos

Elementos secundarios

Elementos primarios

Comentarios

Configuración predeterminada

Ejemplo

Información de elemento

Vea también

Tareas

Conceptos

Referencia

Otros recursos

Recursos adicionales