Een webhook met een klassieke waarschuwing voor metrische gegevens in Azure Monitor aanroepenCall a webhook with a classic metric alert in Azure Monitor

Waarschuwing

In dit artikel wordt beschreven hoe u oudere klassieke metrische waarschuwingen gebruikt.This article describes how to use older classic metric alerts. Azure Monitor ondersteunt nu nieuwere bijna realtime waarschuwingen voor metrische gegevens en een nieuwe meldings ervaring.Azure Monitor now supports newer near-real time metric alerts and a new alerts experience. Klassieke waarschuwingen worden buiten gebruik gesteld voor open bare Cloud gebruikers, maar blijven beperkt tot 31 mei 2021.Classic alerts are retired for public cloud users, though still in limited use until 31 May 2021. Klassieke waarschuwingen voor Azure Government Cloud en Azure China 21Vianet worden op 29 februari 2024 buiten gebruik gesteld.Classic alerts for Azure Government cloud and Azure China 21Vianet will retire on 29 February 2024.

U kunt webhooks gebruiken om een Azure-waarschuwings melding naar andere systemen te routeren voor nabewerkingen of aangepaste acties.You can use webhooks to route an Azure alert notification to other systems for post-processing or custom actions. U kunt een webhook gebruiken voor een waarschuwing om deze te routeren naar services die SMS-berichten verzenden, fouten in het logboek registreren, een team informeren via chat-of bericht Services of voor verschillende andere acties.You can use a webhook on an alert to route it to services that send SMS messages, to log bugs, to notify a team via chat or messaging services, or for various other actions.

In dit artikel wordt beschreven hoe u een webhook instelt voor een waarschuwing voor een Azure-metriek.This article describes how to set a webhook on an Azure metric alert. U ziet ook hoe de payload voor het HTTP POST-bericht op een webhook eruit ziet.It also shows you what the payload for the HTTP POST to a webhook looks like. Zie een webhook aanroepen in een Azure-activiteiten logboek waarschuwingvoor meer informatie over de installatie en het schema voor een Azure-activiteiten logboek waarschuwing (waarschuwing voor gebeurtenissen).For information about the setup and schema for an Azure activity log alert (alert on events), see Call a webhook on an Azure activity log alert.

Azure-waarschuwingen gebruiken HTTP POST om de waarschuwings inhoud in JSON-indeling te verzenden naar een webhook-URI die u opgeeft bij het maken van de waarschuwing.Azure alerts use HTTP POST to send the alert contents in JSON format to a webhook URI that you provide when you create the alert. Het schema wordt verderop in dit artikel gedefinieerd.The schema is defined later in this article. De URI moet een geldig HTTP-of HTTPS-eind punt zijn.The URI must be a valid HTTP or HTTPS endpoint. Azure plaatst één vermelding per aanvraag wanneer een waarschuwing wordt geactiveerd.Azure posts one entry per request when an alert is activated.

Webhooks configureren via de Azure PortalConfigure webhooks via the Azure portal

Als u de webhook-URI wilt toevoegen of bijwerken, gaat u in het Azure Portalnaar waarschuwingen voor maken/bijwerken.To add or update the webhook URI, in the Azure portal, go to Create/Update Alerts.

Een waarschuwings regel deel venster toevoegen

U kunt ook een waarschuwing configureren voor het plaatsen van een bericht naar een webhook-URI door gebruik te maken van Azure PowerShell-cmdlets, een cross-platform-cliof Azure monitor rest-api's.You can also configure an alert to post to a webhook URI by using Azure PowerShell cmdlets, a cross-platform CLI, or Azure Monitor REST APIs.

De webhook verifiërenAuthenticate the webhook

De webhook kan worden geverifieerd met behulp van autorisatie op basis van tokens.The webhook can authenticate by using token-based authorization. De webhook-URI wordt opgeslagen met een token-ID.The webhook URI is saved with a token ID. Bijvoorbeeld: https://mysamplealert/webcallback?tokenid=sometokenid&someparameter=somevalueFor example: https://mysamplealert/webcallback?tokenid=sometokenid&someparameter=somevalue

Payload-schemaPayload schema

De POST-bewerking bevat de volgende JSON-nettolading en het schema voor alle waarschuwingen op basis van metrische gegevens:The POST operation contains the following JSON payload and schema for all metric-based alerts:

{
    "status": "Activated",
    "context": {
        "timestamp": "2015-08-14T22:26:41.9975398Z",
        "id": "/subscriptions/s1/resourceGroups/useast/providers/microsoft.insights/alertrules/ruleName1",
        "name": "ruleName1",
        "description": "some description",
        "conditionType": "Metric",
        "condition": {
            "metricName": "Requests",
            "metricUnit": "Count",
            "metricValue": "10",
            "threshold": "10",
            "windowSize": "15",
            "timeAggregation": "Average",
            "operator": "GreaterThanOrEqual"
        },
        "subscriptionId": "s1",
        "resourceGroupName": "useast",
        "resourceName": "mysite1",
        "resourceType": "microsoft.foo/sites",
        "resourceId": "/subscriptions/s1/resourceGroups/useast/providers/microsoft.foo/sites/mysite1",
        "resourceRegion": "centralus",
        "portalLink": "https://portal.azure.com/#resource/subscriptions/s1/resourceGroups/useast/providers/microsoft.foo/sites/mysite1"
    },
    "properties": {
        "key1": "value1",
        "key2": "value2"
    }
}
VeldField VerplichtMandatory Vaste set waardenFixed set of values NotitiesNotes
statusstatus JY Geactiveerd, opgelostActivated, Resolved De status van de waarschuwing op basis van de voor waarden die u hebt ingesteld.The status for the alert based on the conditions you set.
contextcontext JY De context van de waarschuwing.The alert context.
tijdstempeltimestamp JY Het tijdstip waarop de waarschuwing is geactiveerd.The time at which the alert was triggered.
idid JY Elke waarschuwings regel heeft een unieke ID.Every alert rule has a unique ID.
naamname JY De naam van de waarschuwing.The alert name.
beschrijvingdescription JY Een beschrijving van de waarschuwing.A description of the alert.
conditionTypeconditionType JY Metrische gegevens, gebeurtenisMetric, Event Er worden twee soorten waarschuwingen ondersteund: metric en Event.Two types of alerts are supported: metric and event. Metrische waarschuwingen zijn gebaseerd op een metrische voor waarde.Metric alerts are based on a metric condition. Gebeurtenis waarschuwingen zijn gebaseerd op een gebeurtenis in het activiteiten logboek.Event alerts are based on an event in the activity log. Gebruik deze waarde om te controleren of de waarschuwing is gebaseerd op een metrische waarde of een gebeurtenis.Use this value to check whether the alert is based on a metric or on an event.
regelingcondition JY De specifieke velden die moeten worden gecontroleerd op basis van de waarde van conditionType .The specific fields to check based on the conditionType value.
metricNamemetricName Voor metrische waarschuwingenFor metric alerts De naam van de metriek die definieert wat de regel controleert.The name of the metric that defines what the rule monitors.
metricUnitmetricUnit Voor metrische waarschuwingenFor metric alerts Bytes, BytesPerSecond, aantal, CountPerSecond, percentage, secondenBytes, BytesPerSecond, Count, CountPerSecond, Percent, Seconds De eenheid die is toegestaan in de metriek.The unit allowed in the metric. Bekijk de toegestane waarden.See allowed values.
metricValuemetricValue Voor metrische waarschuwingenFor metric alerts De werkelijke waarde van de metriek die de waarschuwing heeft veroorzaakt.The actual value of the metric that caused the alert.
thresholdthreshold Voor metrische waarschuwingenFor metric alerts De drempel waarde waarmee de waarschuwing wordt geactiveerd.The threshold value at which the alert is activated.
windowSizewindowSize Voor metrische waarschuwingenFor metric alerts De periode die wordt gebruikt voor het bewaken van de waarschuwings activiteit op basis van de drempel waarde.The period of time that's used to monitor alert activity based on the threshold. De waarde moet tussen 5 minuten en 1 dag liggen.The value must be between 5 minutes and 1 day. De waarde moet de ISO 8601-duur notatie hebben.The value must be in ISO 8601 duration format.
timeAggregationtimeAggregation Voor metrische waarschuwingenFor metric alerts Gemiddelde, laatste, maximum, minimum, geen, totaalAverage, Last, Maximum, Minimum, None, Total Hoe de verzamelde gegevens in de loop van de tijd moeten worden gecombineerd.How the data that's collected should be combined over time. De standaard waarde is gemiddelde.The default value is Average. Bekijk de toegestane waarden.See allowed values.
operatoroperator Voor metrische waarschuwingenFor metric alerts De operator die wordt gebruikt om de huidige metrische gegevens te vergelijken met de ingestelde drempel waarde.The operator that's used to compare the current metric data to the set threshold.
subscriptionIdsubscriptionId JY De ID van het Azure-abonnement.The Azure subscription ID.
resourceGroupNameresourceGroupName JY De naam van de resource groep voor de betrokken resource.The name of the resource group for the affected resource.
resourceNameresourceName JY De resource naam van de betrokken resource.The resource name of the affected resource.
resourceTyperesourceType JY Het resource type van de betrokken resource.The resource type of the affected resource.
resourceIdresourceId JY De resource-ID van de betrokken resource.The resource ID of the affected resource.
resourceRegionresourceRegion JY De regio of locatie van de betrokken resource.The region or location of the affected resource.
portalLinkportalLink JY Een directe koppeling naar de overzichts pagina van de portal-resource.A direct link to the portal resource summary page.
propertiesproperties NN OptioneelOptional Een set sleutel-waardeparen met details over de gebeurtenis.A set of key/value pairs that has details about the event. Bijvoorbeeld Dictionary<String, String>.For example, Dictionary<String, String>. Het veld eigenschappen is optioneel.The properties field is optional. In een aangepaste UI-of logische werk stroom op basis van een app kunnen gebruikers sleutel-waardeparen invoeren die kunnen worden door gegeven via de payload.In a custom UI or logic app-based workflow, users can enter key/value pairs that can be passed via the payload. Een alternatieve manier om aangepaste eigenschappen door te geven aan de webhook is via de webhook-URI zelf (als query parameters).An alternate way to pass custom properties back to the webhook is via the webhook URI itself (as query parameters).

Notitie

U kunt het Eigenschappen veld alleen instellen met behulp van Azure monitor rest-api's.You can set the properties field only by using Azure Monitor REST APIs.

Volgende stappenNext steps