Volání webhooku s využitím klasického upozornění na metriku ve službě Azure Monitor

  • Článek

Upozornění

Tento článek popisuje, jak používat starší klasická upozornění na metriky. Azure Monitor teď podporuje upozornění metrik téměř v reálném čase a nové prostředí upozornění. Klasická upozornění jsou pro uživatele veřejného cloudu vyřazena . Klasická upozornění na Azure Government cloud a Microsoft Azure provozovaná společností 21Vianet budou vyřazena 29. února 2024.

Webhooky můžete použít ke směrování oznámení upozornění Azure do jiných systémů pro následné zpracování nebo vlastní akce. Pomocí webhooku můžete upozornění směrovat do služeb, které odesílají zprávy SMS, protokolovat chyby, upozorňovat tým prostřednictvím chatu nebo zasílání zpráv nebo na různé další akce.

Tento článek popisuje, jak nastavit webhook u upozornění na metriku Azure. Také vám ukáže, jak vypadá datová část pro webhooky HTTP POST. Informace o nastavení a schématu upozornění protokolu aktivit Azure (upozornění na události) najdete v tématu Volání webhooku v upozornění protokolu aktivit Azure.

Upozornění Azure používají http POST k odeslání obsahu upozornění ve formátu JSON do identifikátoru URI webhooku, který zadáte při vytváření upozornění. Schéma je definováno dále v tomto článku. Identifikátor URI musí být platný koncový bod HTTP nebo HTTPS. Azure při aktivaci upozornění publikuje jednu položku na každou žádost.

Konfigurace webhooků prostřednictvím Azure Portal

Pokud chcete přidat nebo aktualizovat identifikátor URI webhooku, přejděte v Azure Portal do části Vytvoření nebo aktualizace upozornění.

Přidání podokna pravidla upozornění

Upozornění můžete také nakonfigurovat tak, aby se zobrazilo do identifikátoru URI webhooku pomocí rutin Azure PowerShell, rozhraní příkazového řádku pro různé platformy nebo rozhraní REST API služby Azure Monitor.

Ověření webhooku

Webhook se může ověřovat pomocí autorizace založené na tokenech. Identifikátor URI webhooku se uloží s ID tokenu. Příklad: https://mysamplealert/webcallback?tokenid=sometokenid&someparameter=somevalue

Schéma datové části

Operace POST obsahuje následující datovou část JSON a schéma pro všechna upozornění na základě metrik:

{
    "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"
    }
}
Pole Povinné Pevná sada hodnot Poznámky
status Y Aktivováno, vyřešeno Stav výstrahy na základě podmínek, které jste nastavili.
kontext Y Kontext upozornění.
časové razítko Y Čas, kdy se výstraha aktivovala.
id Y Každé pravidlo upozornění má jedinečné ID.
name Y Název upozornění.
description Y Popis výstrahy.
conditionType Y Metrika, událost Podporují se dva typy upozornění: metrika a událost. Upozornění metrik jsou založená na podmínce metriky. Upozornění událostí jsou založená na události v protokolu aktivit. Pomocí této hodnoty můžete zkontrolovat, jestli je výstraha založena na metrice nebo na události.
Podmínka Y Konkrétní pole, která chcete zkontrolovat na základě hodnoty conditionType .
metricName Upozornění na metriky Název metriky, která definuje, co pravidlo monitoruje.
metricUnit Upozornění na metriky Bajty, BytesPerSecond, Count, CountPerSecond, Percent, Seconds Jednotka povolená v metrice. Viz povolené hodnoty.
metricValue Upozornění na metriky Skutečná hodnota metriky, která způsobila výstrahu.
Práh Upozornění na metriky Prahová hodnota, pro kterou je výstraha aktivována.
windowSize Upozornění na metriky Časové období, které se používá k monitorování aktivity upozornění na základě prahové hodnoty. Hodnota musí být v rozmezí od 5 minut do 1 dne. Hodnota musí být ve formátu doby trvání ISO 8601.
timeAggregation Upozornění na metriky Average, Last, Maximum, Minimum, None, Total Způsob kombinování shromážděných dat v průběhu času Výchozí hodnota je Průměr. Viz povolené hodnoty.
operátor Upozornění na metriky Operátor, který se používá k porovnání aktuálních dat metriky s nastavenou prahovou hodnotou.
subscriptionId Y ID předplatného Azure.
resourceGroupName Y Název skupiny prostředků pro ovlivněný prostředek.
resourceName Y Název ovlivněného prostředku.
resourceType Y Typ prostředku ovlivněného prostředku.
resourceId Y ID prostředku ovlivněného prostředku.
resourceRegion Y Oblast nebo umístění ovlivněného prostředku.
odkaz na portál Y Přímý odkaz na stránku souhrnu prostředků portálu
properties N Volitelné Sada párů klíč/hodnota, která obsahuje podrobnosti o události. Například, Dictionary<String, String>. Pole vlastnosti je volitelné. Ve vlastním uživatelském rozhraní nebo pracovním postupu založeném na aplikaci logiky můžou uživatelé zadávat páry klíč/hodnota, které je možné předávat prostřednictvím datové části. Alternativním způsobem, jak předat vlastní vlastnosti zpět do webhooku, je prostřednictvím samotného identifikátoru URI webhooku (jako parametrů dotazu).

Poznámka

Pole vlastností můžete nastavit pouze pomocí rozhraní REST API služby Azure Monitor.

Další kroky