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

Artículo
05/27/2012

[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].

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

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

Atributos y elementos

En las próximas secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo	Descripción
enabled	Atributo Boolean opcional. Especifica si la traza está habilitada o no para una aplicación. Para poder utilizar el visor Trace.axd, la traza debe estar habilitada. 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 traza (Trace.axd) sólo está disponible en el servidor Web del host. Si es false, el visor de traza está disponible en cualquier equipo. De forma predeterminada, el visor Trace.axd se agrega al elemento httpHandlers. De manera predeterminada, es true.
mostRecent	Atributo Boolean opcional. Especifica si se muestran los resultados de traza de aplicación más recientes y se descartan los datos de traza más antiguos que superen los límites indicados por requestLimit. Si es false, se muestran los datos de traza de las solicitudes hasta alcanzar el valor del atributo requestLimit. Este atributo es nuevo en la versión 2.0 de .NET Framework. El valor predeterminado es false.
pageOutput	Atributo Boolean opcional. Especifica si se debe representar el resultado del traza al final de cada página. Si es false, el acceso al resultado de la traza sólo es posible a través de la herramienta de traza. El valor predeterminado es false.
requestLimit	Atributo Int32 opcional. Especifica el número de solicitudes de traza que deben almacenarse en el servidor. Si se alcanza el límite y el atributo mostRecent es false, se deshabilita la traza automáticamente. El límite máximo de solicitudes es de 10.000. Si se especifica un valor mayor de 10.000, ASP.NET lo redondea a 10.000 sin ninguna notificación. El valor predeterminado es 10.
traceMode	Atributo TraceDisplayMode opcional. Especifica el orden en el que se mostrará la información de traza. El atributo traceMode puede ser uno de los siguientes valores posibles: ValorDescripción SortByCategory Especifica que la información de traza debe mostrarse ordenada alfabéticamente por las categorías definidas por el usuario. SortByTime Especifica que la información de traza se muestra en el orden en que se procesa. El valor predeterminado es SortByTime.
writeToDiagnosticsTrace	Atributo Boolean opcional. Especifica si los mensajes de traza 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. Este atributo es nuevo en la versión 2.0 de .NET Framework. El valor predeterminado es false.

Elementos secundarios

Ninguno.

Elementos primarios

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

Comentarios

Una vez habilitada la traza, cada solicitud de página genera mensajes de traza que pueden agregarse al resultado de la página o almacenarse en un registro de traza de la aplicación. Puede ver el contenido de dicho registro con el visor de seguimiento de ASP.NET (Trace.axd). De forma predeterminada, Trace.axd se agrega al elemento httpHandlers.

Nota

Por lo general no se recomienda habilitar la traza 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.La traza está pensada únicamente para la depuración.Si el atributo localOnly es true, la información de traza sólo se muestra para las solicitudes localhost.Además, si se establece <deployment retail=true> en el archivo Web.config, se deshabilita la traza.

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. La traza ayuda a aislar los problemas y corregirlos sin interrumpir un sistema en ejecución.

Para que la traza surta efecto, necesita volver a compilar su aplicación con el marcador de traza 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 la traza. 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 la que devuelve la aplicación en .NET Framework 2.0 y versiones posteriores.

<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 trace 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 de la traza.

<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 directorio virtual o físico
Requisitos	Microsoft Internet Information Services (IIS) 5.0 o una versión posterior El entorno .NET Framework Microsoft Visual Studio

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

Referencia

Conceptos

Otros recursos

Recursos adicionales