Een webhook aanroepen met een klassieke metrische waarschuwing in Azure Monitor

  • Artikel

Waarschuwing

In dit artikel wordt beschreven hoe u oudere klassieke metrische waarschuwingen gebruikt. Azure Monitor ondersteunt nu bijna realtime metrische waarschuwingen en een nieuwe ervaring voor waarschuwingen. Klassieke waarschuwingen worden buiten gebruik gesteld voor gebruikers van de openbare cloud. Klassieke waarschuwingen voor Azure Government cloud en Microsoft Azure beheerd door 21Vianet worden op 29 februari 2024 buiten gebruik gesteld.

U kunt webhooks gebruiken om een Azure-waarschuwingsmelding te routeren naar andere systemen voor naverwerking of aangepaste acties. U kunt een webhook voor een waarschuwing gebruiken om deze te routeren naar services die sms-berichten verzenden, om fouten te registreren, om een team op de hoogte te stellen via chat- of berichtenservices, of voor verschillende andere acties.

In dit artikel wordt beschreven hoe u een webhook instelt voor een waarschuwing voor metrische gegevens van Azure. U ziet ook hoe de nettolading voor de HTTP POST naar een webhook eruitziet. Zie Een webhook aanroepen voor een azure-activiteitenlogboekwaarschuwing (waarschuwing voor gebeurtenissen) voor informatie over de installatie en het schema voor een waarschuwing voor een Azure-activiteitenlogboek.

Azure-waarschuwingen gebruiken HTTP POST om de inhoud van de waarschuwing in JSON-indeling te verzenden naar een webhook-URI die u opgeeft wanneer u de waarschuwing maakt. Het schema wordt verderop in dit artikel gedefinieerd. De URI moet een geldig HTTP- of HTTPS-eindpunt zijn. Azure plaatst één vermelding per aanvraag wanneer een waarschuwing wordt geactiveerd.

Webhooks configureren via de Azure Portal

Als u de webhook-URI wilt toevoegen of bijwerken, gaat u in de Azure Portal naar Waarschuwingen maken/bijwerken.

Een deelvenster waarschuwingsregel toevoegen

U kunt ook een waarschuwing configureren om te posten naar een webhook-URI met behulp van Azure PowerShell cmdlets, een platformoverschrijdende CLI of Azure Monitor REST API's.

De webhook verifiëren

De webhook kan worden geverifieerd met behulp van autorisatie op basis van tokens. De webhook-URI wordt opgeslagen met een token-id. Bijvoorbeeld: https://mysamplealert/webcallback?tokenid=sometokenid&someparameter=somevalue

Nettoladingschema

De POST-bewerking bevat de volgende JSON-nettolading en -schema voor alle waarschuwingen op basis van metrische gegevens:

{
    "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"
    }
}
Veld Verplicht Vaste set waarden Notities
status J Geactiveerd, opgelost De status voor de waarschuwing op basis van de voorwaarden die u instelt.
context J De waarschuwingscontext.
tijdstempel J Het tijdstip waarop de waarschuwing is geactiveerd.
id J Elke waarschuwingsregel heeft een unieke id.
naam J De naam van de waarschuwing.
beschrijving J Een beschrijving van de waarschuwing.
conditionType J Metrische waarde, gebeurtenis Er worden twee typen waarschuwingen ondersteund: metrische gegevens en gebeurtenissen. Waarschuwingen voor metrische gegevens zijn gebaseerd op een metrische voorwaarde. Gebeurteniswaarschuwingen zijn gebaseerd op een gebeurtenis in het activiteitenlogboek. Gebruik deze waarde om te controleren of de waarschuwing is gebaseerd op een metrische waarde of op een gebeurtenis.
Voorwaarde J De specifieke velden die moeten worden gecontroleerd op basis van de waarde conditionType .
metricName Voor metrische waarschuwingen De naam van de metrische waarde waarmee wordt gedefinieerd wat de regel bewaakt.
metricUnit Voor metrische waarschuwingen Bytes, BytesPerSecond, Count, CountPerSecond, Percent, Seconds De eenheid die is toegestaan in de metrische waarde. Toegestane waarden weergeven.
metricValue Voor metrische waarschuwingen De werkelijke waarde van de metrische waarde die de waarschuwing heeft veroorzaakt.
threshold Voor metrische waarschuwingen De drempelwaarde waarvoor de waarschuwing wordt geactiveerd.
windowSize Voor metrische waarschuwingen De periode die wordt gebruikt om waarschuwingsactiviteit te bewaken op basis van de drempelwaarde. De waarde moet tussen 5 minuten en 1 dag zijn. De waarde moet de ISO 8601-duurnotatie hebben.
timeAggregation Voor metrische waarschuwingen Gemiddelde, Laatste, Maximum, Minimum, Geen, Totaal Hoe de verzamelde gegevens in de loop van de tijd moeten worden gecombineerd. De standaardwaarde is Gemiddelde. Toegestane waarden weergeven.
operator Voor metrische waarschuwingen De operator die wordt gebruikt om de huidige metrische gegevens te vergelijken met de ingestelde drempelwaarde.
subscriptionId J De Azure-abonnements-id.
resourceGroupName J De naam van de resourcegroep voor de betreffende resource.
resourceName J De resourcenaam van de betrokken resource.
resourceType J Het resourcetype van de betrokken resource.
resourceId J De resource-id van de betrokken resource.
resourceRegion J De regio of locatie van de betrokken resource.
portalLink J Een directe koppeling naar de overzichtspagina van de portalresource.
properties N Optioneel Een set sleutel-waardeparen met details over de gebeurtenis. Bijvoorbeeld Dictionary<String, String>. Het eigenschappenveld is optioneel. In een aangepaste gebruikersinterface of op een logische app gebaseerde werkstroom kunnen gebruikers sleutel-waardeparen invoeren die via de nettolading kunnen worden doorgegeven. Een alternatieve manier om aangepaste eigenschappen weer door te geven aan de webhook is via de webhook-URI zelf (als queryparameters).

Notitie

U kunt het eigenschappenveld alleen instellen met behulp van Azure Monitor REST API's.

Volgende stappen