Mengkustomisasi subjek email pemberitahuan pencarian log

Anda dapat mengganti subjek email pemberitahuan pencarian log dengan teks statis, nilai dinamis yang diekstrak dari payload peringatan atau kombinasi keduanya.

Artikel ini menjelaskan cara mengkustomisasi subjek email pemberitahuan pencarian Log di Azure Monitor dengan menggunakan portal Microsoft Azure atau templat Azure Resource Manager (templat ARM) untuk pemberitahuan yang dipersonalisasi.

Prasyarat

Untuk membuat atau mengedit aturan pemberitahuan, Anda harus memiliki izin berikut:

• Hak akses baca pada sumber daya target dari aturan peringatan.
• Izin tulis pada grup sumber daya tempat aturan pemberitahuan dibuat. Jika Anda membuat aturan pemberitahuan dari portal Microsoft Azure, aturan pemberitahuan dibuat secara default dalam grup sumber daya yang sama tempat sumber daya target berada.
• Memiliki izin baca pada grup tindakan yang terkait dengan aturan peringatan, jika berlaku.

Menyesuaikan subjek email di portal Microsoft Azure

1. Membuat atau mengedit aturan pemberitahuan pencarian Log.
2. Pada tab Tindakan , setelah membuat atau memilih grup Tindakan yang sudah ada, gunakan bagian Subjek email untuk menambahkan subjek email kustom Anda sendiri.

Menggunakan nilai dinamis

Format untuk mengekstrak nilai dinamis dari payload pemberitahuan adalah: ${<path to schema field>}, misalnya: ${data.essentials.monitorCondition}.

Nota

Gunakan format skema pemberitahuan umum untuk menentukan bidang dalam payload meskipun grup tindakan yang dikonfigurasi untuk aturan pemberitahuan tidak menggunakan skema umum. Lihat Skema pemberitahuan umum untuk pemberitahuan Azure Monitor.

Contoh

Contoh ini membuat subjek email yang berisi sumber daya yang terpengaruh dan apakah itu diaktifkan atau diselesaikan.

• Nilai: "Pemberitahuan ${data.essentials.monitorCondition} pada ${data.essentials.alertTargetIDs}"
• Hasil potensial:
  • Peringatan Diaktifkan di VM1.
  • Pemberitahuan Diselesaikan pada VM1.

Contoh ini membuat subjek email yang berisi jumlah kesalahan pada sumber daya yang terpengaruh:

• Nilai: "${data.alertContext.condition.allOf[0].metricValue} kesalahan yang ditemukan di ${data.essentials.alertTargetIDs}"
• Hasil: 7 kesalahan ditemukan di ContosoApp.

Gunakan templat ARM

Untuk membuat aturan pemberitahuan dengan subjek email yang dikustomisasi, gunakan templat dari sampel templat Resource Manager untuk pemberitahuan pencarian log. Pastikan untuk menggunakan API versi 2023-12-01 atau yang lebih baru. Gunakan templat dari sampel templat Resource Manager untuk aturan pemberitahuan pencarian log sederhana untuk aturan pemberitahuan pencarian log sederhana. Tambahkan objek actionProperties dan sertakan properti Email.Subject.

Contoh templat

Contoh ini memperlihatkan templat Resource Manager lengkap yang membuat aturan pemberitahuan pencarian Log dengan subjek email kustom berjudul "Ini adalah subjek email kustom".

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

Bisep

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