Naplókeresési riasztások e-mailek tárgyának testreszabása (előzetes verzió)

Felülbírálhatja a naplókeresési riasztási e-mail-témákat statikus szöveggel, a riasztás terhelési adataiból kinyert dinamikus értékekkel, vagy a kombinált használatával.

Ez a cikk bemutatja, hogyan szabhatja testre a naplókeresési riasztások e-mailjeinek témaköreit az Azure Monitorban az Azure Portal vagy egy Azure Resource Manager-sablon (ARM-sablon) használatával személyre szabott értesítésekhez.

Előfeltételek

Riasztási szabály létrehozásához vagy szerkesztéséhez a következő engedélyekkel kell rendelkeznie:

• Olvasási jogosultság a riasztási szabály cél-erőforrásán.
• Az írási engedély arra az erőforráscsoportra vonatkozik, amelyben a riasztási szabály létrejön. Ha az Azure Portalról hozza létre a riasztási szabályt, a riasztási szabály alapértelmezés szerint ugyanabban az erőforráscsoportban jön létre, amelyben a célerőforrás található.
• Olvasási jogosultság bármely, riasztási szabályhoz társított műveletcsoporthoz, amennyiben van ilyen.

E-mail tárgyának testreszabása az Azure Portalon

1. Naplókeresési riasztási szabály létrehozása vagy szerkesztése.
2. A Műveletek lapon, egy meglévő műveletcsoport létrehozása vagy kiválasztása után az E-mail tárgy szakasz használatával adja hozzá saját egyéni e-mail-tárgyát.

Dinamikus értékek használata

A dinamikus értéknek a riasztás hasznos adataiból való kinyerési formátuma a következő: ${<path to schema field>}, például: ${data.essentials.monitorCondition}.

Megjegyzés:

A közös riasztási séma formátumával akkor is megadhatja a hasznos adat mezőjét, ha a riasztási szabályhoz konfigurált műveletcsoportok nem használják a közös sémát. Tekintse meg az Azure Monitor-riasztások gyakori riasztási sémáját.

Példák

Ez a példa létrehoz egy e-mail tárgymezőt, amely tartalmazza az érintett erőforrást, valamint azt, hogy aktiválták vagy megoldódott.

• Érték: "Riasztás ${data.essentials.monitorCondition} a(z) ${data.essentials.alertTargetIDs}"
• Lehetséges eredmények:
  • Riasztás aktiválva a VM1-en.
  • A riasztás feloldva a VM1-en.

Ez a példa létrehoz egy e-mail tárgyat, amely tartalmazza az érintett erőforráson található hibák számát:

• Érték: "${data.alertContext.condition.allOf[0].metricValue} hiba található a${data.essentials.alertTargetIDs} fájlban"
• Eredmény: 7 hiba található a ContosoAppban.

ARM-sablon használata

Ha testre szabott e-mail-tárgyú riasztási szabályt szeretne létrehozni, a Resource Manager-sablonmintákból származó sablonnal naplókeresési riasztásokat készíthet. Mindenképpen használja az API 2023-12-01-es vagy újabb verzióját. Az egyszerű naplókeresési riasztási szabályokhoz használja a Resource Manager sablonmintából származó sablont. Adjon hozzá egy objektumot actionProperties , és foglalja bele a tulajdonságot Email.Subject .

Mintasablon

Ez a példa egy teljes Resource Manager-sablont mutat be, amely létrehoz egy naplókeresési riasztási szabályt az "Ez egy egyéni e-mail tárgy" című egyéni e-mail tárggyal.

ARM (JSON)

{
    "$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
            }
        }
    ]
}

Bicepsz

resource performanceRule 'Microsoft.Insights/scheduledQueryRules@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
  }
}