Recuperación de archivos de registro de aplicaciones

• 6 minutos

Los archivos de registro son un excelente recurso para un desarrollador web, pero solo si sabe cómo encontrar y usar la información registrada. Aquí examinará los métodos que se pueden usar para recuperar información registrada, lista para realizar análisis sin conexión.

Ubicaciones de almacenamiento de los archivos de registro

La infraestructura de Azure que se usa para ejecutar aplicaciones web de Azure en Windows no es la misma que la de las aplicaciones de Linux, y los archivos de registro no se almacenan en las mismas ubicaciones.

Archivos de registro de aplicaciones de Windows

En el caso de las aplicaciones de Windows, los archivos de registro del sistema de archivos se almacenan en una unidad virtual que está asociada a la aplicación web. Esta unidad es direccionable como D:\Home, e incluye una carpeta LogFiles. Dentro de esta carpeta hay una o varias subcarpetas:

• Application: contiene mensajes generados por la aplicación, si se ha habilitado el registro de aplicaciones Sistema de archivos.
• DetailedErrors: contiene registros de error detallados del servidor web, si se ha habilitado Mensajes de error detallados.
• http: contiene registros de nivel de IIS, si se ha habilitado Registro del servidor web.
• W3SVC<number>: contiene detalles de todas las solicitudes http con error, si se ha habilitado Seguimiento de solicitudes con error.

Si se ha habilitado el almacenamiento en un contenedor de blobs, los registros se almacenan en carpetas de año, mes, fecha y hora, por ejemplo:

2019
  01
   10
    08 - log entries for the period 08:00:00 to 08:59:59 on January 10th 2019
    09 - log entries for the period 09:00:00 to 09:59:59 on January 10th 2019

Dentro de la carpeta de hora, habrá uno o varios archivos CSV que contienen los mensajes guardados durante ese intervalo de 60 minutos.

Archivos de registro de aplicaciones de Linux

Actualmente, las herramientas de Azure admiten menos opciones de registro para aplicaciones web de Linux que para aplicaciones de Windows. Los redireccionamientos a STDERR y STDOUT se administran a través del contenedor de Docker subyacente que ejecuta la aplicación, y estos mensajes se almacenan en archivos de registro de Docker. Para ver los mensajes registrados por procesos subyacentes (como Apache), deberá abrir una conexión SSH al contenedor de Docker.

Métodos para recuperar archivos de registro

El modo en que se recuperen archivos de registro dependerá del tipo de archivo de registro, así como del entorno de su elección. Con los registros del sistema de archivos puede usar la CLI de Azure o la consola de Kudu.

CLI de Azure

Para descargar archivos de registro del sistema de archivos mediante la CLI de Azure, copie primero los archivos de registro desde el sistema de archivos de la aplicación al almacenamiento de Cloud Shell y, luego, ejecute el siguiente comando.

az webapp log download --log-file \<_filename_\>.zip  --resource-group \<_resource group name_\> --name \<_app name_\>

Para descargar los archivos de registro comprimidos en el equipo local, listos para abrirse en Microsoft Excel (o en otras aplicaciones), use la herramienta de carga y descarga de archivos de la barra de herramientas de Cloud Shell.

Kudu

Todas las aplicaciones web de Azure tienen asociado un sitio del servicio Administración del control de código fuente (SCM). Este sitio ejecuta el servicio Kudu y otras extensiones de sitio. Kudu se encarga de administrar la implementación y solución de problemas de Azure Web Apps, además de las opciones para ver y descargar archivos de registro. La funcionalidad específica disponible en KUDU y el método de descarga de los registros dependerán del tipo de aplicación web. Para las aplicaciones de Windows, puede ir a la ubicación del archivo de registro y descargar los registros; por su parte, para las aplicaciones de Linux, es posible que haya un vínculo de descarga.

Una forma de acceder a la consola de Kudu consiste en navegar a https://<app name>.scm.azurewebsites.net y, luego, iniciar sesión con las credenciales de implementación.

También se puede acceder a Kudu mediante Azure Portal. En la sección Herramientas de desarrollo del panel de la aplicación, seleccione Herramientas avanzadas, luego el panel Herramientas avanzadas y, por último, para abrir una nueva pestaña Servicios de Kudu, seleccione Ir.

Para descargar los archivos de registro de aplicaciones de Windows:

1. Seleccione Consola de depuración y, después, seleccione CMD.

   

2. En la sección Explorador de archivos, seleccione LogFiles y, para la carpeta Application, seleccione Descargar. Los registros se descargarán en el equipo como Application.zip.

   

   En el caso de las aplicaciones de Linux, seleccione el vínculo de descarga de la página Entorno.

   

Explorador de Azure Storage

Para acceder a los registros de Windows guardados en un contenedor de Azure Blob Storage, puede usar Azure Portal; para ver y descargar el contenido del contenedor de archivos de registro, seleccione Explorador de Storage. Abra la carpeta de año, mes, fecha y hora correspondiente y, después, haga doble clic en un archivo CSV para descargarlo en el equipo.

Si tiene Microsoft Excel en el equipo, el archivo de registro se abrirá automáticamente como una hoja de cálculo; si no, puede abrirlo con un editor de texto, como el Bloc de notas.