Delen via


Metric Alerts - Update

Een metrische waarschuwingsdefinitie bijwerken.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/metricAlerts/{ruleName}?api-version=2018-03-01

URI-parameters

Name In Vereist Type Description
resourceGroupName
path True

string

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

ruleName
path True

string

De naam van de regel.

subscriptionId
path True

string

De id van het doelabonnement.

api-version
query True

string

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Type Description
properties.actions

MetricAlertAction[]

de matrix met acties die worden uitgevoerd wanneer de waarschuwingsregel actief wordt en wanneer een waarschuwingsvoorwaarde is opgelost.

properties.autoMitigate

boolean

de vlag die aangeeft of de waarschuwing automatisch moet worden opgelost of niet. De standaardwaarde is true.

properties.criteria MetricAlertCriteria:

definieert de specifieke informatie over waarschuwingscriteria.

properties.description

string

de beschrijving van de metrische waarschuwing die wordt opgenomen in de waarschuwings-e-mail.

properties.enabled

boolean

de vlag die aangeeft of de waarschuwing voor metrische gegevens is ingeschakeld.

properties.evaluationFrequency

string

hoe vaak de metrische waarschuwing wordt geëvalueerd, weergegeven in de ISO 8601-duurnotatie.

properties.scopes

string[]

de lijst met resource-id's waarop deze metrische waarschuwing is gericht.

properties.severity

integer

Ernst van waarschuwing {0, 1, 2, 3, 4}

properties.targetResourceRegion

string

de regio van de doelresource(s) waarop de waarschuwing wordt gemaakt/bijgewerkt. Verplicht voor MultipleResourceMultipleMetricCriteria.

properties.targetResourceType

string

het resourcetype van de doelresource(s) waarop de waarschuwing wordt gemaakt/bijgewerkt. Verplicht voor MultipleResourceMultipleMetricCriteria.

properties.windowSize

string

de periode (in iso 8601-duurnotatie) die wordt gebruikt voor het bewaken van waarschuwingsactiviteiten op basis van de drempelwaarde.

tags

object

Resourcetags

Antwoorden

Name Type Description
200 OK

MetricAlertResource

OK

Other Status Codes

ErrorResponse

BadRequest

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Create or update an alert rule

Voorbeeldaanvraag

PATCH https://management.azure.com/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourceGroups/gigtest/providers/Microsoft.Insights/metricAlerts/chiricutin?api-version=2018-03-01

{
  "tags": {},
  "properties": {
    "description": "This is the description of the rule1",
    "severity": 3,
    "enabled": true,
    "scopes": [
      "/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourceGroups/gigtest/providers/Microsoft.Compute/virtualMachines/gigwadme"
    ],
    "evaluationFrequency": "Pt1m",
    "windowSize": "Pt15m",
    "criteria": {
      "odata.type": "Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria",
      "allOf": [
        {
          "criterionType": "StaticThresholdCriterion",
          "name": "High_CPU_80",
          "metricName": "\\Processor(_Total)\\% Processor Time",
          "dimensions": [],
          "operator": "GreaterThan",
          "threshold": 80.5,
          "timeAggregation": "Average"
        }
      ]
    },
    "autoMitigate": true,
    "actions": [
      {
        "actionGroupId": "/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourcegroups/gigtest/providers/microsoft.insights/actiongroups/group2",
        "webHookProperties": {
          "key11": "value11",
          "key12": "value12"
        }
      }
    ]
  }
}

Voorbeeldrespons

{
  "id": "/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourceGroups/gigtest/providers/providers/microsoft.insights/metricalerts/chiricutin",
  "type": "Microsoft.Insights/metricAlerts",
  "location": "global",
  "tags": {
    "hidden-link:/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/Rac46PostSwapRG/providers/Microsoft.Web/sites/leoalerttest": "Resource"
  },
  "properties": {
    "description": "This is the description of the rule1",
    "severity": 3,
    "enabled": true,
    "scopes": [
      "/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourceGroups/gigtest/providers/Microsoft.Compute/virtualMachines/gigwadme"
    ],
    "evaluationFrequency": "Pt1m",
    "windowSize": "Pt15m",
    "criteria": {
      "odata.type": "Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria",
      "allOf": [
        {
          "criterionType": "StaticThresholdCriterion",
          "name": "High_CPU_80",
          "metricName": "\\Processor(_Total)\\% Processor Time",
          "dimensions": [],
          "operator": "GreaterThan",
          "threshold": 80.5,
          "timeAggregation": "Average"
        }
      ]
    },
    "autoMitigate": true,
    "actions": [
      {
        "actionGroupId": "/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourcegroups/gigtest/providers/microsoft.insights/actiongroups/group2",
        "webHookProperties": {
          "key11": "value11",
          "key12": "value12"
        }
      }
    ]
  }
}

Definities

Name Description
AggregationTypeEnum

de tijdaggregatietypen van criteria.

DynamicMetricCriteria

Criterium voor dynamische drempelwaarde.

DynamicThresholdFailingPeriods

Het minimale aantal schendingen dat is vereist binnen het geselecteerde terugbliktijdvenster dat is vereist om een waarschuwing te genereren.

DynamicThresholdOperator

De operator die wordt gebruikt om de metrische waarde te vergelijken met de drempelwaarde.

DynamicThresholdSensitivity

De mate van afwijking die nodig is om een waarschuwing te activeren. Dit is van invloed op hoe strak de drempelwaarde is voor het patroon voor metrische reeksen.

ErrorResponse

Beschrijft de indeling van foutantwoord.

MetricAlertAction

Een waarschuwingsactie.

MetricAlertMultipleResourceMultipleMetricCriteria

Hiermee geeft u de metrische waarschuwingscriteria op voor meerdere resources die meerdere metrische criteria hebben.

MetricAlertResource

De resource voor metrische waarschuwingen.

MetricAlertResourcePatch

De resource voor metrische waarschuwingen voor patchbewerkingen.

MetricAlertSingleResourceMultipleMetricCriteria

Hiermee geeft u de metrische waarschuwingscriteria op voor één resource met meerdere metrische criteria.

MetricCriteria

Criterium voor het filteren van metrische gegevens.

MetricDimension

Hiermee geeft u een metrische dimensie op.

Operator

de criteriaoperator.

WebtestLocationAvailabilityCriteria

Hiermee geeft u de metrische waarschuwingsregelcriteria voor een webtestresource op.

AggregationTypeEnum

de tijdaggregatietypen van criteria.

Name Type Description
Average

string

Count

string

Maximum

string

Minimum

string

Total

string

DynamicMetricCriteria

Criterium voor dynamische drempelwaarde.

Name Type Description
alertSensitivity

DynamicThresholdSensitivity

De mate van afwijking die nodig is om een waarschuwing te activeren. Dit is van invloed op hoe strak de drempelwaarde is voor het patroon voor metrische reeksen.

criterionType string:

DynamicThresholdCriterion

Hiermee geeft u het type drempelwaardecriteria op

dimensions

MetricDimension[]

Lijst met dimensievoorwaarden.

failingPeriods

DynamicThresholdFailingPeriods

Het minimale aantal schendingen dat is vereist binnen het geselecteerde terugbliktijdvenster dat is vereist om een waarschuwing te genereren.

ignoreDataBefore

string

Gebruik deze optie om de datum in te stellen vanaf welke u de metrische historische gegevens wilt leren en de dynamische drempelwaarden wilt berekenen (in ISO8601 indeling)

metricName

string

Naam van het metrische gegeven.

metricNamespace

string

Naamruimte van de metrische waarde.

name

string

Naam van de criteria.

operator

DynamicThresholdOperator

De operator die wordt gebruikt om de metrische waarde te vergelijken met de drempelwaarde.

skipMetricValidation

boolean

Hiermee kunt u een waarschuwingsregel maken op basis van een aangepast metrisch gegeven dat nog niet is verzonden, door ervoor te zorgen dat de metrische validatie wordt overgeslagen.

timeAggregation

AggregationTypeEnum

de tijdaggregatietypen van criteria.

DynamicThresholdFailingPeriods

Het minimale aantal schendingen dat is vereist binnen het geselecteerde terugbliktijdvenster dat is vereist om een waarschuwing te genereren.

Name Type Description
minFailingPeriodsToAlert

number

Het aantal schendingen dat een waarschuwing activeert. Moet kleiner zijn of gelijk zijn aan numberOfEvaluationPeriods.

numberOfEvaluationPeriods

number

Het aantal geaggregeerde terugblikpunten. Het tijdvenster van de lookback wordt berekend op basis van de aggregatiegranulariteit (windowSize) en het geselecteerde aantal geaggregeerde punten.

DynamicThresholdOperator

De operator die wordt gebruikt om de metrische waarde te vergelijken met de drempelwaarde.

Name Type Description
GreaterOrLessThan

string

GreaterThan

string

LessThan

string

DynamicThresholdSensitivity

De mate van afwijking die nodig is om een waarschuwing te activeren. Dit is van invloed op hoe strak de drempelwaarde is voor het patroon voor metrische reeksen.

Name Type Description
High

string

Low

string

Medium

string

ErrorResponse

Beschrijft de indeling van foutantwoord.

Name Type Description
code

string

Foutcode

message

string

Foutbericht waarin wordt aangegeven waarom de bewerking is mislukt.

MetricAlertAction

Een waarschuwingsactie.

Name Type Description
actionGroupId

string

de id van de actiegroep die moet worden gebruikt.

webHookProperties

object

Met dit veld kunt u aangepaste eigenschappen opgeven, die worden toegevoegd aan de nettolading van de waarschuwing die als invoer naar de webhook wordt verzonden.

MetricAlertMultipleResourceMultipleMetricCriteria

Hiermee geeft u de metrische waarschuwingscriteria op voor meerdere resources die meerdere metrische criteria hebben.

Name Type Description
allOf MultiMetricCriteria[]:

de lijst met meerdere metrische criteria voor deze 'all-of'-bewerking.

odata.type string:

Microsoft.Azure.Monitor.MultipleResourceMultipleMetricCriteria

hiermee geeft u het type waarschuwingscriteria op.

MetricAlertResource

De resource voor metrische waarschuwingen.

Name Type Description
id

string

Azure-resource-id

location

string

Resourcelocatie

name

string

Azure-resourcenaam

properties.actions

MetricAlertAction[]

de matrix met acties die worden uitgevoerd wanneer de waarschuwingsregel actief wordt en wanneer een waarschuwingsvoorwaarde is opgelost.

properties.autoMitigate

boolean

de vlag die aangeeft of de waarschuwing automatisch moet worden opgelost of niet. De standaardwaarde is true.

properties.criteria MetricAlertCriteria:

definieert de specifieke informatie over waarschuwingscriteria.

properties.description

string

de beschrijving van de metrische waarschuwing die wordt opgenomen in de waarschuwings-e-mail.

properties.enabled

boolean

de vlag die aangeeft of de waarschuwing voor metrische gegevens is ingeschakeld.

properties.evaluationFrequency

string

hoe vaak de metrische waarschuwing wordt geëvalueerd, weergegeven in iso 8601-duurnotatie.

properties.isMigrated

boolean

de waarde die aangeeft of deze waarschuwingsregel wordt gemigreerd.

properties.lastUpdatedTime

string

De laatste keer dat de regel is bijgewerkt in ISO8601 indeling.

properties.scopes

string[]

de lijst met resource-id's waarop deze metrische waarschuwing is gericht.

properties.severity

integer

Ernst van waarschuwing {0, 1, 2, 3, 4}

properties.targetResourceRegion

string

de regio van de doelresource(s) waarop de waarschuwing wordt gemaakt/bijgewerkt. Verplicht als het bereik een abonnement, resourcegroep of meer dan één resource bevat.

properties.targetResourceType

string

het resourcetype van de doelresource(s) waarop de waarschuwing wordt gemaakt/bijgewerkt. Verplicht als het bereik een abonnement, resourcegroep of meer dan één resource bevat.

properties.windowSize

string

de periode (in ISO 8601-duurnotatie) die wordt gebruikt voor het bewaken van waarschuwingsactiviteiten op basis van de drempelwaarde.

tags

object

Resourcetags

type

string

Azure-resourcetype

MetricAlertResourcePatch

De resource voor metrische waarschuwingen voor patchbewerkingen.

Name Type Description
properties.actions

MetricAlertAction[]

de matrix met acties die worden uitgevoerd wanneer de waarschuwingsregel actief wordt en wanneer een waarschuwingsvoorwaarde is opgelost.

properties.autoMitigate

boolean

de vlag die aangeeft of de waarschuwing automatisch moet worden opgelost of niet. De standaardwaarde is true.

properties.criteria MetricAlertCriteria:

definieert de specifieke informatie over waarschuwingscriteria.

properties.description

string

de beschrijving van de metrische waarschuwing die wordt opgenomen in de waarschuwings-e-mail.

properties.enabled

boolean

de vlag die aangeeft of de waarschuwing voor metrische gegevens is ingeschakeld.

properties.evaluationFrequency

string

hoe vaak de metrische waarschuwing wordt geëvalueerd, weergegeven in iso 8601-duurnotatie.

properties.isMigrated

boolean

de waarde die aangeeft of deze waarschuwingsregel wordt gemigreerd.

properties.lastUpdatedTime

string

De laatste keer dat de regel is bijgewerkt in ISO8601 indeling.

properties.scopes

string[]

de lijst met resource-id's waarop deze metrische waarschuwing is gericht.

properties.severity

integer

Ernst van waarschuwing {0, 1, 2, 3, 4}

properties.targetResourceRegion

string

de regio van de doelresource(s) waarop de waarschuwing wordt gemaakt/bijgewerkt. Verplicht voor MultipleResourceMultipleMetricCriteria.

properties.targetResourceType

string

het resourcetype van de doelresource(s) waarop de waarschuwing wordt gemaakt/bijgewerkt. Verplicht voor MultipleResourceMultipleMetricCriteria.

properties.windowSize

string

de periode (in ISO 8601-duurnotatie) die wordt gebruikt voor het bewaken van waarschuwingsactiviteiten op basis van de drempelwaarde.

tags

object

Resourcetags

MetricAlertSingleResourceMultipleMetricCriteria

Hiermee geeft u de metrische waarschuwingscriteria op voor één resource met meerdere metrische criteria.

Name Type Description
allOf

MetricCriteria[]

De lijst met metrische criteria voor deze 'all-of'-bewerking.

odata.type string:

Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria

hiermee geeft u het type waarschuwingscriteria op.

MetricCriteria

Criterium voor het filteren van metrische gegevens.

Name Type Description
criterionType string:

StaticThresholdCriterion

Hiermee geeft u het type drempelwaardecriteria op

dimensions

MetricDimension[]

Lijst met dimensievoorwaarden.

metricName

string

Naam van het metrische gegeven.

metricNamespace

string

Naamruimte van de metrische waarde.

name

string

Naam van de criteria.

operator

Operator

de criteriaoperator.

skipMetricValidation

boolean

Hiermee kunt u een waarschuwingsregel maken op basis van een aangepast metrisch gegeven dat nog niet is verzonden, door ervoor te zorgen dat de metrische validatie wordt overgeslagen.

threshold

number

de drempelwaarde voor criteria waarmee de waarschuwing wordt geactiveerd.

timeAggregation

AggregationTypeEnum

de tijdaggregatietypen van criteria.

MetricDimension

Hiermee geeft u een metrische dimensie op.

Name Type Description
name

string

Naam van de dimensie.

operator

string

de dimensieoperator. Alleen 'Opnemen' en 'Uitsluiten' worden ondersteund

values

string[]

lijst met dimensiewaarden.

Operator

de criteriaoperator.

Name Type Description
Equals

string

GreaterThan

string

GreaterThanOrEqual

string

LessThan

string

LessThanOrEqual

string

WebtestLocationAvailabilityCriteria

Hiermee geeft u de metrische waarschuwingsregelcriteria voor een webtestresource op.

Name Type Description
componentId

string

De Application Insights-resource-id.

failedLocationCount

number

Het aantal mislukte locaties.

odata.type string:

Microsoft.Azure.Monitor.WebtestLocationAvailabilityCriteria

hiermee geeft u het type waarschuwingscriteria op.

webTestId

string

De Application Insights-webtest-id.