Webhook meghívása klasszikus metrikariasztással az Azure Monitorban

  • Cikk

Figyelmeztetés

Ez a cikk a régebbi klasszikus metrikariasztások használatát ismerteti. Az Azure Monitor mostantól támogatja a közel valós idejű metrikariasztásokat és egy új riasztási felületet. A klasszikus riasztások ki vannak vonva a nyilvános felhő felhasználói számára. A Azure Government felhőre és a 21Vianet által üzemeltetett Microsoft Azure-ra vonatkozó klasszikus riasztások 2024. február 29-én megszűnnek.

Webhookok használatával az Azure-riasztások értesítéseit más rendszerekre irányíthatja utófeldolgozás vagy egyéni műveletek céljából. A riasztások webhookja segítségével átirányíthatja az SMS-t küldő szolgáltatásokhoz, naplózhatja a hibákat, értesítheti a csapatokat csevegési vagy üzenetkezelési szolgáltatásokon keresztül, vagy különböző egyéb műveletekhez.

Ez a cikk azt ismerteti, hogyan állíthat be webhookot egy Azure-beli metrikariasztáson. Azt is megmutatja, hogyan néz ki a HTTP POST hasznos adatai egy webhook számára. Az Azure-tevékenységnapló-riasztások beállításáról és sémájáról (eseményekre vonatkozó riasztások) további információt a Webhook meghívása Azure-tevékenységnapló-riasztáson című témakörben talál.

Az Azure-riasztások a HTTP POST használatával küldik el a riasztás tartalmát JSON formátumban a riasztás létrehozásakor megadott webhook URI-nak. A sémát a cikk későbbi részében definiáljuk. Az URI-nak érvényes HTTP- vagy HTTPS-végpontnak kell lennie. Az Azure kérésenként egy bejegyzést tesz közzé egy riasztás aktiválásakor.

Webhookok konfigurálása a Azure Portal

A webhook URI-jának hozzáadásához vagy frissítéséhez lépjen a Azure Portal a Riasztások létrehozása/frissítése elemre.

Riasztási szabály panel hozzáadása

A webhook URI-jának való közzétételre is konfigurálhat riasztást Azure PowerShell parancsmagok, platformfüggetlen parancssori felület vagy Azure Monitor REST API-k használatával.

A webhook hitelesítése

A webhook jogkivonat-alapú hitelesítéssel hitelesíthető. A webhook URI-ja jogkivonat-azonosítóval lesz mentve. Például: https://mysamplealert/webcallback?tokenid=sometokenid&someparameter=somevalue

Hasznos adatséma

A POST művelet az alábbi JSON hasznos adatokat és sémát tartalmazza az összes metrikaalapú riasztáshoz:

{
    "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"
    }
}
Mező Kötelező Rögzített értékkészlet Jegyzetek
status Y Aktiválva, megoldva A riasztás állapota a megadott feltételek alapján.
Összefüggésben Y A riasztási környezet.
időbélyeg Y A riasztás aktiválásának időpontja.
id Y Minden riasztási szabály egyedi azonosítóval rendelkezik.
name Y A riasztás neve.
leírás Y A riasztás leírása.
conditionType Y Metrika, esemény Kétféle riasztás támogatott: metrika és esemény. A metrikariasztások egy metrikafeltételen alapulnak. Az eseményriasztások a tevékenységnaplóban szereplő eseményen alapulnak. Ezzel az értékkel ellenőrizheti, hogy a riasztás egy metrikán vagy egy eseményen alapul-e.
Feltétel Y Az ellenőrizendő mezők a conditionType érték alapján.
metricName Metrikariasztások esetén A szabály által figyelt metrika neve.
metricUnit Metrikariasztások esetén Bájtok, bájtokPerSecond, Count, CountPerSecond, Percent, Seconds A metrikában engedélyezett egység. Lásd az engedélyezett értékeket.
metricValue Metrikariasztások esetén A riasztást okozó metrika tényleges értéke.
Küszöb Metrikariasztások esetén Az a küszöbérték, amelyen a riasztás aktiválva van.
windowSize Metrikariasztások esetén A riasztási tevékenységek küszöbértéken alapuló figyelésére használt időszak. Az értéknek 5 perc és 1 nap között kell lennie. Az értéknek ISO 8601-es időtartamformátumban kell lennie.
timeAggregation Metrikariasztások esetén Átlag, Utolsó, Maximum, Minimum, Nincs, Összesen Az összegyűjtött adatok időbeli összevonásának módját. Az alapértelmezett érték az Átlag. Lásd az engedélyezett értékeket.
operátor Metrikariasztások esetén Az operátor, amely az aktuális metrikaadatok és a beállított küszöbérték összehasonlítására szolgál.
subscriptionId Y Az Azure-előfizetés azonosítója.
resourceGroupName Y Az érintett erőforrás erőforráscsoportjának neve.
resourceName Y Az érintett erőforrás erőforrásneve.
resourceType Y Az érintett erőforrás erőforrástípusa.
resourceId Y Az érintett erőforrás erőforrás-azonosítója.
resourceRegion Y Az érintett erőforrás régiója vagy helye.
portalLink Y Közvetlen hivatkozás a portál erőforrás-összefoglaló oldalára.
properties N Választható Az esemény részleteit tartalmazó kulcs-érték párok készlete. Például: Dictionary<String, String>. A tulajdonságok mező nem kötelező. Egyéni felhasználói felületen vagy logikaialkalmazás-alapú munkafolyamatban a felhasználók kulcs-érték párokat adhatnak meg, amelyek átadhatók a hasznos adatokon keresztül. Az egyéni tulajdonságok webhooknak való átadásának másik módja maga a webhook URI (lekérdezési paraméterek).

Megjegyzés

A tulajdonságmezőt csak az Azure Monitor REST API-kkal állíthatja be.

Következő lépések