Personalización de los temas de correo electrónico de alertas de búsqueda de registros (versión preliminar)

Puede invalidar los temas de correo electrónico de alertas de búsqueda de registros con texto estático, valores dinámicos extraídos de la carga de alerta o una combinación de ambos.

En este artículo, se explica cómo personalizar los asuntos de los correos electrónicos de alertas de búsqueda de registros en Azure Monitor mediante Azure Portal o una plantilla de Azure Resource Manager (plantilla de ARM) para notificaciones personalizadas.

Prerrequisitos

Para crear o editar una regla de alerta, debe tener los permisos siguientes:

• Permiso de lectura en el recurso de destino de la regla de alerta.
• Permiso de escritura en el grupo de recursos en el que se crea la regla de alertas. Si va a crear la regla de alerta desde el portal de Azure, esta se crea de forma predeterminada en el mismo grupo de recursos en el que reside el recurso de destino.
• Permiso de lectura en cualquier grupo de acciones asociado a la regla de alerta, si procediera.

Personalización del asunto del correo electrónico en Azure Portal

1. Cree o edite una regla de alertas de búsqueda de registros.
2. En la pestaña Acciones, después de crear o seleccionar un grupo de acciones existente, use la sección Asunto de correo electrónico para agregar su propio asunto de correo electrónico personalizado.

Uso de valores dinámicos

El formato para extraer un valor dinámico de la carga de alerta es: ${<path to schema field>}, por ejemplo: ${data.essentials.monitorCondition}.

Nota:

Use el formato del esquema de alerta común para especificar el campo en la carga, incluso si los grupos de acciones configurados para la regla de alerta no usan el esquema común. Consulte el esquema de alertas comunes para las alertas de Azure Monitor.

Ejemplos

En este ejemplo se crea un asunto de correo electrónico que contiene el recurso afectado y si se ha desencadenado o resuelto.

• Valor: "Alert ${data.essentials.monitorCondition} on ${data.essentials.alertTargetIDs}"
• Resultados potenciales:
  • Alerta desencadenada en VM1.
  • Alerta resuelta en VM1.

En este ejemplo se crea un asunto de correo electrónico que contiene el recuento de errores en el recurso afectado:

• Valor: "${data.alertContext.condition.allOf[0].metricValue} errors found in ${data.essentials.alertTargetIDs}"
• Resultado: 7 errores encontrados en ContosoApp.

Uso de una plantilla de ARM

Para crear una regla de alerta con un asunto de correo electrónico personalizado, use una plantilla de los ejemplos de plantillas de Resource Manager para alertas de búsqueda de registros. Asegúrese de usar la versión de la API de 2023-12-01 o posterior. Use la plantilla del Ejemplo de plantilla de Resource Manager para reglas de alertas de búsqueda de registros sencillas para reglas de alertas de búsqueda de registros simples. Agregue un actionProperties objeto e incluya la propiedad Email.Subject.

Plantilla de ejemplo

En este ejemplo se muestra una plantilla completa de Resource Manager que crea una regla de alerta de búsqueda de registros con un asunto de correo electrónico personalizado titulado "Este es un asunto de correo electrónico personalizado".

{
  "location": "eastus",
  "properties": {
    "description": "Performance rule",
    "severity": 4,
    "enabled": true,
    "evaluationFrequency": "PT5M",
    "scopes": [
      "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/scopeResourceGroup1/providers/Microsoft.Compute/virtualMachines/vm1"
    ],
    "windowSize": "PT10M",
    "criteria": {
      "allOf": [
        {
          "query": "Perf | where ObjectName == \"Processor\"",
          "timeAggregation": "Average",
          "metricMeasureColumn": "% Processor Time",
          "resourceIdColumn": "resourceId",
          "dimensions": [
            {
              "name": "ComputerIp",
              "operator": "Exclude",
              "values": [
                "192.168.1.1"
              ]
            },
            {
              "name": "OSType",
              "operator": "Include",
              "values": [
                "*"
              ]
            }
          ],
          "operator": "GreaterThan",
          "threshold": 70,
          "failingPeriods": {
            "numberOfEvaluationPeriods": 1,
            "minFailingPeriodsToAlert": 1
          }
        }
      ]
    },
    "muteActionsDuration": "",
    "actions": {
      "actionGroups": [
        "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/scopeResourceGroup1/providers/microsoft.insights/actiongroups/myactiongroup"
      ],
      "customProperties": {
        "key11": "value11",
        "key12": "value12"
      },
     "actionProperties": {
     "Email.Subject": "This is a custom email subject"
     }
    },
    "autoMitigate": true,
    "checkWorkspaceAlertsStorageConfigured": true,
    "skipQueryValidation": true
  }
}