Günlük araması uyarısı e-posta konularını özelleştirme (önizleme)

Günlük arama uyarısı e-posta konularını statik metin, uyarı içeriğinden ayıklanan dinamik değerler veya her ikisinin birleşimi ile geçersiz kılabilirsiniz.

Bu makalede, kişiselleştirilmiş bildirimler için Azure portalını veya Azure Resource Manager şablonunu (ARM şablonu) kullanarak Azure İzleyici'de Günlük araması uyarısı e-posta konularının nasıl özelleştirileceği açıklanmaktadır.

Önkoşullar

Uyarı kuralı oluşturmak veya düzenlemek için aşağıdaki izinlere sahip olmanız gerekir:

• Uyarı kuralına ait hedef kaynağın okunmasına izin verilmesi.
• Uyarı kuralının oluşturulduğu kaynak grubunda yazma yetkisi verilmesi. Uyarı kuralını Azure portalından oluşturuyorsanız, uyarı kuralı varsayılan olarak hedef kaynağın bulunduğu kaynak grubunda oluşturulur.
• Uyarı kuralıyla ilişkili herhangi bir eylem grubu için, varsa, okuma izni.

Azure portalında e-posta konusunu özelleştirme

1. Günlük araması uyarı kuralı oluşturun veya düzenleyin.
2. Eylemler sekmesinde, mevcut bir Eylem grubunu oluşturduktan veya seçtikten sonra, kendi özel e-posta konunuzu eklemek için E-posta konusu bölümünü kullanın.

Dinamik değerleri kullanma

Uyarı yükünden dinamik değer ayıklama biçimi: ${<path to schema field>}, örneğin: ${data.essentials.monitorCondition}.

Uyarı

Uyarı kuralı için yapılandırılmış eylem grupları ortak şemayı kullanmasa bile yükteki alanı belirtmek için ortak uyarı şemasının biçimini kullanın. Azure İzleyici uyarıları için ortak uyarı şemasına bakın.

Örnekler

Bu örnek, etkilenen kaynağın tetiklenip tetiklenmediğini veya çözümlenip çözümlenmediğini belirten bir e-posta konusu oluşturur.

• Değer: "${data.essentials.alertTargetIDs} üzerinde ${data.essentials.monitorCondition} uyarı"
• Olası sonuçlar:
  • VM1'de Uyarı Tetiklenmiş.
  • UYARı VM1'de çözüldü.

Bu örnek, etkilenen kaynakta hata sayısını içeren bir e-posta konusu oluşturur:

• Değer: "${data.alertContext.condition.allOf[0].metricValue} hataları ${data.essentials.alertTargetIDs}" içinde bulundu
• Sonuç: ContosoApp'te 7 hata bulundu.

ARM şablonu kullanma

Özelleştirilmiş bir e-posta konusuyla bir uyarı kuralı oluşturmak için, günlük araması uyarıları için Resource Manager şablon örneklerinden birini kullanın. API sürüm 2023-12-01 veya üzerini kullandığınızdan emin olun. Basit günlük araması uyarı kuralları için Resource Manager şablon örneğindeki şablonu kullanın. Bir actionProperties nesnesi ekleyin ve Email.Subject özelliğini ekleyin.

Örnek şablon

Bu örnek, "Bu, özel bir e-posta konusudur" başlıklı özel bir e-posta konusuyla günlük arama uyarı kuralı oluşturan tam bir Kaynak Yöneticisi şablonunu göstermektedir.

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
            }
        }
    ]
}

Biceps

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
  }
}