Vanligt aviseringsschema

Det gemensamma aviseringsschemat standardiserar förbrukningen av Azure Monitor-aviseringsmeddelanden. Tidigare hade aktivitetsloggar, mått- och loggsökningsaviseringar sina egna e-postmallar och webhook-scheman. Det gemensamma aviseringsschemat innehåller ett standardiserat schema för alla aviseringsmeddelanden.

Genom att använda ett standardiserat schema kan du minimera antalet integreringar, vilket förenklar processen för att hantera och underhålla dina integreringar. Det gemensamma schemat möjliggör en rikare varningshantering i både Azure-portalen och Azure-mobilappen.

Det gemensamma aviseringsschemat ger en konsekvent struktur för:

E-postmallar: Använd den detaljerade e-postmallen för att snabbt diagnostisera problem. Inbäddade länkar till aviseringsinstansen i portalen och till den berörda resursen säkerställer att du snabbt kan hoppa in i reparationsprocessen.
JSON-struktur: Använd den konsekventa JSON-strukturen för att skapa integreringar för alla aviseringstyper med hjälp av:
- Azure Logic-appar
- Azure-funktioner
- Azure Automation-runbook

Anmärkning

Aviseringar som genereras av VM-insikter stöder inte det gemensamma schemat.
Aviseringar för smart identifiering använder det gemensamma schemat som standard. Du behöver inte aktivera det allmänna schemat för smarta detekteringar.

Struktur för det gemensamma schemat

Det vanliga schemat innehåller information om den berörda resursen och orsaken till aviseringen i följande avsnitt:

Essentials: Standardiserade fält som används av alla aviseringstyper som beskriver resursen som påverkas av aviseringen och vanliga aviseringsmetadata, till exempel allvarlighetsgrad eller beskrivning.

Om du vill dirigera aviseringsinstanser till specifika team baserat på kriterier, till exempel en resursgrupp, kan du använda fälten i avsnittet Essentials för att tillhandahålla routningslogik för alla aviseringstyper . De team som tar emot aviseringsmeddelandet kan sedan använda kontextfälten för sin undersökning.
Aviseringskontext: Fält som varierar beroende på typen av avisering. Fälten för aviseringskontexten beskriver orsaken till aviseringen. En måttavisering skulle till exempel ha fält som måttnamnet och måttvärdet i aviseringskontexten. En aktivitetsloggavisering skulle ha information om händelsen som genererade aviseringen.
Anpassade egenskaper: Ytterligare information som inte ingår i aviseringsnyttolasten som standard kan inkluderas i aviseringsnyttolasten med hjälp av anpassade egenskaper. Anpassade egenskaper är ett Nyckel:Värde-par som kan innehålla all information som konfigurerats i aviseringsregeln.

Exempel på meddelandenyttolast

{
  "schemaId": "azureMonitorCommonAlertSchema",
  "data": {
    "essentials": {
      "alertId": "/subscriptions/<subscription ID>/providers/Microsoft.AlertsManagement/alerts/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
      "alertRule": "WCUS-R2-Gen2",
      "alertRuleId": "/subscriptions/<subscription ID>/resourceGroups/<resource-group>/providers/microsoft.insights/metricAlerts/WCUS-R2-Gen2",
      "severity": "Sev3",
      "signalType": "Metric",
      "monitorCondition": "Resolved",
      "monitoringService": "Platform",
      "alertTargetIDs": [
        "/subscriptions/<subscription ID>/resourcegroups/pipelinealertrg/providers/microsoft.compute/virtualmachines/wcus-r2-gen2"
      ],
      "configurationItems": [
        "wcus-r2-gen2"
      ],
      "originAlertId": "3f2d4487-b0fc-4125-8bd5-7ad17384221e_PipeLineAlertRG_microsoft.insights_metricAlerts_WCUS-R2-Gen2_-117781227",
      "firedDateTime": "2019-03-22T13:58:24.3713213Z",
      "resolvedDateTime": "2019-03-22T14:03:16.2246313Z",
      "description": "",
      "essentialsVersion": "1.0",
      "alertContextVersion": "1.0"
    },
    "alertContext": {
      "properties": null,
      "conditionType": "SingleResourceMultipleMetricCriteria",
      "condition": {
        "windowSize": "PT5M",
        "allOf": [
          {
            "metricName": "Percentage CPU",
            "metricNamespace": "Microsoft.Compute/virtualMachines",
            "operator": "GreaterThan",
            "threshold": "25",
            "timeAggregation": "Average",
            "dimensions": [
              {
                "name": "ResourceId",
                "value": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1"
              }
            ],
            "metricValue": 7.727
          }
        ]
      }
    },
    "customProperties": {
      "Key1": "Value1",
      "Key2": "Value2"
    }
  }
}

Anmärkning

Fältet alertRuleId kanske inte visas i alla aviseringsnyttolaster. Den ingår endast i vissa aviseringstyper eller API-versioner som stöder returnering av aviseringsregelns fullständiga resurs-ID.

Exempelaviseringar som använder det gemensamma schemat finns i Exempel på aviseringsnyttolaster.

Viktiga fält

Fält	beskrivning
alertContextVersion	Versionsnumret för `alertContext` avsnittet.
alertId	Det unika resurs-ID som identifierar aviseringsinstansen.
varningsregel	Namnet på aviseringsregeln som genererade aviseringsinstansen.
larmregel-ID	ID för varningsregeln som genererade varningsinstansen.
varningsmål-ID	Listan över Azure Resource Manager-ID:n som är påverkade mål av en varning. För en loggsökningsavisering som definierats på en arbetsyta för Log Analytics eller en instans av Application Insights är det den respektive arbetsytan eller applikationen.
konfigurationselement	Listan över berörda resurser i en avisering. I vissa fall kan konfigurationsobjekten skilja sig från aviseringsmålen. I exempelvis mätvärdes- eller loggsökningsaviseringar som definierats på en Log Analytics-arbetsyta, är konfigurationsobjekten de faktiska resurserna som skickar data och inte själva arbetsytan. I API:et för loggsökningsaviseringar (schemalagda frågeregler) v2021-08-01 `configurationItem` hämtas värdena från uttryckligen definierade dimensioner i den här prioriteten: `_ResourceId`, `ResourceId`, `Resource`, `Computer`. I tidigare versioner av loggsökningsaviseringarnas API hämtas värdena implicit från resultaten enligt följande prioriteringsordning: `configurationItem`, `_ResourceId`, `ResourceId`, `Resource`. I ITSM-system används fältet `configurationItems` för att korrelera aviseringar till resurser i en konfigurationshanteringsdatabas.
beskrivning	Beskrivningen enligt definitionen i aviseringsregeln.
grundversion	Versionsnumret för avsnittet grundläggande.
utlösningsDatumTid	Datum och tid då aviseringsinstansen utlöstes i Coordinated Universal Time (UTC).
investigationLink	Länk för att undersöka aviseringen i Azure Monitor. För närvarande krävs begränsad förhandsversionsregistrering.
övervakaTillstånd	När en avisering utlöses är aviseringens övervakningstillstånd inställt på Utlöst. När det underliggande villkoret som gjorde att aviseringen utlöstes rensas, är övervakningsvillkoret inställt på Löst.
övervakningstjänst	Övervakningstjänsten eller lösningen som genererade aviseringen. Övervakningstjänsten avgör vilka fält som finns i aviseringskontexten.
ursprungsvarnings-ID	ID:t för aviseringsinstansen, som genereras av övervakningstjänsten som genererar den.
resolvedDateTime	Datum och tid då övervakningsvillkoret för aviseringsinstansen är inställt på Löst i UTC. Gäller för närvarande endast för metriska aviseringar.
targetResourceGroup	Namnet på resursgruppen för den berörda resursen.
targetResourceType	Resurstypen som påverkas av aviseringen.
Allvarlighet	Allvarlighetsgraden för aviseringen. Möjliga värden är Sev0, Sev1, Sev2, Sev3 eller Sev4.
signaltyp	Identifierar den signal som aviseringsregeln definierades på. Möjliga värden är mått, logg eller aktivitetslogg.

Kontextfält för måttaviseringar

Fält	beskrivning
varningskänslighet	I en aviseringsregel med ett dynamiskt tröskelvärde anger du hur känslig regeln är eller hur mycket värdet kan avvika från det övre eller nedre tröskelvärdet.
allOf	Anger att alla villkor som definierats i aviseringsregeln måste uppfyllas för att utlösa en avisering.
tillstånd
villkorstyp	Den typ av villkor som valts för aviseringsregeln: statiskt tröskelvärde dynamiskt tröskelvärde webtest
dimensioner	Måttdimensionen som utlöste aviseringen.
misslyckade perioder	I en aviseringsregel med ett dynamiskt tröskelvärde är antalet utvärderingsperioder som inte uppfyller aviseringströskelvärdet som utlöser en avisering. Du kan till exempel ange att en avisering utlöses när 3 av de senaste fem utvärderingsperioderna inte ligger inom tröskelvärdena för aviseringar.
ignoreDataBefore	(Valfritt.) I en aviseringsregel med ett dynamiskt tröskelvärde anges datumet från vilket tröskelvärdet beräknas. Använd det här värdet för att ange att regeln inte ska beräkna det dynamiska tröskelvärdet med data från före det angivna datumet.
metrikNamn	Namnet på mätvärdet som övervakas av larmregeln.
metricNamespace (mätvärdesnamnrymd)	Namnområdet för metrik som övervakas av varningsregeln.
metricValue	Måttvärdet vid den tidpunkt då tröskelvärdet överträddes.
minimalt antal misslyckade perioder för att varna	Det minsta antalet utvärderingar som inte uppfyller aviseringsregelvillkoren.
namn	Namn på dimensionen.
antalvärderingsperioder	Det totala antalet utvärderingar.
operatör	Den logiska operatorn för aviseringsregeln.
egenskaper	(Valfritt.) En samling kunddefinierade egenskaper.
tröskelvärde	Tröskelvärdet som definieras i aviseringsregeln. För en aviseringsregel med ett dynamiskt tröskelvärde är det här värdet det beräknade tröskelvärdet.
tidsaggregering	Aviseringsregelns sammansättningstyp.
värde	Dimensionens värde.
webTestName	Om villkorstypen är `webtest`, namnet på webbtestet.
fönsterSlutTid	Sluttiden för utvärderingsfönstret där alerten utlöstes.
fönsterstorlek	Tidsperioden som analyseras av aviseringsregeln.
fönsterStartTid	Starttiden för utvärderingsfönstret där aviseringen utlöstes.

Exempel på måttavisering med ett statiskt tröskelvärde när monitoringService = `Platform`

{
  "alertContext": {
      "properties": null,
      "conditionType": "SingleResourceMultipleMetricCriteria",
      "condition": {
        "windowSize": "PT5M",
        "allOf": [
          {
            "metricName": "Percentage CPU",
            "metricNamespace": "Microsoft.Compute/virtualMachines",
            "operator": "GreaterThan",
            "threshold": "25",
            "timeAggregation": "Average",
            "dimensions": [
              {
                "name": "ResourceId",
                "value": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1"
              }
            ],
            "metricValue": 31.1105
          }
        ],
        "windowStartTime": "2019-03-22T13:40:03.064Z",
        "windowEndTime": "2019-03-22T13:45:03.064Z"
      }
    }
}

Exempel på måttavisering med ett dynamiskt tröskelvärde när monitoringService = `Platform`

{
  "alertContext": {
      "properties": null,
      "conditionType": "DynamicThresholdCriteria",
      "condition": {
        "windowSize": "PT5M",
        "allOf": [
          {
            "alertSensitivity": "High",
            "failingPeriods": {
              "numberOfEvaluationPeriods": 1,
              "minFailingPeriodsToAlert": 1
            },
            "ignoreDataBefore": null,
            "metricName": "Egress",
            "metricNamespace": "microsoft.storage/storageaccounts",
            "operator": "GreaterThan",
            "threshold": "47658",
            "timeAggregation": "Total",
            "dimensions": [],
            "metricValue": 50101
          }
        ],
        "windowStartTime": "2021-07-20T05:07:26.363Z",
        "windowEndTime": "2021-07-20T05:12:26.363Z"
      }
    }
}

Exempel på måttavisering för tillgänglighetstester när monitoringService = `Platform`

{
  "alertContext": {
      "properties": null,
      "conditionType": "WebtestLocationAvailabilityCriteria",
      "condition": {
        "windowSize": "PT5M",
        "allOf": [
          {
            "metricName": "Failed Location",
            "metricNamespace": null,
            "operator": "GreaterThan",
            "threshold": "2",
            "timeAggregation": "Sum",
            "dimensions": [],
            "metricValue": 5,
            "webTestName": "myAvailabilityTest-myApplication"
          }
        ],
        "windowStartTime": "2019-03-22T13:40:03.064Z",
        "windowEndTime": "2019-03-22T13:45:03.064Z"
      }
    }
}

Kontextfält för loggsökningsaviseringar

Anmärkning

När du aktiverar det gemensamma schemat återställs fälten i nyttolasten till de vanliga schemafälten. Därför har loggsökningsaviseringar dessa begränsningar för det gemensamma schemat:

Det gemensamma schemat stöds inte för loggsökningsaviseringar med webhooks med ett anpassat e-postämne och/eller JSON-nyttolast, eftersom det gemensamma schemat skriver över de anpassade konfigurationerna.
Aviseringar som använder det gemensamma schemat har en övre storleksgräns på 256 KB per avisering. Om nyttolasten för loggsökningsaviseringar innehåller sökresultat som gör att aviseringen överskrider den maximala storleken bäddas sökresultaten inte in i nyttolasten för loggsökningsaviseringar. Du kan kontrollera om IncludedSearchResults nyttolasten innehåller sökresultaten med flaggan. Använd LinkToFilteredSearchResultsAPI eller LinkToSearchResultsAPI för att komma åt frågeresultat med Log Analytics-API :et om sökresultaten inte ingår.

Fält	beskrivning
Varningstyp	Aviseringstypen: – Måttmätning - Antal resultat
ApplicationID	Application Insights-ID:t som aviseringen utlöstes på.
kolumner	Kolumnerna i tabellen.
Datakällor	De datakällor som aviseringen utlöstes på.
Dimensioner	För regler för metriska mätningar, de metriska dimensioner som varningen utlösts av.
InkluderadeSökresultat	Flagga som anger om nyttolasten ska innehålla resultatet.
LänkTillFiltreradeSökresultatAPI	För måttmätningsregler länkar du till sökresultaten med log analytics-API:et efter att de har filtrerats av dimensionskombinationerna.
LänkTillFiltreradeSöksresultatUI	För metriska mätregler är länken till sökresultaten efter att de har filtrerats efter dimensionskombinationerna.
LänkTillSökresultat	En länk till sökresultaten.
LänkTillSökresultatAPI	En länk till frågeresultatet med hjälp av Log Analytics-API:et.
namn	Namn på dimensionen.
namn	Namnet på tabellen i sökresultatet.
namn	Kolumnens namn.
Operatör	Operatorn som definierats i aviseringsregeln.
resursID	Resurs-ID:t som påverkas av aviseringen.
Antal resultat	Antalet poster som returneras av sökfrågan. För måttmätningsregler, talet eller posterna som matchar den specifika dimensionskombinationen.
rader	Raderna i tabellen.
SökintervallensVaraktighetMin	Det totala antalet minuter i sökintervallet.
SökningsintervallSluttidUtc	Sluttiden för utvärderingsfönstret i vilket varningen utlöstes i UTC.
SearchIntervalInMin	Det totala antalet minuter i sökintervallet.
SökintervallStartTidUtc	Starttiden för utvärderingsfönstret där varningen gavs i UTC.
Sökfråga	Frågan som definierats i aviseringsregeln.
Sökresultat	De fullständiga sökresultaten.
bord/tabell	Resultattabellen i sökresultaten.
tabeller	Utkastsvarstabellerna som ingår i frågan.
Tröskel	Tröskelvärdet som definieras i aviseringsregeln.
typ	Typen av kolumn.
värde	Dimensionens värde.

Exempelloggsökningsavisering när monitoringService = Log Analytics

{
  "alertContext": {
    "SearchQuery": "Perf | where ObjectName == \"Processor\" and CounterName == \"% Processor Time\" | summarize AggregatedValue = avg(CounterValue) by bin(TimeGenerated, 5m), Computer",
    "SearchIntervalStartTimeUtc": "3/22/2019 1:36:31 PM",
    "SearchIntervalEndtimeUtc": "3/22/2019 1:51:31 PM",
    "ResultCount": 2,
    "LinkToSearchResults": "https://portal.azure.com/#Analyticsblade/search/index?_timeInterval.intervalEnd=2018-03-26T09%3a10%3a40.0000000Z&_timeInterval.intervalDuration=3600&q=Usage",
    "LinkToFilteredSearchResultsUI": "https://portal.azure.com/#Analyticsblade/search/index?_timeInterval.intervalEnd=2018-03-26T09%3a10%3a40.0000000Z&_timeInterval.intervalDuration=3600&q=Usage",
    "LinkToSearchResultsAPI": "https://api.loganalytics.io/v1/workspaces/workspaceID/query?query=Heartbeat&timespan=2020-05-07T18%3a11%3a51.0000000Z%2f2020-05-07T18%3a16%3a51.0000000Z",
    "LinkToFilteredSearchResultsAPI": "https://api.loganalytics.io/v1/workspaces/workspaceID/query?query=Heartbeat&timespan=2020-05-07T18%3a11%3a51.0000000Z%2f2020-05-07T18%3a16%3a51.0000000Z",
    "SeverityDescription": "Warning",
    "WorkspaceId": "12345a-1234b-123c-123d-12345678e",
    "SearchIntervalDurationMin": "15",
    "AffectedConfigurationItems": [
      "INC-Gen2Alert"
    ],
    "SearchIntervalInMinutes": "15",
    "Threshold": 10000,
    "Operator": "Less Than",
    "Dimensions": [
      {
        "name": "Computer",
        "value": "INC-Gen2Alert"
      }
    ],
    "SearchResults": {
      "tables": [
        {
          "name": "PrimaryResult",
          "columns": [
            {
              "name": "$table",
              "type": "string"
            },
            {
              "name": "Computer",
              "type": "string"
            },
            {
              "name": "TimeGenerated",
              "type": "datetime"
            }
          ],
          "rows": [
            [
              "Fabrikam",
              "33446677a",
              "2018-02-02T15:03:12.18Z"
            ],
            [
              "Contoso",
              "33445566b",
              "2018-02-02T15:16:53.932Z"
            ]
          ]
        }
      ],
      "dataSources": [
        {
          "resourceId": "/subscriptions/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f/resourcegroups/test/providers/microsoft.operationalinsights/workspaces/test",
          "tables": [
            "Heartbeat"
          ]
        }
      ]
    },
    "IncludedSearchResults": "True",
    "AlertType": "Metric measurement"
  }
}

Exempelloggsökningsavisering när övervakningstjänsten är Application Insights

{
  "alertContext": {
    "SearchQuery": "requests | where resultCode == \"500\" | summarize AggregatedValue = Count by bin(Timestamp, 5m), IP",
    "SearchIntervalStartTimeUtc": "3/22/2019 1:36:33 PM",
    "SearchIntervalEndtimeUtc": "3/22/2019 1:51:33 PM",
    "ResultCount": 2,
    "LinkToSearchResults": "https://portal.azure.com/AnalyticsBlade/subscriptions/12345a-1234b-123c-123d-12345678e/?query=search+*+&timeInterval.intervalEnd=2018-03-26T09%3a10%3a40.0000000Z&_timeInterval.intervalDuration=3600&q=Usage",
    "LinkToFilteredSearchResultsUI": "https://portal.azure.com/AnalyticsBlade/subscriptions/12345a-1234b-123c-123d-12345678e/?query=search+*+&timeInterval.intervalEnd=2018-03-26T09%3a10%3a40.0000000Z&_timeInterval.intervalDuration=3600&q=Usage",
    "LinkToSearchResultsAPI": "https://api.applicationinsights.io/v1/apps/0MyAppId0/metrics/requests/count",
    "LinkToFilteredSearchResultsAPI": "https://api.applicationinsights.io/v1/apps/0MyAppId0/metrics/requests/count",
    "SearchIntervalDurationMin": "15",
    "SearchIntervalInMinutes": "15",
    "Threshold": 10000.0,
    "Operator": "Less Than",
    "ApplicationId": "00001111-aaaa-2222-bbbb-3333cccc4444",
    "Dimensions": [
      {
        "name": "IP",
        "value": "1.1.1.1"
      }
    ],
    "SearchResults": {
      "tables": [
        {
          "name": "PrimaryResult",
          "columns": [
            {
              "name": "$table",
              "type": "string"
            },
            {
              "name": "Id",
              "type": "string"
            },
            {
              "name": "Timestamp",
              "type": "datetime"
            }
          ],
          "rows": [
            [
              "Fabrikam",
              "33446677a",
              "2018-02-02T15:03:12.18Z"
            ],
            [
              "Contoso",
              "33445566b",
              "2018-02-02T15:16:53.932Z"
            ]
          ]
        }
      ],
      "dataSources": [
        {
          "resourceId": "/subscriptions/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a/resourcegroups/test/providers/microsoft.operationalinsights/workspaces/test",
          "tables": [
            "Heartbeat"
          ]
        }
      ]
    },
    "IncludedSearchResults": "True",
    "AlertType": "Metric measurement"
  }
}

Exempel på loggsökningsavisering när monitoringService = Log Alerts V2

Anmärkning

Aviseringsregler för loggsökning från API-version 2020-05-01 använder den här typen av nyttolast, som bara stöder ett vanligt schema. Sökresultaten är inte inbäddade i nyttolasten för loggsökningsaviseringar när du använder den här versionen. Använd dimensioner för att ge kontext till utlösta aviseringar. Du kan också använda LinkToFilteredSearchResultsAPI eller LinkToSearchResultsAPI för att komma åt frågeresultat med Log Analytics-API:et. Om du måste bädda in resultatet använder du en logikapp med de angivna länkarna för att generera en anpassad nyttolast.

{
  "alertContext": {
    "properties": {
      "name1": "value1",
      "name2": "value2"
    },
    "conditionType": "LogQueryCriteria",
    "condition": {
      "windowSize": "PT10M",
      "allOf": [
        {
          "searchQuery": "Heartbeat",
          "metricMeasureColumn": "CounterValue",
          "targetResourceTypes": "['Microsoft.Compute/virtualMachines']",
          "operator": "LowerThan",
          "threshold": "1",
          "timeAggregation": "Count",
          "dimensions": [
            {
              "name": "Computer",
              "value": "TestComputer"
            }
          ],
          "metricValue": 0.0,
          "failingPeriods": {
            "numberOfEvaluationPeriods": 1,
            "minFailingPeriodsToAlert": 1
          },
          "linkToSearchResultsUI": "https://portal.azure.com#@12345a-1234b-123c-123d-12345678e/blade/Microsoft_Azure_Monitoring_Logs/LogsBlade/source/Alerts.EmailLinks/scope/%7B%22resources%22%3A%5B%7B%22resourceId%22%3A%22%2Fsubscriptions%212345a-1234b-123c-123d-12345678e%2FresourceGroups%2FContoso%2Fproviders%2FMicrosoft.Compute%2FvirtualMachines%2FContoso%22%7D%5D%7D/q/eJzzSE0sKklKTSypUSjPSC1KVQjJzE11T81LLUosSU1RSEotKU9NzdNIAfJKgDIaRgZGBroG5roGliGGxlYmJlbGJnoGEKCpp4dDmSmKMk0A/prettify/1/timespan/2020-07-07T13%3a54%3a34.0000000Z%2f2020-07-09T13%3a54%3a34.0000000Z",
          "linkToFilteredSearchResultsUI": "https://portal.azure.com#@12345a-1234b-123c-123d-12345678e/blade/Microsoft_Azure_Monitoring_Logs/LogsBlade/source/Alerts.EmailLinks/scope/%7B%22resources%22%3A%5B%7B%22resourceId%22%3A%22%2Fsubscriptions%212345a-1234b-123c-123d-12345678e%2FresourceGroups%2FContoso%2Fproviders%2FMicrosoft.Compute%2FvirtualMachines%2FContoso%22%7D%5D%7D/q/eJzzSE0sKklKTSypUSjPSC1KVQjJzE11T81LLUosSU1RSEotKU9NzdNIAfJKgDIaRgZGBroG5roGliGGxlYmJlbGJnoGEKCpp4dDmSmKMk0A/prettify/1/timespan/2020-07-07T13%3a54%3a34.0000000Z%2f2020-07-09T13%3a54%3a34.0000000Z",
          "linkToSearchResultsAPI": "https://api.loganalytics.io/v1/subscriptions/12345a-1234b-123c-123d-12345678e/resourceGroups/Contoso/providers/Microsoft.Compute/virtualMachines/Contoso/query?query=Heartbeat%7C%20where%20TimeGenerated%20between%28datetime%282020-07-09T13%3A44%3A34.0000000%29..datetime%282020-07-09T13%3A54%3A34.0000000%29%29&timespan=2020-07-07T13%3a54%3a34.0000000Z%2f2020-07-09T13%3a54%3a34.0000000Z",
          "linkToFilteredSearchResultsAPI": "https://api.loganalytics.io/v1/subscriptions/12345a-1234b-123c-123d-12345678e/resourceGroups/Contoso/providers/Microsoft.Compute/virtualMachines/Contoso/query?query=Heartbeat%7C%20where%20TimeGenerated%20between%28datetime%282020-07-09T13%3A44%3A34.0000000%29..datetime%282020-07-09T13%3A54%3A34.0000000%29%29&timespan=2020-07-07T13%3a54%3a34.0000000Z%2f2020-07-09T13%3a54%3a34.0000000Z"
        }
      ],
      "windowStartTime": "2020-07-07T13:54:34Z",
      "windowEndTime": "2020-07-09T13:54:34Z"
    }
  }
}

Exempelloggsökningsavisering när monitoringService = Simple Log Alert

{
  "alertContext": {
    "properties": {},
    "conditionType": "LogQueryCriteria",
    "condition": {
      "windowSize": null,
      "allOf": [
        {
          "searchQuery": "exceptions | where timestamp > ago(5m) | project timestamp, operation_Name, problemId, type, outerMessage",
          "metricMeasureColumn": null,
          "targetResourceTypes": null,
          "operator": null,
          "threshold": null,
          "timeAggregation": null,
          "dimensions": null,
          "metricValue": 1.0,
          "failingPeriods": null,
          "linkToSearchResultsUI": "https://portal.azure.com/AnalyticsBlade/subscriptions/12345a-1234b-123c-123d-12345678e/?query=exceptions+%7C+where+timestamp+%3E+ago%285m%29+%7C+project+timestamp%2C+operation_Name%2C+problemId%2C+type%2C+outerMessage",
          "linkToFilteredSearchResultsUI": "https://portal.azure.com/AnalyticsBlade/subscriptions/12345a-1234b-123c-123d-12345678e/?query=exceptions+%7C+where+timestamp+%3E+ago%285m%29+%7C+project+timestamp%2C+operation_Name%2C+problemId%2C+type%2C+outerMessage",
          "linkToSearchResultsAPI": "https://api.applicationinsights.io/v1/apps/0MyAppId0/query?query=exceptions%20%7C%20where%20timestamp%20%3E%20ago%285m%29%20%7C%20project%20timestamp%2C%20operation_Name%2C%20problemId%2C%20type%2C%20outerMessage",
          "linkToFilteredSearchResultsAPI": "https://api.applicationinsights.io/v1/apps/0MyAppId0/query?query=exceptions%20%7C%20where%20timestamp%20%3E%20ago%285m%29%20%7C%20project%20timestamp%2C%20operation_Name%2C%20problemId%2C%20type%2C%20outerMessage",
          "event": [
            [
              {
                "name": "timestamp",
                "value": "2020-07-09T13:54:34Z"
              },
              {
                "name": "operation_Name",
                "value": "GET /api/orders"
              },
              {
                "name": "problemId",
                "value": "System.NullReferenceException at OrdersController.GetOrder"
              },
              {
                "name": "type",
                "value": "System.NullReferenceException"
              },
              {
                "name": "outerMessage",
                "value": "Object reference not set to an instance of an object."
              }
            ]
          ]
        }
      ],
      "windowStartTime": null,
      "windowEndTime": null
    }
  }
}

Kontextfält för aktivitetsloggaviseringar

Mer information om fälten i aktivitetsloggaviseringar finns i händelseschemat för Azure-aktivitetsloggar .

Exempel på aktivitetsloggavisering när monitoringService = Aktivitetslogg – Administrativ

{
  "alertContext": {
      "authorization": {
        "action": "Microsoft.Compute/virtualMachines/restart/action",
        "scope": "/subscriptions/<subscription ID>/resourceGroups/PipeLineAlertRG/providers/Microsoft.Compute/virtualMachines/WCUS-R2-ActLog"
      },
      "channels": "Operation",
      "claims": "{\"aud\":\"https://management.core.windows.net/\",\"iss\":\"https://sts.windows.net/12345a-1234b-123c-123d-12345678e/\",\"iat\":\"1553260826\",\"nbf\":\"1553260826\",\"exp\":\"1553264726\",\"aio\":\"42JgYNjdt+rr+3j/dx68v018XhuFAwA=\",\"appid\":\"11112222-bbbb-3333-cccc-4444dddd5555\",\"appidacr\":\"2\",\"http://schemas.microsoft.com/identity/claims/identityprovider\":\"https://sts.windows.net/12345a-1234b-123c-123d-12345678e/\",\"http://schemas.microsoft.com/identity/claims/objectidentifier\":\"22223333-cccc-4444-dddd-5555eeee6666\",\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier\":\"22223333-cccc-4444-dddd-5555eeee6666\",\"http://schemas.microsoft.com/identity/claims/tenantid\":\"12345a-1234b-123c-123d-12345678e\",\"uti\":\"v5wYC9t9ekuA2rkZSVZbAA\",\"ver\":\"1.0\"}",
      "caller": "22223333-cccc-4444-dddd-5555eeee6666",
      "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
      "eventSource": "Administrative",
      "eventTimestamp": "2019-03-22T13:56:31.2917159+00:00",
      "eventDataId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
      "level": "Informational",
      "operationName": "Microsoft.Compute/virtualMachines/restart/action",
      "operationId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "status": "Succeeded",
      "subStatus": "",
      "submissionTimestamp": "2019-03-22T13:56:54.067593+00:00"
    }
}

Exempel på aktivitetsloggavisering när monitoringService = Aktivitetslogg – Policy

{
  "alertContext": {
    "authorization": {
      "action": "Microsoft.Resources/checkPolicyCompliance/read",
      "scope": "/subscriptions/<GUID>"
    },
    "channels": "Operation",
    "claims": "{\"aud\":\"https://management.azure.com/\",\"iss\":\"https://sts.windows.net/<GUID>/\",\"iat\":\"1566711059\",\"nbf\":\"1566711059\",\"exp\":\"1566740159\",\"aio\":\"42FgYOhynHNw0scy3T/bL71+xLyqEwA=\",\"appid\":\"<GUID>\",\"appidacr\":\"2\",\"http://schemas.microsoft.com/identity/claims/identityprovider\":\"https://sts.windows.net/<GUID>/\",\"http://schemas.microsoft.com/identity/claims/objectidentifier\":\"<GUID>\",\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier\":\"<GUID>\",\"http://schemas.microsoft.com/identity/claims/tenantid\":\"<GUID>\",\"uti\":\"Miy1GzoAG0Scu_l3m1aIAA\",\"ver\":\"1.0\"}",
    "caller": "<GUID>",
    "correlationId": "<GUID>",
    "eventSource": "Policy",
    "eventTimestamp": "2019-08-25T11:11:34.2269098+00:00",
    "eventDataId": "<GUID>",
    "level": "Warning",
    "operationName": "Microsoft.Authorization/policies/audit/action",
    "operationId": "<GUID>",
    "properties": {
      "isComplianceCheck": "True",
      "resourceLocation": "eastus2",
      "ancestors": "<GUID>",
      "policies": "[{\"policyDefinitionId\":\"/providers/Microsoft.Authorization/policyDefinitions/<GUID>/\",\"policySetDefinitionId\":\"/providers/Microsoft.Authorization/policySetDefinitions/<GUID>/\",\"policyDefinitionReferenceId\":\"vulnerabilityAssessmentMonitoring\",\"policySetDefinitionName\":\"<GUID>\",\"policyDefinitionName\":\"<GUID>\",\"policyDefinitionEffect\":\"AuditIfNotExists\",\"policyAssignmentId\":\"/subscriptions/<GUID>/providers/Microsoft.Authorization/policyAssignments/SecurityCenterBuiltIn/\",\"policyAssignmentName\":\"SecurityCenterBuiltIn\",\"policyAssignmentScope\":\"/subscriptions/<GUID>\",\"policyAssignmentSku\":{\"name\":\"A1\",\"tier\":\"Standard\"},\"policyAssignmentParameters\":{}}]"
    },
    "status": "Succeeded",
    "subStatus": "",
    "submissionTimestamp": "2019-08-25T11:12:46.1557298+00:00"
  }
}

Exempel på aktivitetsloggavisering när monitoringService = Aktivitetslogg - Autoskalning

{
  "alertContext": {
    "channels": "Admin, Operation",
    "claims": "{\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/spn\":\"Microsoft.Insights/autoscaleSettings\"}",
    "caller": "Microsoft.Insights/autoscaleSettings",
    "correlationId": "<GUID>",
    "eventSource": "Autoscale",
    "eventTimestamp": "2019-08-21T16:17:47.1551167+00:00",
    "eventDataId": "<GUID>",
    "level": "Informational",
    "operationName": "Microsoft.Insights/AutoscaleSettings/Scaleup/Action",
    "operationId": "<GUID>",
    "properties": {
      "description": "The autoscale engine attempting to scale resource '/subscriptions/d<GUID>/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachineScaleSets/testVMSS' from 9 instances count to 10 instances count.",
      "resourceName": "/subscriptions/<GUID>/resourceGroups/voiceassistancedemo/providers/Microsoft.Compute/virtualMachineScaleSets/alexademo",
      "oldInstancesCount": "9",
      "newInstancesCount": "10",
      "activeAutoscaleProfile": "{\r\n  \"Name\": \"Auto created scale condition\",\r\n  \"Capacity\": {\r\n    \"Minimum\": \"1\",\r\n    \"Maximum\": \"10\",\r\n    \"Default\": \"1\"\r\n  },\r\n  \"Rules\": [\r\n    {\r\n      \"MetricTrigger\": {\r\n        \"Name\": \"Percentage CPU\",\r\n        \"Namespace\": \"microsoft.compute/virtualmachinescalesets\",\r\n        \"Resource\": \"/subscriptions/<GUID>/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachineScaleSets/testVMSS\",\r\n        \"ResourceLocation\": \"eastus\",\r\n        \"TimeGrain\": \"PT1M\",\r\n        \"Statistic\": \"Average\",\r\n        \"TimeWindow\": \"PT5M\",\r\n        \"TimeAggregation\": \"Average\",\r\n        \"Operator\": \"GreaterThan\",\r\n        \"Threshold\": 0.0,\r\n        \"Source\": \"/subscriptions/<GUID>/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachineScaleSets/testVMSS\",\r\n        \"MetricType\": \"MDM\",\r\n        \"Dimensions\": [],\r\n        \"DividePerInstance\": false\r\n      },\r\n      \"ScaleAction\": {\r\n        \"Direction\": \"Increase\",\r\n        \"Type\": \"ChangeCount\",\r\n        \"Value\": \"1\",\r\n        \"Cooldown\": \"PT1M\"\r\n      }\r\n    }\r\n  ]\r\n}",
      "lastScaleActionTime": "Wed, 21 Aug 2019 16:17:47 GMT"
    },
    "status": "Succeeded",
    "submissionTimestamp": "2019-08-21T16:17:47.2410185+00:00"
  }
}

Exempel på aktivitetsloggavisering när monitoringService = Aktivitetslogg – Säkerhet

{
  "alertContext": {
    "channels": "Operation",
    "correlationId": "<GUID>",
    "eventSource": "Security",
    "eventTimestamp": "2019-08-26T08:34:14+00:00",
    "eventDataId": "<GUID>",
    "level": "Informational",
    "operationName": "Microsoft.Security/locations/alerts/activate/action",
    "operationId": "<GUID>",
    "properties": {
      "threatStatus": "Quarantined",
      "category": "Virus",
      "threatID": "2147519003",
      "filePath": "C:\\AlertGeneration\\test.eicar",
      "protectionType": "Windows Defender",
      "actionTaken": "Blocked",
      "resourceType": "Virtual Machine",
      "severity": "Low",
      "compromisedEntity": "testVM",
      "remediationSteps": "[\"No user action is necessary\"]",
      "attackedResourceType": "Virtual Machine"
    },
    "status": "Active",
    "submissionTimestamp": "2019-08-26T09:28:58.3019107+00:00"
  }
}

Exempel på aktivitetsloggavisering när monitoringService = ServiceHealth

{
  "alertContext": {
    "authorization": null,
    "channels": 1,
    "claims": null,
    "caller": null,
    "correlationId": "bbbb1111-cc22-3333-44dd-555555eeeeee",
    "eventSource": "ServiceHealth",
    "eventTimestamp": "2019-06-24T11:31:19.0312699+00:00",
    "httpRequest": null,
    "eventDataId": "<GUID>",
    "level": "Informational",
    "operationName": "Microsoft.ServiceHealth/maintenance/action",
    "operationId": "<GUID>",
    "properties": {
      "title": "Azure Synapse Analytics Scheduled Maintenance Pending",
      "service": "Azure Synapse Analytics",
      "region": "East US",
      "communication": "<MESSAGE>",
      "incidentType": "Maintenance",
      "trackingId": "<GUID>",
      "impactStartTime": "2019-06-26T04:00:00Z",
      "impactMitigationTime": "2019-06-26T12:00:00Z",
      "impactedServices": "[{\"ImpactedRegions\":[{\"RegionName\":\"East US\"}],\"ServiceName\":\"Azure Synapse Analytics\"}]",
      "impactedServicesTableRows": "<tr>\r\n<td align='center' style='padding: 5px 10px; border-right:1px solid black; border-bottom:1px solid black'>Azure Synapse Analytics</td>\r\n<td align='center' style='padding: 5px 10px; border-bottom:1px solid black'>East US<br></td>\r\n</tr>\r\n",
      "defaultLanguageTitle": "Azure Synapse Analytics Scheduled Maintenance Pending",
      "defaultLanguageContent": "<MESSAGE>",
      "stage": "Planned",
      "communicationId": "<GUID>",
      "maintenanceId": "<GUID>",
      "isHIR": "false",
      "version": "0.1.1"
    },
    "status": "Active",
    "subStatus": null,
    "submissionTimestamp": "2019-06-24T11:31:31.7147357+00:00",
    "ResourceType": null
  }
}

Exempel på aktivitetsloggavisering när monitoringService = ResourceHealth

{
  "alertContext": {
    "channels": "Admin, Operation",
    "correlationId": "<GUID>",
    "eventSource": "ResourceHealth",
    "eventTimestamp": "2019-06-24T15:42:54.074+00:00",
    "eventDataId": "<GUID>",
    "level": "Informational",
    "operationName": "Microsoft.Resourcehealth/healthevent/Activated/action",
    "operationId": "<GUID>",
    "properties": {
      "title": "This virtual machine is stopping and deallocating as requested by an authorized user or process",
      "details": null,
      "currentHealthStatus": "Unavailable",
      "previousHealthStatus": "Available",
      "type": "Downtime",
      "cause": "UserInitiated"
    },
    "status": "Active",
    "submissionTimestamp": "2019-06-24T15:45:20.4488186+00:00"
  }
}

Kontextfält för Prometheus-aviseringar

Mer information om fälten i Prometheus-aviseringar finns i Hanterad Azure Monitor-tjänst för Prometheus-regelgrupper .

Prometheus-exempelavisering

{
  "alertContext": {
    "interval": "PT1M",
    "expression": "sql_up > 0",
    "expressionValue": "0",
    "for": "PT2M",
    "labels": {
      "Environment": "Prod",
      "cluster": "myCluster1"
    },
    "annotations": {
      "summary": "alert on SQL availability"
    },
    "ruleGroup": "/subscriptions/<subscription ID>/resourceGroups/myResourceGroup/providers/Microsoft.AlertsManagement/prometheusRuleGroups/myRuleGroup"
  }
}

Fält för anpassade egenskaper

Om aviseringsregeln som genererade aviseringen innehåller åtgärdsgrupper kan anpassade egenskaper innehålla ytterligare information om aviseringen. Avsnittet anpassade egenskaper innehåller "key: value"-objekt som läggs till i webhook-meddelanden.

Om anpassade egenskaper inte anges i aviseringsregeln är fältet null.

Aktivera schemat för åtgärdsgrupper

Använd åtgärdsgrupper i Azure Portal eller använd REST-API:et för att aktivera det gemensamma aviseringsschemat. Scheman definieras på åtgärdsnivå. Du måste till exempel separat aktivera schemat för en e-poståtgärd och en webhook-åtgärd.

Aktivera det gemensamma schemat i Azure Portal

Öppna en befintlig åtgärd eller en ny åtgärd i en åtgärdsgrupp.
Välj Ja för att aktivera det gemensamma aviseringsschemat.

Aktivera det vanliga schemat med hjälp av REST-API:et

Du kan också använda API:et för åtgärdsgrupper för att välja det gemensamma aviseringsschemat. I anropet för att skapa eller uppdatera REST API:

Ange flaggan "useCommonAlertSchema" till true för att aktivera det gemensamma schemat
Ställ in flaggan "useCommonAlertSchema" till false för att använda det icke-gemensamma schemat för e-post, webhook, Logic Apps, Azure Functions eller Automation-runbook-åtgärder.

Exempel på REST API-anrop för att använda det gemensamma schemat

Följande begäran om att skapa eller uppdatera REST API:

Aktiverar det gemensamma aviseringsschemat för e-poståtgärden "John Doe's email".
Inaktiverar det vanliga aviseringsschemat för e-poståtgärden "Jane Smiths e-post".
Aktiverar det vanliga aviseringsschemat för webhook-åtgärden "Sample webhook".

{
  "properties": {
    "groupShortName": "sample",
    "enabled": true,
    "emailReceivers": [
      {
        "name": "John Doe's email",
        "emailAddress": "johndoe@contoso.com",
        "useCommonAlertSchema": true
      },
      {
        "name": "Jane Smith's email",
        "emailAddress": "janesmith@contoso.com",
        "useCommonAlertSchema": false
      }
    ],
    "smsReceivers": [
      {
        "name": "John Doe's mobile",
        "countryCode": "1",
        "phoneNumber": "1234567890"
      },
      {
        "name": "Jane Smith's mobile",
        "countryCode": "1",
        "phoneNumber": "0987654321"
      }
    ],
    "webhookReceivers": [
      {
        "name": "Sample webhook",
        "serviceUri": "http://www.example.com/webhook",
        "useCommonAlertSchema": true
      }
    ]
  },
  "location": "Global",
  "tags": {}
}

Nästa steg

Lär dig hur du skapar en logikapp som använder det gemensamma aviseringsschemat för att hantera alla dina aviseringar.

Feedback

Var den här sidan till hjälp?

Last updated on 2025-07-09

Vanligt aviseringsschema

Struktur för det gemensamma schemat

Exempel på meddelandenyttolast

Viktiga fält

Kontextfält för måttaviseringar

Exempel på måttavisering med ett statiskt tröskelvärde när monitoringService = Platform

Exempel på måttavisering med ett dynamiskt tröskelvärde när monitoringService = Platform

Exempel på måttavisering för tillgänglighetstester när monitoringService = Platform

Kontextfält för loggsökningsaviseringar

Exempelloggsökningsavisering när *monitoringService* = Log Analytics

Exempelloggsökningsavisering när övervakningstjänsten är Application Insights

Exempel på loggsökningsavisering när monitoringService = Log Alerts V2

Exempelloggsökningsavisering när monitoringService = Simple Log Alert

Kontextfält för aktivitetsloggaviseringar

Exempel på aktivitetsloggavisering när monitoringService = Aktivitetslogg – Administrativ

Exempel på aktivitetsloggavisering när monitoringService = Aktivitetslogg – Policy

Exempel på aktivitetsloggavisering när monitoringService = Aktivitetslogg - Autoskalning

Exempel på aktivitetsloggavisering när monitoringService = Aktivitetslogg – Säkerhet

Exempel på aktivitetsloggavisering när monitoringService = ServiceHealth

Exempel på aktivitetsloggavisering när monitoringService = ResourceHealth

Kontextfält för Prometheus-aviseringar

Prometheus-exempelavisering

Fält för anpassade egenskaper

Aktivera schemat för åtgärdsgrupper

Aktivera det gemensamma schemat i Azure Portal

Aktivera det vanliga schemat med hjälp av REST-API:et

Exempel på REST API-anrop för att använda det gemensamma schemat

Nästa steg

Feedback

Ytterligare resurser

Exempel på måttavisering med ett statiskt tröskelvärde när monitoringService = `Platform`

Exempel på måttavisering med ett dynamiskt tröskelvärde när monitoringService = `Platform`

Exempel på måttavisering för tillgänglighetstester när monitoringService = `Platform`

Exempelloggsökningsavisering när monitoringService = Log Analytics