Compartir a través de


Edición de colecciones con el editor de configuración: secciones complejas

por Crystal Hoyer

Objetivo del tutorial

Use el Editor de colección en el módulo Editor de configuración para agregar una nueva regla de seguimiento de solicitudes con error para una solicitud aspx que devuelva un código de estado 401 o tarde más de un minuto en responder. Esta tarea puede llevarse a cabo utilizando la interfaz de usuario actual, pero los pasos que se tomen expondrán una característica importante dentro del nuevo módulo Editor de configuración del Paquete de administración.

Requisitos previos

Para poder seguir este tutorial, es necesario reunir los siguientes requisitos previos:

Acceso a la secciónsystem.webServer/tracing/traceFailedRequests

  1. Abra el Administrador de IIS.

  2. Seleccione el servidor en la vista de árbol de conexiones.

  3. Abra el módulo Interfaz de usuario del Editor de configuración.

    Screenshot of the I I S Manager window. The server home features is in the main pane.

  4. En el cuadro combinado Sección del Editor de configuración, seleccione system.webServer – tracing - traceFailedRequests o escriba system.webServer/tracing/traceFailedRequests

    Screenshot showing the Configuration Editor with the section input box.

Uso del Editor de colección para agregar una nueva regla de solicitud de seguimiento con errores

  1. Seleccione la entrada (Colección) dentro del Editor de configuración y haga clic en... botón situado junto a (Count=0). Se abrirá el Editor de colección para editar la colección tracefailedRequests.

    Screenshot showing the Configuration Editor. Collection is highlighted and shows Count = 0.

  2. En el panel de tareas Acciones del lado derecho, haga clic en Agregar. Ahora tendrá una nueva entrada en la sección Elementos, así como una lista de propiedades.

    Screenshot of the Collection Editor window with settings in the Properties section.

  3. La sección Propiedades del editor de colección viene rellenada previamente con los valores predeterminados de esquema de la colección definida. En este caso, obtendrá los valores predeterminados del esquema para los elementos de colección system.webServer/tracing/traceFailedRequests.

  4. Hay una clave junto a la entrada de la propiedad path. Esto significa que esta es la clave única para esta entrada de colección. Las claves doradas significan que esta clave debe ser única para cada elemento de la colección. Una clave plateada significa que se trata de una clave compartida. La combinación de claves compartidas debe ser única para un elemento de colección en este caso.

  5. Cambie la entrada path por *.aspx para crear una regla para todas las rutas asp.net.

  6. Cambie la entrada statusCodes a 401.

  7. Cambie la entrada timeTaken 00:01:00.

  8. Seleccione la entrada (traceAreas) dentro del Editor de colección y haga clic en... botón situado junto a (Count=0). Se abrirá el Editor de colección para editar la colección traceAreas.

    Screenshot of the Collection Editor window. Trace areas is selected in the Properties section.

  9. En el panel de tareas Acciones del lado derecho, haga clic en Agregar. Ahora tendrá una nueva entrada en la sección Elementos, así como una lista de propiedades.

    Screenshot of the Collection Editor window. The Item pane shows a warning. The properties pane shows a warning.

  10. La sección Propiedades del editor de colección viene rellenada previamente con los valores predeterminados de esquema de la colección definida. En este caso, obtendrá los valores predeterminados del esquema para los elementos de colección system.webServer/tracing/traceFailedRequests/add/traceAreas.

  11. Hay una clave junto a la entrada de la propiedad provider. Esto significa que esta es la clave única para esta entrada de colección. Las claves doradas significan que esta clave debe ser única para cada elemento de la colección. Una clave plateada significa que se trata de una clave compartida. La combinación de claves compartidas debe ser única para un elemento de colección en este caso.

  12. Cambie la entrada provider a ASPNET.

  13. Cambie la entrada areas a Infraestructura, Módulo, Página, AppServices. [Nota: Puede obtener el nombre del proveedor y las áreas correspondientes en la sección system.webServer/tracing/traceProviderDefinitions].

  14. Que la entrada verbosity sea Advertencia.

  15. Cierre el Editor de colección para traceAreas.

  16. Cierre el Editor de colección para traceFailedRequests.

  17. Para establecer los cambios, debe hacer clic en Aplicar en el panel de tareas Acciones. Antes de hacerlo, haga clic en Generar script en el panel de tareas Acciones. Ahora tiene código de script para agregar una regla de solicitud de seguimiento con errores para las solicitudes aspx que devuelven 401 o tardan más de un minuto en responder.

  18. Haga clic en Aplicar en el panel de tareas Acciones para realizar los cambios en la configuración.

  19. Para comprobar rápidamente la nueva regla de seguimiento de solicitudes con error agregada, vaya a la página de características Reglas de seguimiento de solicitudes con error.

    Screenshot of the I I S Manager window. The site home features are in the main pane. The Failed Request Tracing Rules icon is highlighted.

  20. La regla que acabamos de agregar con la característica del editor de configuración debe aparecer en la página reglas de seguimiento de solicitudes con error.

    Screenshot of the I I S Manager window. Failed Request Tracing Rules displays in the main pane.

  21. [Paso adicional] Si no desea conservar ninguna de las reglas de solicitud de seguimiento con errores que creó, edite de nuevo las colecciones tracefailedRequests y haga clic en Borrar todo en el panel de tareas Acciones. Haga clic en Aplicar en el editor de configuración y se quitará la regla recién agregada.

Resumen

Ahora ha creado una nueva regla de solicitud de seguimiento con errores mediante la herramienta Editor de colección del Editor de configuración. El Editor de colección expone todas las opciones de configuración de una colección determinada.