Algemeen waarschuwingsschema

In dit artikel wordt beschreven wat het algemene waarschuwingsschema is, wat de voordelen zijn van het gebruik ervan en hoe u dit kunt inschakelen.

Wat is het algemene waarschuwingsschema?

Het algemene waarschuwingsschema standaardiseer vandaag de dag de verbruikservaring voor waarschuwingsmeldingen in Azure. In het verleden hadden de drie waarschuwingstypen in Azure (metrische gegevens, logboeken en activiteitenlogboek) hun eigen e-mailsjablonen, webhookschema's, enzovoort. Met het algemene waarschuwingsschema kunt u nu waarschuwingsmeldingen met een consistent schema ontvangen.

Een waarschuwings exemplaar beschrijft de resource die is beïnvloed en de oorzaak van de waarschuwing. Deze exemplaren worden beschreven in het algemene schema in de volgende secties:

  • Essentials: een set gestandaardiseerde velden, gemeenschappelijk voor alle waarschuwingstypen, waarin wordt beschreven welke resource de waarschuwing gebruikt, samen met aanvullende algemene metagegevens van waarschuwingen (bijvoorbeeld ernst of beschrijving).
  • Waarschuwingscontext: een set velden waarin de oorzaak van de waarschuwing wordt beschreven, met velden die variëren op basis van het waarschuwingstype. Een waarschuwing voor metrische gegevens zou bijvoorbeeld velden bevatten zoals de metrische naam en metrische waarde in de context van de waarschuwing, terwijl een waarschuwing voor activiteitenlogboek informatie zou bevatten over de gebeurtenis die de waarschuwing heeft gegenereerd.

De typische integratiescenario's die we van klanten horen, hebben betrekking op de routering van de waarschuwings-instantie naar het betrokken team op basis van een draaipunt (bijvoorbeeld resourcegroep), waarna het verantwoordelijke team verantwoordelijk aan de slag gaat. Met het algemene waarschuwingsschema kunt u gestandaardiseerde routeringslogica voor waarschuwingstypen hebben door gebruik te maken van de essentiële velden, zodat de contextvelden voor de betreffende teams verder kunnen worden onderzocht.

Dit betekent dat u mogelijk minder integraties kunt hebben, waardoor het proces van het beheren en onderhouden ervan een veel eenvoudigere taak wordt. Daarnaast komen toekomstige verrijkingen van de nettolading van waarschuwingen (bijvoorbeeld aanpassing, diagnostische verrijking, enzovoort) alleen beschikbaar in het algemene schema.

Welke verbeteringen brengt het algemene waarschuwingsschema met zich mee?

Het algemene waarschuwingsschema manifesteert zich voornamelijk in uw waarschuwingsmeldingen. De verbeteringen die u ziet, worden hieronder weergegeven:

Bewerking Verbeteringen
E-mail Een consistente en gedetailleerde e-mailsjabloon, zodat u eenvoudig in één oogopslag problemen kunt diagnosticeren. Ingesloten dieptekoppelingen naar het waarschuwings exemplaar in de portal en de betrokken resource zorgen ervoor dat u snel naar het herstelproces kunt gaan.
Webhook/logische app/Azure Function/Automation-runbook Een consistente JSON-structuur voor alle waarschuwingstypen, waarmee u eenvoudig integraties kunt bouwen in de verschillende waarschuwingstypen.

Het nieuwe schema biedt ook een rijkere ervaring voor het gebruik van waarschuwingen in zowel de Azure Portal als de Azure mobile app in de nabije toekomst.

Meer informatie over de schemadefinities voor webhooks/Logic Apps/Azure Functions/Automation-runbooks.

Notitie

De volgende acties bieden geen ondersteuning voor het algemene waarschuwingsschema: ITSM-connector.

Hoe kan ik algemene waarschuwingsschema inschakelen?

U kunt zich via actiegroepen in- of uitmelden voor het algemene waarschuwingsschema, zowel in de portal als via de REST API. De wisselknop om over te schakelen naar het nieuwe schema bestaat op actieniveau. U moet bijvoorbeeld afzonderlijk kiezen voor een e-mailactie en een webhookactie.

Notitie

  1. De volgende waarschuwingstypen ondersteunen standaard het algemene schema (geen opt-in vereist):
    • Waarschuwingen voor slimme detectie
  2. De volgende waarschuwingstypen bieden momenteel geen ondersteuning voor het algemene schema:

Via de Azure Portal

Algemene waarschuwingsschema-opt-in

  1. Open een bestaande of een nieuwe actie in een actiegroep.
  2. Selecteer Ja voor de schakelknop om het algemene waarschuwingsschema in te schakelen, zoals wordt weergegeven.

Via de REST API

U kunt ook de API voor actiegroepen gebruiken om u aan temelden voor het algemene waarschuwingsschema. Tijdens het maken of bijwerken van de REST API-aanroep, kunt u de vlag useCommonAlertSchema instellen op 'true' (om u aan te geven) of 'false' (om op te geven) voor een van de volgende acties: e-mail/webhook/logische app/Azure Function/automation-runbook.

Met de volgende aanvraag voor het maken of bijwerken van REST API wordt bijvoorbeeld het volgende gedaan:

  • Schakel het algemene waarschuwingsschema in voor de e-mailactie 'John Doe's email'
  • Schakel het algemene waarschuwingsschema uit voor de e-mailactie 'Het e-mailadres van Jane Smith'
  • Schakel het algemene waarschuwingsschema in voor de webhookactie 'Voorbeeldwebhook'
{
  "properties": {
    "groupShortName": "sample",
    "enabled": true,
    "emailReceivers": [
      {
        "name": "John Doe's email",
        "emailAddress": "johndoe@email.com",
        "useCommonAlertSchema": true
      },
      {
        "name": "Jane Smith's email",
        "emailAddress": "janesmith@email.com",
        "useCommonAlertSchema": false
      }
    ],
    "smsReceivers": [
      {
        "name": "John Doe's mobile",
        "countryCode": "1",
        "phoneNumber": "1234567890"
      },
      {
        "name": "Jane Smith's mobile",
        "countryCode": "1",
        "phoneNumber": "0987654321"
      }
    ],
    "webhookReceivers": [
      {
        "name": "Sample webhook",
        "serviceUri": "http://www.example.com/webhook",
        "useCommonAlertSchema": true
      }
    ]
  },
  "location": "Global",
  "tags": {}
}

Volgende stappen