How-to: Configure alerts and get notifications using a hook (Waarschuwingen configureren en meldingen ontvangen met behulp van een hook)

Nadat een anomalie is gedetecteerd door Metrics Advisor, wordt er een waarschuwingsmelding geactiveerd op basis van waarschuwingsinstellingen, met behulp van een hook. Een waarschuwingsinstelling kan worden gebruikt met meerdere detectieconfiguraties. Er zijn verschillende parameters beschikbaar om uw waarschuwingsregel aan te passen.

Een hook maken

Metrics Advisor ondersteunt vier verschillende typen hooks: e-mail, Teams, webhook en Azure DevOps. U kunt de optie kiezen die voor uw specifieke scenario werkt.

E-mail hook

Een e-mail hook is het kanaal voor anomaliewaarschuwingen die worden verzonden naar e-mailadressen die zijn opgegeven in de sectie E-mail naar. Er worden twee soorten waarschuwingsmails verzonden: gegevensfeed niet-beschikbare waarschuwingen en Incidentrapporten, die een of meer afwijkingen bevatten.

Voor het maken van een e-mail hook zijn de volgende parameters beschikbaar:

Nadat u OK hebt geselecteerd, wordt er een e-mail hook gemaakt. U kunt deze in alle waarschuwingsinstellingen gebruiken om anomaliewaarschuwingen te ontvangen. Raadpleeg de zelfstudie over het inschakelen van anomaliemeldingen in Metrics Advisor gedetailleerde stappen.

Teams hook

Een Teams is het kanaal voor anomaliewaarschuwingen die worden verzonden naar een kanaal in Microsoft Teams. Een Teams hook wordt geïmplementeerd via een connector voor binnenkomende webhooks. Mogelijk moet u een 'binnenkomende webhook'-connector maken in uw doelkanaal Teams een URL van deze connector op te halen. Draai vervolgens terug naar uw Metrics Advisor werkruimte.

Selecteer het tabblad Hooks in de linkernavigatiebalk en selecteer de knop 'Hook maken' rechtsboven op de pagina. Kies het hooktype 'Teams'. De volgende parameters worden opgegeven:

Nadat u OK hebt geselecteerd, Teams een nieuwe hook gemaakt. U kunt deze gebruiken in alle waarschuwingsinstellingen om anomaliewaarschuwingen te melden aan Teams doelkanaal. Raadpleeg de zelfstudie over het inschakelen van anomaliemeldingen in Metrics Advisor gedetailleerde stappen.

Web hook

Een web hook is een ander meldingskanaal met behulp van een eindpunt dat wordt geleverd door de klant. Eventuele anomalie die in de tijdreeks wordt gedetecteerd, wordt gewaarschuwd via een web hook. Er zijn verschillende stappen voor het inschakelen van een web hook als waarschuwingsmeldingskanaal binnen Metrics Advisor.

Stap 1. Beheerde identiteit inschakelen in uw Metrics Advisor resource

Een door het systeem toegewezen beheerde identiteit is beperkt tot één identiteit per resource en is gekoppeld aan de levenscyclus van deze resource. U kunt machtigingen verlenen aan de beheerde identiteit met behulp van op rollen gebaseerd toegangsbeheer van Azure (Azure RBAC). De beheerde identiteit wordt geverifieerd met Azure AD, zodat u geen referenties in code hoeft op te slaan.

Ga naar Metrics Advisor resource in Azure Portal en selecteer 'Identiteit', zet deze op 'aan' en vervolgens beheerde identiteit is ingeschakeld.

Stap 2. Een web hook maken in Metrics Advisor werkruimte

Meld u aan bij uw werkruimte, selecteer het tabblad Hooks en selecteer vervolgens de knop 'Hook maken'.

Als u een web hook wilt maken, moet u de volgende informatie toevoegen:

• Aanvraagmethode is POST
• Time-out 30s
• Nieuwe poging voor 5xx-fout, negeer andere fout. Volgt de omleidingsaanvraag van 301/302 niet.
• Aanvraagtekst:

{
"value": [{
    "hookId": "b0f27e91-28cf-4aa2-aa66-ac0275df14dd",
    "alertType": "Anomaly",
    "alertInfo": {
        "anomalyAlertingConfigurationId": "1bc6052e-9a2a-430b-9cbd-80cd07a78c64",
        "alertId": "172536dbc00",
        "timestamp": "2020-05-27T00:00:00Z",
        "createdTime": "2020-05-29T10:04:45.590Z",
        "modifiedTime": "2020-05-29T10:04:45.590Z"
    },
    "callBackUrl": "https://kensho2-api.azurewebsites.net/alert/anomaly/configurations/1bc6052e-9a2a-430b-9cbd-80cd07a78c64/alerts/172536dbc00/incidents"
}]
}

Stap 3. (optioneel) Sla uw certificaat op in Azure Key Vaults en haal de id op Zoals vermeld, moet het certificaat worden opgeslagen in Azure Key Vaults als het eindpunt moet worden geverifieerd door een certificaat.

• Controleer Set and retrieve a certificate from Azure Key Vault using the Azure Portal
• Klik op het certificaat dat u hebt toegevoegd. Vervolgens kunt u de certificaat-id kopiëren.
• Selecteer vervolgens Toegangsbeleid en Toegangsbeleid toevoegen, verleen 'get' machtigingen voor 'Sleutelmachtigingen', 'Geheime machtigingen' en 'Certificaatmachtigingen'. Selecteer principal als de naam van uw Metrics Advisor resource. Selecteer toevoegen en opslaan op de pagina Toegangsbeleid.

Stap 4. Anomaliemelding ontvangen Wanneer een melding via een webhook wordt pusht, kunt u incidentgegevens ophalen door de callBackUrl in Webhook-aanvraag aan te roepen. Details voor deze API:

• /alert/anomaly/configurations/{configurationId}/alerts/{alertId}/incidents

Door gebruik te maken van web hook en Azure Logic Apps, is het mogelijk om e-mailmeldingen te verzenden zonder dat er een SMTP-server is geconfigureerd. Raadpleeg de zelfstudie over het inschakelen van anomaliemeldingen in Metrics Advisor gedetailleerde stappen.

Azure DevOps

Metrics Advisor ondersteunt ook het automatisch maken van een werkitem in Azure DevOps om problemen/fouten bij te houden wanneer er een anomalie wordt gedetecteerd. Alle waarschuwingen kunnen worden verzonden via Azure DevOps-hooks.

Als u een Azure DevOps-hook wilt maken, moet u de volgende informatie toevoegen

Waarschuwingsinstellingen toevoegen of bewerken

Ga naar de detailpagina voor metrische gegevens om de sectie Waarschuwingsinstellingen te vinden in de linkeronderhoek van de detailpagina voor metrische gegevens. Er worden alle waarschuwingsinstellingen vermeld die van toepassing zijn op de geselecteerde detectieconfiguratie. Wanneer er een nieuwe detectieconfiguratie wordt gemaakt, is er geen waarschuwingsinstelling en worden er geen waarschuwingen verzonden.
U kunt de pictogrammen Toevoegen, Bewerken en Verwijderen gebruiken om waarschuwingsinstellingen te wijzigen.

Selecteer de knoppen Toevoegen of Bewerken om een venster op te halen om de waarschuwingsinstellingen toe te voegen of te bewerken.

Naam van waarschuwingsinstelling: de naam van de waarschuwingsinstelling. Deze wordt weergegeven in de titel van de waarschuwings-e-mail.

Hooks: de lijst met hooks waar u waarschuwingen naar wilt verzenden.

De sectie die in de bovenstaande schermopname is gemarkeerd, zijn de instellingen voor één detectieconfiguratie. U kunt verschillende waarschuwingsinstellingen instellen voor verschillende detectieconfiguraties. Kies de doelconfiguratie met behulp van de derde vervolgkeuzelijst in dit venster.

Filterinstellingen

Hier volgen de filterinstellingen voor één detectieconfiguratie.

Waarschuwing voor heeft vier opties voor het filteren van afwijkingen:

• Afwijkingen in alle reeksen: alle afwijkingen worden opgenomen in de waarschuwing.
• Afwijkingen in de reeksgroep: filter reeksen op dimensiewaarden. Stel specifieke waarden in voor sommige dimensies. Afwijkingen worden alleen opgenomen in de waarschuwing wanneer de reeks overeenkomt met de opgegeven waarde.
• Afwijkingen in favoriete reeksen: alleen de reeks die als favoriet is gemarkeerd, wordt opgenomen in de waarschuwing. |
• Afwijkingen in top N van alle reeksen: dit filter is voor het geval dat u alleen de reeks belangrijk vindt waarvan de waarde in de bovenste N staat. Metrics Advisor kijkt terug op eerdere tijdstempels en controleert of de waarden van de reeks op deze tijdstempels in top N staan. Als het aantal 'in top n' groter is dan het opgegeven aantal, wordt de anomalie opgenomen in een waarschuwing. |

Filteropties voor anomalie zijn een extra filter met de volgende opties:

• Ernst: de afwijking wordt alleen opgenomen wanneer de ernst van de afwijking binnen het opgegeven bereik valt.
• Uitsluisen: stop waarschuwingen tijdelijk voor afwijkingen in de volgende N punten (periode) wanneer deze worden geactiveerd in een waarschuwing.
  • Type uitsluisen: als deze optie is ingesteld op Reeks, wordt de reeks alleen uit de reeks door een geactiveerde afwijking uit de reeks gesluisd. Voor Metrische gegevens wordt met één geactiveerde anomalie alle reeksen in deze metrische gegevens uit de weg nomen.
  • snooze number: het aantal punten (punt) dat moet worden uitsluisen.
  • opnieuw instellen voor niet-opeenvolgende: als deze optie is geselecteerd, worden de volgende n opeenvolgende afwijkingen alleen door een geactiveerde anomalie uitstellen. Als een van de volgende gegevenspunten geen anomalie is, wordt de snooze vanaf dat moment opnieuw ingesteld; Als de optie niet is geselecteerd, worden de volgende n punten (punt) door een geactiveerde anomalie uit het sluimerpunt nomen, zelfs als opeenvolgende gegevenspunten geen afwijkingen zijn.
• waarde (optioneel): Filter op waarde. Alleen puntwaarden die voldoen aan de voorwaarde, anomalie wordt opgenomen. Als u de bijbehorende waarde van een ander metrisch gegeven gebruikt, moeten de dimensienamen van de twee metrische gegevens consistent zijn.

Afwijkingen die niet zijn uitgefilterd, worden verzonden in een waarschuwing.

Instellingen voor kruis metrische gegevens toevoegen

Selecteer + Instellingen voor kruis metrische gegevens toevoegen op de pagina met waarschuwingsinstellingen om nog een sectie toe te voegen.

De operator-selector is de logische relatie van elke sectie om te bepalen of ze een waarschuwing verzenden.

Volgende stappen

• Anomaliedetectie aanpassen met feedback
• Een incident diagnosticeren.
• Metrische gegevens configureren en detectieconfiguratie afstemmen