Habilitar el seguimiento de nivel de aplicación
El seguimiento puede habilitarse para una aplicación completa en el archivo Web.config del directorio raíz de la aplicación. De forma predeterminada, el seguimiento de nivel de aplicación se puede ver sólo en el equipo local del servidor Web. Para que la información de seguimiento de nivel de aplicación se pueda ver en equipos remotos, establezca el valor del atributo localOnly del archivo Web.config en false.
PRECAUCIÓN Para proteger la aplicación Web, utilice la capacidad de seguimiento remoto únicamente cuando programe o instale la aplicación. Asegúrese de que deshabilita esta capacidad antes de transferir la aplicación a servidores Web de producción. Para deshabilitar el seguimiento remoto, establezca el valor del atributo localOnly del archivo Web.config en true.
En el ejemplo siguiente se muestra una configuración de seguimiento de aplicación que recopila información de hasta 40 solicitudes y permite que los exploradores de equipos distintos del servidor de origen muestren el visor de seguimiento.
<configuration>
<system.web>
<trace enabled="true" requestLimit="40" localOnly="false"/>
</system.web>
</configuration>
Cuando se habilita el seguimiento para una aplicación, ASP.NET recopila la información de seguimiento de cada solicitud realizada a la aplicación, hasta llegar al número máximo de solicitudes especificado. El número de solicitudes predeterminado es 10.Cuando el visor de seguimiento alcanza este límite, la aplicación deja de almacenar solicitudes de seguimiento.
Nota Cuando se habilita el seguimiento para toda la aplicación en el archivo Web.config, la información se recopila y procesa para cada página de la aplicación. Para deshabilitar el seguimiento de una página determinada, establezca false en el atributo Trace de la directiva @ Page de esa página. Las instrucciones TraceContext.Write o TraceContext.Warn que incluya en el código de una página se almacenan y se envían únicamente al visor de seguimiento.
Si desea que la información de seguimiento aparezca al final de la página a la que está asociada, establezca en true el atributo pageOutput de la sección de configuración de seguimiento del archivo Web.config. Si desea que la información sólo aparezca en el visor de seguimiento, establezca false en este atributo. Si habilita el seguimiento de nivel de aplicación, pero no desea que se muestre la información de algunas de sus páginas, utilice la directiva @ Page para establecer false en el atributo Trace de esas páginas.
Para obtener más información acerca de la configuración de una aplicación ASP.NET, vea Configuración de ASP.NET.
La siguiente es una lista de todos los atributos que pueden utilizarse para modificar el comportamiento del seguimiento de nivel de aplicación.
| Atributo | Descripción |
|---|---|
| enabled | true si el seguimiento está habilitado para la aplicación; en caso contrario, es false. El valor predeterminado es false. |
| pageOutput | true si la información de seguimiento se muestra en las páginas de la aplicación y en la herramienta de seguimiento .axd; en caso contrario, es false. El valor predeterminado es false.
Nota Las páginas con el seguimiento habilitado no se ven afectadas por esta opción. |
| requestLimit | Número de solicitudes de seguimiento que se almacenan en el servidor. El valor predeterminado es 10. |
| traceMode | Indica si la información de seguimiento se muestra en el orden en que se procesó (SortByTime) o en orden alfabético de las categorías definidas por el usuario (SortByCategory). El valor predeterminado es SortByTime. |
| localOnly | true si el visor de seguimiento (Trace.axd) sólo está disponible en el servidor Web del host; en caso contrario, es false. El valor predeterminado es true. |
Para habilitar el seguimiento para una aplicación
Si aún no lo ha hecho, cree un archivo de texto, asígnele el nombre Web.config y guárdelo en el directorio raíz de la aplicación.
Entre las etiquetas de apertura y cierre del elemento
<configuration>,agregue las etiquetas de apertura y cierre de un elemento<system.web>.Entre las etiquetas del elemento
<system.web>, agregue un elemento<trace>, que no requiere etiqueta de cierre.En el elemento
<trace>, declare el atributo enabled y establézcalo en true.Declare los atributos opcionales que desee para modificar el comportamiento de seguimiento de la aplicación.
Por ejemplo, la configuración de seguimiento de aplicación siguiente recopila información de hasta 40 solicitudes y permite que los exploradores de equipos distintos del servidor de origen muestren el visor de seguimiento.
<configuration> <system.web> <trace enabled="true" requestLimit="40" localOnly="false"/> </system.web> </configuration>Nota En el sistema de configuración de ASP.NET se distingue entre mayúsculas y minúsculas. Los nombres de todas las secciones de configuración que sólo contengan una palabra se escriben en minúsculas, mientras que en los nombres de secciones y atributos formados por concatenaciones de dos palabras, la primera letra de cada palabra concatenada es mayúscula. Por ejemplo,
requestLimites un nombre válido, perorequestlimitprovoca un error del analizador.
Ver información de seguimiento con el visor de seguimiento
Una vez habilitado el seguimiento para una aplicación, cada vez que se solicite una página de la aplicación se ejecutarán las instrucciones de seguimiento que contenga. Para ver estas instrucciones y la información de seguimiento adicional en el visor de seguimiento, solicite Trace.axd en la raíz del directorio de aplicación.
Nota Cuando se habilita el seguimiento para una aplicación, es posible ver las instrucciones de seguimiento y la información adicional en cualquier página de la aplicación con sólo establecer el valor true en el atributo pageOutput en el archivo Web.config.
El visor de seguimiento permite elegir una solicitud específica entre las páginas solicitadas a la aplicación. En la captura de pantalla siguiente se muestra un visor de seguimiento con las siete solicitudes enviadas a la aplicación desde que se habilitó el seguimiento.
Visor de seguimiento
.gif)
Si se reciben múltiples solicitudes para una aplicación que tiene habilitado el seguimiento, en el visor de seguimiento aparecen las solicitudes en el orden en que se procesaron. La información de la página inicial del visor de seguimiento incluye la hora de la solicitud, el archivo solicitado, el código de estado, el verbo HTTP asociado y un vínculo Ver detalles que permite ver información más detallada acerca de la solicitud. El número de solicitudes mostradas no excederá el límite requestLimit especificado en el archivo Web.config.
Para ver los detalles de seguimiento de una solicitud específica
Desplácese al visor de seguimiento asociado con la aplicación.
Por ejemplo, si la dirección URL de la aplicación es https://localhost/myapplication, vaya a https://localhost/myapplication/trace.axd
Seleccione el vínculo Ver detalles de la solicitud que desee investigar.
Una vez seleccionado Ver detalles, verá la misma información que se agregó a la página que tenía el seguimiento habilitado.
En algunas circunstancias, puede ser conveniente quitar todas las solicitudes almacenadas en el visor de seguimiento. Quizá desee hacer un seguimiento de los cambios de los archivos de la aplicación o simplemente ver información sobre archivos distintos de los asociados a las solicitudes mostradas.
Para borrar las solicitudes del visor de seguimiento
Desplácese al visor de seguimiento asociado a la aplicación.
Seleccione el vínculo borrar rastro actual para quitar todas las solicitudes almacenadas en la aplicación del visor de seguimiento.
Nota El visor de seguimiento sólo se ocupará de las solicitudes realizadas después de borrar el registro. Las solicitudes efectuadas después de alcanzar el límite establecido y antes de borrar el registro no pueden visualizarse.
Vea también
TraceModeEnum (Enumeración) | Seguimiento de ASP.NET | Esquema de la configuración de ASP.NET | Habilitar el seguimiento de una página