Configuración de diagnósticos para Azure Cloud Services y máquinas virtuales

Nota:

Este artículo se aplica a Azure Cloud Services (clásico), que ahora está en desuso para los nuevos clientes y se retirará el 31 de agosto de 2024. Los servicios existentes creados con esta tecnología siguen teniendo soporte técnico a través de Azure Cloud Services (soporte extendido). Para los desarrollos nuevos, le recomendamos que use un tipo de servicio más reciente diseñado para su propósito específico, como por ejemplo, Azure App Service, Azure Functions o Azure Container Apps. Para obtener la lista más reciente de los servicios disponibles, consulte Directorio de productos de Azure.

Cuando tenga que solucionar problemas de un servicio en la nube o una máquina virtual de Azure, puede usar Visual Studio para configurar más fácilmente Azure Diagnostics. Diagnostics captura los datos del sistema y los datos de registro en las máquinas virtuales y las instancias de máquina virtual que ejecutan el servicio en la nube. Los datos de Diagnostics se transfieren a la cuenta de almacenamiento que elija. Para más información sobre el registro de diagnósticos en Azure, consulte Habilitación del registro de diagnóstico para Web Apps en Azure App Service.

En este artículo, le mostramos cómo usar Visual Studio para activar y configurar Azure Diagnostics, tanto antes como después de la implementación. Obtenga información sobre cómo configurar el diagnóstico en máquinas virtuales de Azure y sobre cómo seleccionar los tipos de información de diagnóstico que se recopilarán y cómo ver la información recopilada.

Para configurar Azure Diagnostics, cambie la configuración de diagnóstico en el cuadro de diálogo Configuración de diagnóstico en Visual Studio. La configuración se guarda en un archivo llamado diagnostics.wadcfgx. También puede modificar directamente el archivo de configuración. Si actualiza manualmente el archivo, los cambios de configuración surten efecto la próxima vez que implementa el servicio en la nube en Azure o que ejecuta el servicio en el emulador.

Advertencia

En Visual Studio 2022, el emulador de Azure Storage en desuso se reemplazó por el emulador de Azurite al depurar los proyectos del servicio en la nube. Este emulador de Azurite no funciona con el complemento de Azure Diagnostics, que proporciona compatibilidad con Azure Diagnostics al ejecutar y probar localmente. Si necesita el complemento para escenarios locales de ejecución y pruebas, puede actualizar la cadena de conexión en la configuración del servicio local (.cscfg) a una cuenta de Azure Storage (consulte Administrar cadenas de conexión para cuentas de almacenamiento) o descargar el emulador de Azure Storage anterior. En la versión de Visual Studio 17.10, el complemento de Azure Diagnostics local está en desuso y se deshabilitará de forma predeterminada con la opción de habilitar en esa versión. Debido al desuso, es posible que el complemento se quite en una versión futura de Visual Studio. Este complemento solo se usa con el emulador de Azure Compute local y la deshabilitación no afecta a los servicios en la nube implementados que usan la extensión de Azure Diagnostics en Azure. Para habilitar el complemento de diagnóstico en Visual Studio 17.10, agregue la siguiente configuración de propiedad a cualquier PropertyGroup en su archivo de proyecto: <EnableEmulatorDiagnosticsPlugin>True</EnableEmulatorDiagnosticsPlugin>.

Cómo determina Visual Studio la cuenta de almacenamiento de diagnósticos

• Si se especifica una cadena de conexión de diagnósticos en el archivo .cscfg, Visual Studio la utiliza para configurar la extensión de diagnósticos durante la publicación y cuando genera los archivos XML de configuración pública durante el empaquetado.
• Si no se especifica una cadena de conexión de diagnóstico en el archivo .cscfg, Visual Studio volverá a utilizar la cuenta de almacenamiento especificada en el archivo .wadcfgx para configurar la extensión de diagnóstico durante la publicación y para generar los archivos XML de configuración pública durante el empaquetado.
• La cadena de conexión de diagnóstico del archivo .cscfg tiene prioridad sobre la cuenta de almacenamiento del archivo .wadcfgx. Si se especifica una cadena de conexión de diagnóstico en el archivo .cscfg, Visual Studio utiliza esa cadena de conexión e ignora la cuenta de almacenamiento en el archivo .wadcfgx.

¿Qué hace la casilla "Actualizar las cadenas de conexión de almacenamiento de..."?

La casilla Actualizar las cadenas de conexión de almacenamiento de desarrollo para el diagnóstico y el almacenamiento en caché con las credenciales de la cuenta de almacenamiento de Microsoft Azure al publicar en Microsoft Azure le ofrece una manera cómoda de actualizar cualquier cadena de conexión de cuenta de almacenamiento de desarrollo con la cuenta de almacenamiento de Azure especificada durante la publicación.

Por ejemplo, si activa esta casilla y la cadena de conexión de diagnóstico especifica UseDevelopmentStorage=true, al publicar el proyecto en Azure, Visual Studio actualiza automáticamente la cadena de conexión de diagnóstico con la cuenta de almacenamiento que especificó en el Asistente para publicación. Sin embargo, si se especificó una cuenta de almacenamiento real como la cadena de conexión de diagnóstico, se usa esa cuenta en su lugar.

Activación de diagnósticos en los proyectos de servicios en la nube antes de implementarlos

En Visual Studio, puede recopilar datos de diagnóstico para roles que se ejecutan en Azure, al ejecutar el servicio en el emulador antes de la implementación. Todos los cambios a la configuración de diagnóstico de Visual Studio se guardan en el archivo de configuración diagnostics.wadcfgx. Esta configuración especifica la cuenta de almacenamiento donde se guardan los datos de diagnóstico cuando implementa el servicio en la nube.

Advertencia

Cuando se habilita el diagnóstico para un rol existente, todas las extensiones que se hayan establecido ya se deshabilitan al implementar el paquete. Entre ellos, se incluye:

• Diagnósticos de Microsoft Monitoring Agent
• Supervisión de la seguridad de Microsoft Azure
• Microsoft Antimalware
• Microsoft Monitoring Agent
• Agente del generador de perfiles del servicio de Microsoft
• Extensión de dominio de Microsoft Azure
• Extensión de Microsoft Azure Diagnostics
• Extensión de escritorio remoto de Microsoft Azure
• Recopilador de registros de Microsoft Azure

Puede volver a establecer sus extensiones a través de Azure Portal o de PowerShell después de haber implementado el rol actualizado.

Activar los diagnósticos en Visual Studio antes de la implementación

1. En el menú contextual para el rol, seleccione Propiedades. En el cuadro de diálogo Propiedades del rol, seleccione la pestaña Configuración.

2. En la sección Diagnósticos, asegúrese de que la casilla Habilitar diagnósticos está seleccionada.

   

3. Para especificar la cuenta de almacenamiento para los datos de diagnóstico, seleccione el botón de puntos suspensivos (...).

   

4. En el cuadro de diálogo Crear cadena de conexión de almacenamiento, especifique si quiere conectarse mediante el Emulador de Azure Storage, una suscripción de Azure o credenciales escritas manualmente.

   

   • Si selecciona Emulador de Microsoft Azure Storage, la cadena de conexión se establece en UseDevelopmentStorage=true.
   • Si selecciona Su suscripción, puede elegir la suscripción de Azure que quiere usar y escribir un nombre de cuenta. Para administrar las suscripciones de Azure, seleccione Administrar cuentas.
   • Si selecciona Credenciales escritas manualmente, se le pedirá que escriba el nombre y la clave de la cuenta de Azure que quiere usar.

5. Para ver el cuadro de diálogo Configuración de diagnóstico, seleccione Configurar. Excepto para General y Directorios de registro, cada pestaña representa un origen de datos de diagnóstico que puede recopilar. La pestaña General predeterminada le ofrece las siguientes opciones de recopilación de datos de diagnóstico: Solo errores, Toda la información y Plan personalizado. La opción predeterminada Solo errores usa la cantidad mínima de almacenamiento porque no transfiere advertencias ni mensajes de seguimiento. La opción Toda la información transfiere la mayor parte de la información, usa el máximo almacenamiento y, por tanto, es la opción más cara.

   Nota:

   El tamaño mínimo admitido para "Cuota de disco en MB" es de 50 MB, y el tamaño predeterminado es de 4 GB. Sin embargo, si va a recopilar volcados de memoria, aumente a un valor superior, como 10 GB.

   

6. En este ejemplo, seleccione la opción Plan personalizado para que pueda personalizar los datos recopilados.

7. El cuadro Cuota de disco en MB especifica la cantidad de espacio que quiere asignar en su cuenta de almacenamiento de datos de diagnóstico. Puede cambiar o aceptar el valor predeterminado.

8. En cada pestaña de datos de diagnóstico que quiera recopilar, active su casilla Habilitar la transferencia de <tipo de registro>. Por ejemplo, si quiere recopilar registros de aplicación, en la pestaña Registros de aplicación, active la casilla Habilitar la transferencia de registros de aplicación. Además, especifique cualquier otra información requerida por cada tipo de datos de diagnóstico. Para consultar la información de configuración de cada pestaña, vea la sección Configuración de orígenes de datos de diagnósticos más adelante en este artículo.

9. Después de habilitar la recopilación de todos los datos de diagnóstico que quiera, seleccione Aceptar.

10. Abra el proyecto del servicio en la nube de Azure en Visual Studio de la manera habitual. Conforme usa la aplicación, la información de registro que habilitó se guarda en la cuenta de almacenamiento de Azure que especificó.

Configuración de orígenes de datos de diagnósticos

Cuando habilite la recopilación de datos de diagnóstico, puede elegir exactamente qué orígenes de datos quiere recopilar y qué información se recopila. En las secciones siguientes se describen las pestañas del cuadro de diálogo Configuración de diagnósticos y lo que significa cada opción de configuración.

Registros de aplicación

Los registros de aplicación contienen información de diagnóstico generada por una aplicación web. Si quiere capturar registros de la aplicación, seleccione la casilla Habilitar transferencia de registros de la aplicación. Para aumentar o disminuir el intervalo entre la transferencia de registros de aplicación a la cuenta de almacenamiento, cambie el valor Período de transferencia (min). También puede cambiar la cantidad de información que se captura en el registro estableciendo el valor Nivel de registro. Por ejemplo, seleccione Detallado para más información o Crítico para capturar solo los errores críticos. Si tiene un proveedor de diagnósticos específico que emite registros de aplicación, puede capturarlos agregando el GUID del proveedor en el cuadro GUID de proveedor.

Para más información sobre los registros de aplicación, vea Habilitación del registro de diagnóstico para aplicaciones web en Azure App Service.

Registros de eventos de Windows

Para capturar registros de aplicación de Windows, active la casilla Habilitar la transferencia de registros de eventos de Windows. Para aumentar o disminuir el intervalo entre la transferencia de registros de eventos a la cuenta de almacenamiento, cambie el valor Período de transferencia (min). Active las casillas para los tipos de eventos de los que quiera realizar un seguimiento.

Si desea especificar un origen de datos personalizado, introdúzcalo en el cuadro de texto <Nombre del origen de datos> y, a continuación, seleccione Agregar. El origen de datos se agrega al archivo diagnostics.cfcfg.

Contadores de rendimiento

La información del contador de rendimiento puede ayudarle a buscar cuellos de botella del sistema y a optimizar el rendimiento del sistema y de la aplicación. Para más información, vea Crear y usar contadores de rendimiento en una aplicación de Azure. Para capturar los contadores de rendimiento, active la casilla Habilitar la transferencia de contadores de rendimiento. Para aumentar o disminuir el intervalo entre la transferencia de registros de eventos a la cuenta de almacenamiento, cambie el valor Período de transferencia (min). Active las casillas para los contadores de rendimiento de los que quiera realizar un seguimiento.

Para realizar el seguimiento de un contador de rendimiento que no aparece en la lista, especifíquelo con la sintaxis sugerida. A continuación, seleccione Agregar. El sistema operativo de la máquina virtual determina qué contadores de rendimiento puede realizar el seguimiento. Para obtener más información sobre la sintaxis, vea Especificar una ruta de acceso de contador.

Registros de infraestructura

Los registros de infraestructura tienen información sobre la infraestructura de diagnóstico de Azure, el módulo RemoteAccess y el módulo RemoteForwarder. Para recopilar información sobre los registros de infraestructura, active la casilla Habilitar transferencia de registros de infraestructura. Para aumentar o disminuir el intervalo entre la transferencia de registros de infraestructura a la cuenta de almacenamiento, cambie el valor Período de transferencia (min).

Para más información, consulte Recopilar datos de registro mediante Azure Diagnostics.

Directorios de registro

Los directorios de registro tienen datos recopilados para las solicitudes de Internet Information Services (IIS), las solicitudes con error o las carpetas que elija. Para capturar los directorios de registro, active la casilla Habilitar la transferencia de directorios de registro. Para aumentar o disminuir el intervalo entre la transferencia de registros a la cuenta de almacenamiento, cambie el valor Período de transferencia (min).

Puede activar las casillas de los registros que quiera recopilar, como Registros de IIS y los registros de Solicitud con error. Se proporcionan nombres de contenedor de almacenamiento predeterminados, pero puede cambiar los nombres.

Puede capturar registros desde cualquier carpeta. Especifique la ruta de acceso en la sección Registro del directorio absoluto y seleccionar Agregar directorio. Los registros se capturan en los contenedores especificados.

Registros de ETW

Si usa Seguimiento de eventos para Windows (ETW) y quiere capturar registros de ETW, active la casilla Habilitar la transferencia de registros de ETW. Para aumentar o disminuir el intervalo entre la transferencia de registros a la cuenta de almacenamiento, cambie el valor Período de transferencia (min).

Los eventos se capturan de los orígenes de eventos y manifiestos de eventos que especifique. Para especificar un origen de eventos, en la sección Orígenes de eventos escriba un nombre y luego seleccione Agregar origen de evento. De forma similar, puede especificar un manifiesto de evento en la sección Manifiestos de eventos y luego seleccionar Agregar manifiesto de evento.

El marco de ETW se admite en ASP.NET a través de las clases del espacio de nombres System.Diagnostics.aspx. El espacio de nombres Microsoft.WindowsAzure.Diagnostics, que se hereda de las clases estándar System.Diagnostics.aspx, permite el uso de System.Diagnostics.aspx como plataforma de registro en el entorno de Azure. Para más información, vea Tome el control de registro y seguimiento en Microsoft Azure y Habilitación de diagnósticos en Azure Cloud Services y máquinas virtuales.

Volcados de memoria

Para capturar información sobre cuándo se bloquea una instancia de rol, active la casilla Habilitar la transferencia de volcados de memoria. (Dado que ASP.NET controla la mayoría de las excepciones, esto suele ser útil solo para los roles de trabajo). Para aumentar o disminuir el porcentaje de espacio de almacenamiento dedicado a los volcados de memoria, cambie el valor cuota de directorio (%). Puede cambiar el contenedor de almacenamiento donde se almacenan los volcados de memoria y seleccionar si quiere capturar un volcado Completo o Mini.

En la captura de pantalla siguiente, se muestran los procesos de los que se está realizando un seguimiento actualmente. Active las casillas para los procesos que quiera capturar. Para agregar otro proceso a la lista, escriba el nombre del proceso y luego seleccione Agregar proceso .

Para obtener más información, consulte Tome control de registro y seguimiento en Microsoft Azure.

Solucionar problemas del servicio en la nube de Azure

Si experimenta problemas con sus proyectos de servicio en la nube, como un rol que se atasca en un estado "ocupado", recicla de manera repetida o genera un error de servidor interno, existen herramientas y técnicas que puede usar para diagnosticar y corregir el problema. Para ver ejemplos específicos de problemas comunes y soluciones, así como para obtener información general sobre los conceptos y herramientas que se usan para diagnosticar y corregir estos errores, consulte Datos de diagnóstico de proceso de plataforma como servicio (PaaS) de Azure.

Preguntas y respuestas

¿Cuál es el tamaño del búfer y cuál debería ser?

En cada instancia de máquina virtual, las cuotas limitan cuántos datos de diagnósticos se pueden almacenar en el sistema de archivos local. Además, especifique un tamaño de búfer para cada tipo de datos de diagnóstico que está disponible. Este tamaño de búfer actúa como una cuota individual para ese tipo de datos. Para determinar la cuota global y la cantidad de memoria que permanece, vea la parte inferior del cuadro de diálogo correspondiente al tipo de datos de diagnóstico. Si especifica búferes mayores o más tipos de datos, alcanzará la cuota global. Puede cambiar la cuota global modificando el archivo de configuración diagnostics.wadcfgx. Los datos de diagnóstico se almacenan en el mismo sistema de archivos que los datos de la aplicación. Si la aplicación utiliza una gran cantidad de espacio en disco, no debería aumentar la cuota de diagnóstico total.

¿Cuál es el período de transferencia y cuál debería ser?

El período de transferencia es el tiempo que transcurre entre las capturas de datos. Tras cada período de transferencia, los datos se mueven desde el sistema de archivos local de una máquina virtual a las tablas de su cuenta de almacenamiento. Si la cantidad de datos que se recopilan supera la cuota antes del final de un período de transferencia, se descartarán los datos más antiguos. Si pierde datos porque superan el tamaño del búfer o la cuota global, puede ser aconsejable reducir el período de transferencia.

¿En qué zona horaria están las marcas de tiempo?

Las marcas de tiempo se encuentran en la zona horaria local del centro de datos que hospeda el servicio en la nube. Se usan las siguientes tres columnas de marca de tiempo en las tablas de registro:

• PreciseTimeStamp: marca de tiempo de ETW del evento. Es decir, el tiempo en que se registra el evento del cliente.
• TIMESTAMP: el valor de PreciseTimeStamp redondeado hacia abajo hasta el límite de la frecuencia de carga. Por ejemplo, si su frecuencia de carga es de 5 minutos y la hora del evento es 00:17:12, TIMESTAMP es 00:15:00.
• Timestamp: marca de tiempo en que se creó la entidad en la tabla de Azure.

¿Cómo administrar los costos al recopilar información de diagnóstico?

La configuración predeterminada (Nivel de registro establecido en Error y Período de transferencia establecido en 1 minuto) está diseñada para minimizar los costos. Los costos de proceso aumentarán si recopila más datos de diagnóstico o disminuye el período de transferencia. No recopile más datos de los que necesite y no olvide deshabilitar la colección de datos cuando ya no la necesite. Siempre puede habilitarlo de nuevo, incluso en tiempo de ejecución, como se ha descrito anteriormente en este artículo.

¿Cómo recopilo registros de solicitudes con error de IIS?

De forma predeterminada, IIS no recopila registros de solicitud con error. Puede configurar IIS para recopilar registros de solicitudes con error editando el archivo web.config para su rol web.

No estoy obteniendo información de seguimiento desde métodos RoleEntryPoint como OnStart. ¿Qué ocurre?

A los métodos de RoleEntryPoint se les llama en el contexto de WAIISHost.exe, no en IIS. No se aplica la información de configuración de archivo web.config que normalmente habilita el seguimiento. Para resolver este problema, agregue un archivo .config a su proyecto de rol web y asigne un nombre al archivo que coincida con el ensamblado de salida que contiene el código RoleEntryPoint. En el proyecto de rol web predeterminado, el nombre del archivo .config sería WAIISHost.exe.config. A continuación, agregue las líneas siguientes a este archivo:

<system.diagnostics>
  <trace>
      <listeners>
          <add name "AzureDiagnostics" type="Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener">
              <filter type="" />
          </add>
      </listeners>
  </trace>
</system.diagnostics>

En la ventana Propiedades, establezca la propiedad Copiar en el directorio de salida en Copiar siempre.

Contenido relacionado

Para más información sobre el registro de diagnósticos de Azure, consulte Habilitación de diagnósticos en Azure Cloud Services y máquinas virtuales y Habilitación del registro de diagnóstico para Web Apps en Azure App Service.