Compartir vía

Instalación y configuración de la extensión de Azure Diagnostics para Windows (WAD)

La extensión Azure Diagnostics es un agente de Azure Monitor que recopila datos de supervisión del sistema operativo invitado y las cargas de trabajo de Azure máquinas virtuales y otros recursos de proceso. En este artículo se proporciona información sobre cómo instalar y configurar la extensión de Azure Diagnostics para Windows y se describe cómo se almacenan los datos en una cuenta de Azure Storage.

Importante

La extensión de Azure Diagnostics se consideró obsoleta el 31 de marzo de 2026 y ya no se admite. No se recomiendan nuevas implementaciones de la extensión. Para garantizar el soporte y el acceso continuos a las nuevas características, migre a las soluciones alternativas recomendadas aquí.

La extensión de diagnóstico se implementa como una extensión de máquina virtual en Azure. Admite las mismas opciones de instalación mediante plantillas de Azure Resource Manager, PowerShell y el CLI de Azure. Para obtener información sobre cómo instalar y mantener extensiones de máquina virtual, consulte Características y extensiones de máquina virtual para Windows.

Introducción

Al configurar la extensión Azure Diagnostics para Windows, debe especificar una cuenta de almacenamiento donde se enviarán todos los datos especificados. Opcionalmente, puede agregar uno o más receptores de datos con el fin de enviar los datos a ubicaciones diferentes.

  • Receptor de Azure Monitor: envíe datos de rendimiento de invitados a métricas de Azure Monitor.
  • Azure Event Hub Sink: enviar datos de rendimiento y registro de invitados a los centros de eventos para reenviarlos fuera de Azure. No se puede configurar este receptor en Azure Portal.

Instalación con Azure portal

Puede instalar y configurar la extensión de diagnóstico en una máquina virtual individual en el portal de Azure. Usarás una interfaz en lugar de trabajar directamente con la configuración. Al habilitar la extensión de diagnósticos, se usará automáticamente una configuración predeterminada con los eventos y contadores de rendimiento más comunes. Esta configuración predeterminada se puede modificar de acuerdo con sus requisitos específicos.

Nota

En los pasos siguientes se describe la configuración más común de la extensión de diagnósticos. Para obtener más información sobre todas las opciones de configuración, consulte el esquema de extensión de diagnóstico de Windows.

  1. Abra el menú de una máquina virtual en el portal de Azure.

  2. Seleccinoe Configuración de diagnóstico en la sección Supervisión del menú de la máquina virtual.

  3. Seleccione Habilitar supervisión a nivel de invitado si aún no se ha habilitado la extensión de diagnósticos.

    Captura de pantalla que muestra cómo habilitar la supervisión.

  4. Se creará una nueva cuenta de Azure Storage para la máquina virtual. El nombre se basará en el nombre del grupo de recursos de la máquina virtual. Se seleccionará un conjunto predeterminado de contadores de rendimiento de invitado y registros.

    Captura de pantalla que muestra la configuración de diagnóstico.

  5. En la pestaña Contadores de rendimiento, seleccione las métricas de invitado que quiere recopilar de esta máquina virtual. Use la opción Personalizado para realizar una selección más avanzada.

    Captura de pantalla que muestra los contadores de rendimiento.

  6. En la pestaña Registros, seleccione los registros que se van a recopilar de la máquina virtual. Los registros se pueden enviar al almacenamiento o a event hubs, pero no a Azure Monitor. Use el agente Log Analytics para recopilar registros de invitado en Azure Monitor.

    Captura de pantalla que muestra la pestaña Registros con diferentes registros seleccionados para una máquina virtual.

  7. En la pestaña Volcados de memoria, especifique cualquier proceso para recopilar volcados de memoria después de un bloqueo. Los datos se escribirán en la cuenta de almacenamiento para la configuración de diagnóstico. Opcionalmente, puede especificar un contenedor de blobs.

    Recorte de pantalla que muestra la pestaña Volcados de memoria.

  8. En la pestaña Sinks, especifique si se deben enviar los datos a ubicaciones distintas del almacenamiento de Azure. Si selecciona Azure Monitor, los datos de rendimiento de invitado se enviarán a Azure Monitor Métricas. No se puede configurar el receptor de centros de eventos mediante Azure Portal.

    Captura de pantalla que muestra la pestaña Receptores con la opción Enviar datos de diagnóstico a Azure Monitor habilitada.

    Si no ha habilitado una identidad asignada por el sistema configurada para la máquina virtual, es posible que vea la siguiente advertencia al guardar una configuración con el receptor de Azure Monitor. Seleccione el banner para habilitar la identidad asignada por el sistema.

    Recorte de pantalla que muestra la advertencia de identidad administrada.

  9. En la pestaña Agente, puede cambiar la cuenta de almacenamiento, establecer la cuota de disco y especificar si desea recopilar registros de infraestructura de diagnóstico.

    Captura de pantalla que muestra la pestaña Agente con la opción para establecer la cuenta de almacenamiento.

  10. Para guardar la configuración, seleccione Guardar.

Nota

La configuración de la extensión de diagnóstico se puede formatear en JSON o XML, pero cualquier configuración realizada en el portal de Azure siempre se almacenará como JSON. Si usa XML con otro método de configuración y, a continuación, cambia la configuración con el portal de Azure, la configuración se cambiará a JSON. Además, no hay ninguna opción para configurar el período de retención para estos registros.

plantilla de Resource Manager

Consulte Uso de la supervisión y el diagnóstico con una máquina virtual Windows y plantillas de Azure Resource Manager para más información sobre la implementación de la extensión de diagnósticos con plantillas de Azure Resource Manager.

implementación de CLI de Azure

El CLI de Azure se puede usar para implementar la extensión Azure Diagnostics en una máquina virtual existente mediante az vm extension set como en el ejemplo siguiente:

az vm extension set \
  --resource-group myResourceGroup \
  --vm-name myVM \
  --name IaaSDiagnostics \
  --publisher Microsoft.Azure.Diagnostics \
  --protected-settings protected-settings.json \
  --settings public-settings.json

La configuración protegida se define en el elemento PrivateConfig del esquema de configuración. El siguiente ejemplo mínimo de un archivo de configuración protegida define la cuenta de almacenamiento. Consulte Configuración de ejemplo para ver detalles completos de la configuración privada.

{
    "storageAccountName": "mystorageaccount",
    "storageAccountKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "storageAccountEndPoint": "https://core.windows.net"
}

La configuración pública se define en el elemento Public del esquema de configuración. El siguiente ejemplo mínimo de un archivo de configuración pública permite la recopilación de registros de infraestructura de diagnóstico, un único contador de rendimiento y un único registro de eventos. Consulte Configuración de ejemplo para información detallada sobre la configuración pública.

{
  "StorageAccount": "mystorageaccount",
  "WadCfg": {
    "DiagnosticMonitorConfiguration": {
      "overallQuotaInMB": 5120,
      "PerformanceCounters": {
        "scheduledTransferPeriod": "PT1M",
        "PerformanceCounterConfiguration": [
          {
            "counterSpecifier": "\\Processor Information(_Total)\\% Processor Time",
            "unit": "Percent",
            "sampleRate": "PT60S"
          }
        ]
      },
      "WindowsEventLog": {
        "scheduledTransferPeriod": "PT1M",
        "DataSource": [
          {
            "name": "Application!*[System[(Level=1 or Level=2 or Level=3)]]"
          }
        ]
      }
    }
  }
}

Implementación de PowerShell

PowerShell se puede usar para implementar la extensión de Azure Diagnostics en una máquina virtual existente mediante Set-AzVMDiagnosticsExtension, como en el ejemplo siguiente:

Set-AzVMDiagnosticsExtension -ResourceGroupName "myvmresourcegroup" `
  -VMName "myvm" `
  -DiagnosticsConfigurationPath "DiagnosticsConfiguration.json"

La configuración privada se define en el elemento PrivateConfig. La configuración pública se define en el elemento Public del esquema de configuración. También puede optar por especificar los detalles de la cuenta de almacenamiento como parámetros del cmdlet Set-AzVMDiagnosticsExtension en lugar de incluirlos en la configuración privada.

El siguiente ejemplo mínimo de un archivo de configuración permite la recopilación de registros de infraestructura de diagnóstico, un único contador de rendimiento y un único registro de eventos. Consulte Configuración de ejemplo para información detallada sobre la configuración pública y privada.

{
    "PublicConfig": {
        "WadCfg": {
            "DiagnosticMonitorConfiguration": {
                "overallQuotaInMB": 10000,
                "DiagnosticInfrastructureLogs": {
                    "scheduledTransferLogLevelFilter": "Error"
                },
                "PerformanceCounters": {
                    "scheduledTransferPeriod": "PT1M",
                    "PerformanceCounterConfiguration": [
                        {
                            "counterSpecifier": "\\Processor(_Total)\\% Processor Time",
                            "sampleRate": "PT3M",
                            "unit": "percent"
                        }
                    ]
                },
                "WindowsEventLog": {
                    "scheduledTransferPeriod": "PT1M",
                        "DataSource": [
                        {
                            "name": "Application!*[System[(Level=1 or Level=2 or Level=3)]]"
                        }
                    ]
                }
            }
        },
        "StorageAccount": "mystorageaccount",
        "StorageType": "TableAndBlob"
    },
    "PrivateConfig": {
        "storageAccountName": "mystorageaccount",
        "storageAccountKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "storageAccountEndPoint": "https://core.windows.net"
    }
}

Consulte también Use PowerShell para habilitar Azure Diagnostics en una máquina virtual que ejecuta Windows.

Almacenamiento de datos

En la tabla siguiente se enumeran los distintos tipos de datos recopilados por la extensión de diagnósticos y se indica si se almacenan como una tabla o un blob. Los datos almacenados en tablas también se pueden almacenar en blobs en función del valor de StorageType de la configuración pública.

Datos Tipo de almacenamiento Descripción
WADDiagnosticInfrastructureLogsTable Tabla Monitor de diagnóstico y cambios de configuración.
WADDirectoriesTable Tabla Directorios que supervisa el monitor de diagnóstico. Este grupo incluye los registros de IIS, los registros de solicitudes con error de IIS y los directorios personalizados. La ubicación del archivo de registro de blob se especifica en el campo de contenedor y el nombre del blob está en el campo RelativePath. El campo AbsolutePath indica la ubicación y el nombre del archivo tal como existía en la máquina virtual Azure.
WadLogsTable Tabla Registros escritos en código mediante la escucha de seguimiento.
WADPerformanceCountersTable Tabla Contadores de rendimiento.
TablaDeRegistrosDeEventosDeWindows (WAD) Tabla Registros de eventos de Windows.
wad-iis-failedreqlogfiles Blob Contiene información de los registros de solicitudes con error de IIS.
wad-iis-logfiles Blob Contiene información sobre los registros de IIS.
"custom" Blob Un contenedor personalizado basado en la configuración de directorios supervisados por el monitor de diagnóstico. El nombre de este contenedor de blob se especificará en WADDirectoriesTable.

Herramientas para ver los datos de diagnóstico

Existen varias herramientas para ver los datos una vez que se transfieren al almacenamiento. Por ejemplo:

  • Server Explorer en Visual Studio: Si ha instalado las herramientas de Azure para Microsoft Visual Studio, puede usar el nodo Azure Storage en el Explorador de servidores para ver datos de tabla y blobs de solo lectura de las cuentas de Azure Storage. Puede mostrar datos de la cuenta del emulador de almacenamiento local y de las cuentas de almacenamiento que ha creado para Azure. Para más información, consulte Exploración y administración de recursos de almacenamiento con el Explorador de servidores.
  • Microsoft Explorador de Azure Storage: esta aplicación independiente le permite trabajar fácilmente con datos de Azure Storage en Windows, OSX y Linux.
  • Azure Management Studio: esta herramienta incluye Azure Diagnostics Manager. Úselo para ver, descargar y administrar los datos de diagnóstico recopilados por las aplicaciones que se ejecutan en Azure.

Pasos siguientes

Para obtener información sobre cómo reenviar datos de supervisión a Azure Event Hubs, consulte Send data from Azure Diagnostics extension to Event Hubs.

  • Last updated on