Creación de configuraciones de diagnóstico en Azure Monitor

Cree y edite las configuraciones de diagnóstico en Azure Monitor para enviar métricas y registros de la plataforma de Azure a distintos destinos, como registros de Azure Monitor, Azure Storage o Azure Event Hubs. Puede usar diferentes métodos para trabajar con las configuraciones de diagnóstico, como Azure Portal, la CLI de Azure, PowerShell y Azure Resource Manager.

Importante

La directiva de retención tal como se establece en la Configuración de diagnóstico está ahora en desuso y ya no se puede usar. Use la directiva de ciclo de vida de Azure Storage para administrar el período de tiempo que se conservan los registros. Para obtener más información, consulte Migración de la retención de almacenamiento de configuración de diagnóstico a la administración del ciclo de vida de Azure Storage.

Azure Portal

Puede realizar configuraciones de diagnóstico en Azure Portal desde el menú de Azure Monitor o desde el menú del recurso.

1. El lugar de Azure Portal en el que se realiza la configuración de diagnóstico depende del recurso:

   • Si se trata de un único recurso, en el menú de dicho recurso, haga clic en la opción Configuración de diagnóstico en Supervisar.

     

   • Si se trata de uno o varios recursos, en el menú de Azure Monitor, haga clic en la opción Configuración de diagnóstico que está en Configuración y después seleccione el recurso.

     

   • Para el registro de actividad, seleccione Registro de actividad en el menú Azure Monitor y, a continuación, seleccione Exportar registros de actividad. No olvide deshabilitar cualquier configuración heredada del registro de actividad. Para obtener instrucciones, consulte Deshabilitar la configuración existente.

     

2. Si no existe ninguna configuración en el recurso que ha seleccionado, se le solicitará que cree una. Seleccione Agregar configuración de diagnóstico.

   

   Si ya hay una configuración en el recurso, verá una lista de opciones que ya están configuradas. Para agregar la nueva configuración, seleccione Agregar configuración de diagnóstico. O bien, seleccione Editar configuración para editar una existente. Cada configuración no puede tener más de uno de los tipos de destino.

   

3. Asigne un nombre a la configuración, si aún no lo tiene.

   

4. Registros y métricas para enrutar: en el caso de los registros, elija un grupo de categorías o seleccione las casillas de verificación individuales de cada categoría de datos que quiera enviar a los destinos que se especifican después. La lista de categorías es diferente en cada servicio de Azure. Seleccione AllMetrics si también quiere almacenar métricas en registros de Azure Monitor.

5. Detalles de destino: seleccione la casilla de verificación para cada destino. Aparecerán más opciones para que pueda agregar más información.

   

   1. Enviar al área de trabajo de Log Analytics: seleccione la suscripción y el área de trabajo de Log Analytics donde quiera enviar los datos. Si no tiene una área de trabajo, deberá crear una antes de continuar.

   2. Archivar en una cuenta de almacenamiento: Seleccione la Suscripción y la cuenta de almacenamiento en la que desea almacenar los datos.

      

      Sugerencia

      Use la directiva de ciclo de vida de Azure Storage para administrar el período de tiempo que se conservan los registros. La directiva de retención tal como se establece en los ajustes de configuración de diagnóstico ahora está en desuso.

   3. Transmitir a un centro de eventos: especifique los criterios siguientes:

      • Suscripción: suscripción de la que forma parte el centro de eventos.
      • Espacio de nombres del centro de eventos: si no tiene uno, debe crear uno.
      • El nombre del centro de eventos (opcional): nombre al que se van a enviar todos los datos. Si no especifica un nombre, se crea un centro de eventos para cada categoría de registro. Si va a enviar varias categorías, puede especificar un nombre para limitar el número de centros de eventos creados. Para obtener más información, consulte Cuotas y límites de Azure Event Hubs.
      • La directiva del centro de eventos (también opcional): una directiva que defina los permisos que tiene el mecanismo de transmisión. Para obtener más información, consulte este artículo sobre las características de Event Hubs.

   4. Enviar a la solución de asociados: primero debe instalar los Servicios de ISV nativos de Azure en su suscripción. Las opciones de configuración variarán según el asociado. Para más información, vea Introducción a los servicios ISV nativos de Azure.

6. Si el servicio admite el modo resource-specific y diagnóstico de Azure, una opción para seleccionar la tabla de destino se muestra cuando selecciona Área de trabajo de Log Analytics como destino. Normalmente deberá seleccionar Específico del recurso ya que la estructura de tablas permite más flexibilidad y consultas más eficientes.

   

7. Seleccione Guardar.

Poco después, la nueva configuración aparecerá en la lista de valores para este recurso. Los registros se transmiten a los destinos especificados a medida que se generan nuevos datos de eventos. Es posible que pasen hasta 15 minutos desde que se emite un evento hasta que aparece en un área de trabajo de Log Analytics.

PowerShell

Use el cmdlet New-AzDiagnosticSetting para crear una configuración de diagnóstico con Azure PowerShell. Consulte la documentación de este cmdlet para las descripciones de sus parámetros.

Importante

Este método no se puede usar para un registro de actividad. En su lugar, siga las indicaciones de Creación de la configuración de diagnóstico en Azure Monitor con una plantilla de Azure Resource Manager para crear una plantilla de Resource Manager e implementarla con PowerShell.

El siguiente cmdlet de PowerShell de ejemplo crea una configuración de diagnóstico para todos los registros (o los registros de auditoría) y métricas para un almacén de claves usando el área de trabajo de Log Analytics.

$KV = Get-AzKeyVault -ResourceGroupName <resource group name> -VaultName <key vault name>
$Law = Get-AzOperationalInsightsWorkspace -ResourceGroupName <resource group name> -Name <workspace name>  # LAW name is case sensitive

$metric = New-AzDiagnosticSettingMetricSettingsObject -Enabled $true -Category AllMetrics
# For all available logs, use:
$log = New-AzDiagnosticSettingLogSettingsObject -Enabled $true -CategoryGroup allLogs  
# or, for audit logs, use:
$log = New-AzDiagnosticSettingLogSettingsObject -Enabled $true -CategoryGroup audit    
New-AzDiagnosticSetting -Name 'KeyVault-Diagnostics' -ResourceId $KV.ResourceId -WorkspaceId $Law.ResourceId -Log $log -Metric $metric -Verbose

CLI

Use el comando az monitor diagnostic-settings create para crear una configuración de diagnóstico con la CLI de Azure. Consulte la documentación de este comando para las descripciones de sus parámetros.

Importante

Este método no se puede usar para un registro de actividad. En su lugar, siga las indicaciones de Creación de la configuración de diagnóstico en Azure Monitor con una plantilla de Resource Manager para crear una plantilla de Resource Manager e implementarla con la CLI de Azure.

El ejemplo siguiente muestra un comando para crear una configuración de diagnóstico con los tres destinos. La sintaxis es ligeramente diferente según el cliente.

Para especificar el modo específico del recurso si el servicio lo admite, agregue el parámetro export-to-resource-specific con un valor de true.

az monitor diagnostic-settings create  \
--name KeyVault-Diagnostics \
--resource /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.KeyVault/vaults/mykeyvault \
--logs    '[{"category": "AuditEvent","enabled": true}]' \
--metrics '[{"category": "AllMetrics","enabled": true}]' \
--storage-account /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.Storage/storageAccounts/<storage account name> \
--workspace /subscriptions/<subscription ID>/resourcegroups/<resource group name>/providers/microsoft.operationalinsights/workspaces/<log analytics workspace name> \
--event-hub-rule /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.EventHub/namespaces/<event hub namespace>/authorizationrules/RootManageSharedAccessKey \
--event-hub <event hub name> \
--export-to-resource-specific true

Resource Manager

La siguiente plantilla JSON proporciona un ejemplo para crear una configuración de diagnóstico para enviar todos los registros de auditoría a un área de trabajo de Log Analytics. Tenga en cuenta que la apiVersion puede cambiar en función del recurso del ámbito.

Archivo de plantilla

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "scope": {
        "type": "string"
    },
    "workspaceId": {
        "type": "string"
    },
    "settingName": {
        "type": "string"
    }
},
  "resources": [
    {
      "type": "Microsoft.Insights/diagnosticSettings",
      "apiVersion": "2021-05-01-preview",
      "scope": "[parameters('scope')]",
      "name": "[parameters('settingName')]",
      "properties": {
       "workspaceId": "[parameters('workspaceId')]",
      "logs": [
             {
            "category": null,
            "categoryGroup": "audit",
            "enabled": true
          }
        ]
      }
    }
  ]
  }

Archivo de parámetros

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "settingName": {
        "value": "audit3"
    },
    "workspaceId": {
      "value": "/subscriptions/<subscription id>/resourcegroups/<resourcegroup name>/providers/microsoft.operationalinsights/workspaces/<workspace name>"
    },
    "scope": {
      "value": "Microsoft.<resource type>/<resourceName>"
    }
  }
}

REST API

Consulte Configuración de diagnóstico para crear o actualizar configuraciones de diagnóstico mediante la API de REST de Azure Monitor.

Azure Policy

Consulte Creación de una configuración de diagnóstico a escala mediante Azure Policy para obtener detalles sobre el uso de Azure Policy para crear una configuración de diagnóstico a escala.

Solución de problemas

Estas son algunas sugerencias de solución de problemas.

La categoría de métrica no es compatible

Si implementa una configuración de diagnóstico, recibirá un mensaje de error similar a "No se admite la categoría de métrica xxxx". Es posible que reciba este error a pesar de que la implementación anterior se haya realizado correctamente.

El problema se produce cuando se usa una plantilla de Resource Manager, la API de REST, la CLI de Azure o Azure PowerShell. La configuración de diagnóstico que se ha creado a través de Azure Portal no se ve afectada, ya que solo se presentan los nombres de categoría admitidos.

El problema se debe a un cambio reciente en la API subyacente. Las categorías de métricas que no sean AllMetrics no se admiten y nunca se han admitido, salvo para unos servicios específicos de Azure. En el pasado, se omitieron otros nombres de categoría al implementar una configuración de diagnóstico. El back-end de Azure Monitor redirigió estas categorías a AllMetrics. A partir de febrero de 2021, el back-end se actualizó específicamente para confirmar que la categoría de métrica proporcionada es precisa. Este cambio puede provocar un error en algunas implementaciones.

Si recibe este error, actualice las implementaciones para reemplazar los nombres de categoría de métrica por AllMetrics para corregir el problema. En el supuesto de que la implementación agregara antes varias categorías, solo debe conservarse una con la referencia AllMetrics. Si sigue teniendo el problema, póngase en contacto con el equipo de soporte técnico de Azure a través de Azure Portal.

La configuración desaparece debido a caracteres que no son ASCII en resourceID

La configuración de diagnóstico no admite identificadores de recursos con caracteres que no sean ASCII. Por ejemplo, considere el término "Preproducción". Puesto que no puede cambiar el nombre de los recursos en Azure, la única opción es crear un recurso sin caracteres que no sean ASCII. Si los caracteres están en un grupo de recursos, puede mover los recursos que contiene a uno nuevo. De lo contrario, debe volver a crear el recurso.

Posibilidad de datos duplicados o eliminados

Se realizan todos los esfuerzos para garantizar que todos los datos de registro se envían correctamente a sus destinos; sin embargo, no es posible garantizar la transferencia de datos del 100 % de los registros entre puntos de conexión. Los reintentos y otros mecanismos están implementados para solucionar estos problemas e intentar asegurarse de que los datos de registro llegan al punto de conexión.

Recursos inactivos

Cuando un recurso está inactivo y se exportan métricas de valor cero, el mecanismo de exportación de configuración de diagnóstico se desactiva incrementalmente para evitar costos innecesarios de exportación y almacenamiento de cero valores. El retroceso puede provocar un retraso en la exportación del siguiente valor distinto de cero.

Cuando un recurso está inactivo durante una hora, el mecanismo de exportación tiene un retroceso de 15 minutos. Esto significa que hay una latencia potencial de hasta 15 minutos para que se exporte el siguiente valor distinto de cero. El tiempo máximo de retroceso de dos horas se alcanza después de siete días de inactividad. Una vez que el recurso comienza a exportar valores distintos de cero, el mecanismo de exportación vuelve a la latencia de exportación original de tres minutos.

Este comportamiento solo se aplica a las métricas exportadas y no afecta a las alertas basadas en métricas ni escalabilidad automática.

Pasos siguientes

• Revise cómo trabajar con la configuración de diagnóstico en Azure Monitor
• Migración de la retención de almacenamiento de configuración de diagnóstico a la administración del ciclo de vida de Azure Storage
• Más información sobre los registros de plataforma de Azure