Personalizar assuntos de alerta de email para pesquisa de logs

Você pode substituir os assuntos de e-mails de alerta de pesquisa de log por texto estático, valores dinâmicos extraídos do conteúdo do alerta ou uma combinação de ambos.

Este artigo explica como personalizar assuntos de email de alerta de pesquisa de log no Azure Monitor usando o portal do Azure ou um modelo do Azure Resource Manager (modelo ARM) para notificações personalizadas.

Pré-requisitos

Para criar ou editar uma regra de alerta, você deve ter as seguintes permissões:

  • Permissão de leitura no recurso de destino da regra de alerta.
  • Autorização para escrever no grupo de recursos no qual a regra de alerta é criada. Se estiver a criar a regra de alerta a partir do portal do Azure, a regra de alerta é criada por predefinição no mesmo grupo de recursos em que reside o recurso de destino.
  • Permissão de leitura em qualquer grupo de ação associado a qualquer regra de alerta, se aplicável.

Personalizar o assunto do email no portal do Azure

  1. Crie ou edite uma regra de alerta de pesquisa de log.
  2. Na guia Ações , depois de criar ou selecionar um grupo de ações existente, use a seção Assunto do e-mail para adicionar seu próprio assunto de e-mail personalizado.

Captura de ecrã do UI para personalizar o e-mail no portal do Azure.

Usando valores dinâmicos

O formato para extrair um valor dinâmico da carga útil de alerta é: ${<path to schema field>}, por exemplo: ${data.essentials.monitorCondition}.

Observação

Use o formato do esquema de alerta comum para especificar o campo na carga útil, mesmo que os grupos de ação configurados para a regra de alerta não usem o esquema comum. Consulte o Esquema de alerta comum para alertas do Azure Monitor.

Exemplos

Este exemplo cria um assunto de email contendo o recurso afetado e se ele foi acionado ou resolvido.

  • Valor: "Alertar ${data.essentials.monitorCondition} em ${data.essentials.alertTargetIDs}"
  • Resultados potenciais:
    • Alerta foi acionado no VM1.
    • Alerta resolvido no VM1.

Este exemplo cria um assunto de email contendo a contagem de erros no recurso afetado:

  • Valor: "Erros ${data.alertContext.condition.allOf[0].metricValue} encontrados em ${data.essentials.alertTargetIDs}"
  • Resultado: 7 erros encontrados em ContosoApp.

Utilizar um modelo do ARM

Para criar uma regra de alerta com um assunto de email personalizado, use um modelo dos exemplos de modelo do Gerenciador de Recursos para alertas de pesquisa de log. Certifique-se de usar a versão da API 2023-12-01 ou mais recente. Use o modelo do exemplo de modelo do Gerenciador de Recursos para regras de alerta de pesquisa de log simples para regras de alerta de pesquisa de log simples. Adicione um actionProperties objeto e inclua a Email.Subject propriedade.

Modelo de exemplo

Este exemplo mostra um modelo completo do Gestor de Recursos que cria uma regra de alerta de pesquisa de registos com um assunto de email personalizado intitulado "Este é um assunto de email personalizado".

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "type": "Microsoft.Insights/scheduledQueryRules",
            "apiVersion": "2023-12-01",
            "name": "performanceRule",
            "kind": "LogAlert",
            "location": "eastus",
            "properties": {
                "displayName": "Performance rule",
                "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
            }
        }
    ]
}
  • Last updated on