Een webhook aanroepen met een klassieke metrische waarschuwing in Azure Monitor
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.
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
- Meer informatie over Azure-waarschuwingen en webhooks vindt u in de video Azure-waarschuwingen integreren met PagerDuty.
- Meer informatie over het uitvoeren van Azure Automation-scripts (runbooks) op Azure-waarschuwingen.
- Meer informatie over het gebruik van een logische app om een sms-bericht te verzenden via Twilio vanuit een Azure-waarschuwing.
- Meer informatie over het gebruik van een logische app om een Slack-bericht te verzenden vanuit een Azure-waarschuwing.
- Meer informatie over het gebruik van een logische app om een bericht te verzenden naar een Azure-wachtrij vanuit een Azure-waarschuwing.