Delen via

Waarschuwingen aanmaken voor activiteitenlogboeken op basis van servicemeldingen met een Bicep-bestand

Overzicht

Dit artikel biedt een stapsgewijze handleiding voor het gebruik van een Bicep-bestand om activiteitenlogboekwaarschuwingen voor Azure Service Health-meldingen te maken. Het doel is om het maken van waarschuwingen te automatiseren om u op de hoogte te stellen wanneer Azure servicestatus-gebeurtenissen (zoals incidenten, gepland onderhoud of statusadviezen) in het activiteitenlogboek van uw abonnement plaatst.

Bicep is een domeinspecifieke taal (DSL) die declaratieve syntaxis gebruikt om Azure-resources te implementeren. Deze taal voorziet in een beknopte syntaxis, betrouwbare typeveiligheid en ondersteuning voor hergebruik van code. Bicep biedt de beste ontwerpervaring voor uw infrastructuur als code-oplossingen in Azure.

Servicestatusmeldingen worden opgeslagen in het Activiteitenlogboek van Azure. Gezien de mogelijk grote hoeveelheid informatie die is opgeslagen in het activiteitenlogboek, is er een afzonderlijke gebruikersinterface om het gemakkelijker te maken om waarschuwingen voor servicestatusmeldingen weer te geven en in te stellen.

U kunt een waarschuwing ontvangen wanneer Azure servicestatusmeldingen verzendt naar uw Azure-abonnement. U kunt de waarschuwing configureren op basis van:

  • De klasse van servicestatusmeldingen (serviceproblemen, gepland onderhoud, statusadviezen).
  • Het betrokken abonnement.
  • De betrokken services.
  • De betrokken regio's.

Notitie

Servicestatusmeldingen verzenden geen waarschuwingen met betrekking tot resourcestatus-gebeurtenissen.

U kunt ook configureren naar wie de waarschuwing moet worden verzonden:

  • Selecteer een bestaande actiegroep.
  • Maak een nieuwe actiegroep maken (die kan worden gebruikt voor toekomstige waarschuwingen).

Raadpleeg Actiegroepen maken en beheren voor meer informatie over actiegroepen.

Stel het Bicep-bestand in

Voorwaarden

1. Controleer het Bicep-bestand

Met het volgende Bicep-bestand wordt een actiegroep gemaakt met een e-maildoel en worden alle servicestatusmeldingen voor het doelabonnement ingeschakeld. Sla deze Bicep op als CreateServiceHealthAlert.bicep.

param actionGroups_name string = 'SubHealth'
param activityLogAlerts_name string = 'ServiceHealthActivityLogAlert'
param emailAddress string

var alertScope = '/subscriptions/${subscription().subscriptionId}'

resource actionGroups_name_resource 'microsoft.insights/actionGroups@2019-06-01' = {
  name: actionGroups_name
  location: 'Global'
  properties: {
    groupShortName: actionGroups_name
    enabled: true
    emailReceivers: [
      {
        name: actionGroups_name
        emailAddress: emailAddress
      }
    ]
    smsReceivers: []
    webhookReceivers: []
  }
}

resource activityLogAlerts_name_resource 'microsoft.insights/activityLogAlerts@2017-04-01' = {
  name: activityLogAlerts_name
  location: 'Global'
  properties: {
    scopes: [
      alertScope
    ]
    condition: {
      allOf: [
        {
          field: 'category'
          equals: 'ServiceHealth'
        }
        {
          field: 'properties.incidentType'
          equals: 'Incident'
        }
      ]
    }
    actions: {
      actionGroups: [
        {
          actionGroupId: actionGroups_name_resource.id
          webhookProperties: {}
        }
      ]
    }
    enabled: true
  }
}

Het Bicep-bestand definieert twee resources:

2. Het Bicep-bestand implementeren

Implementeer het Bicep-bestand met behulp van Azure CLI en Azure PowerShell. Vervang de voorbeeldwaarden voor resourcegroep en emailAddress door de juiste waarden voor uw omgeving:

az login
az deployment group create --name CreateServiceHealthAlert --resource-group my-resource-group --template-file CreateServiceHealthAlert.bicep --parameters emailAddress='user@contoso.com'

3. De implementatie valideren

Controleer of de werkruimte is gemaakt met een van de volgende opdrachten. Vervang de voorbeeldwaarden voor de resourcegroep door de waarde die u hier hebt gebruikt:

az monitor activity-log alert show --resource-group my-resource-group --name ServiceHealthActivityLogAlert

4. De middelen opschonen

Als u van plan bent om verder te gaan met volgende snelstarts en zelfstudies, kunt u deze resources het beste intact laten. Als u een resourcegroep niet meer nodig hebt, verwijdert u de resourcegroep. Hiermee worden ook de waarschuwingsregel en de gerelateerde resources verwijderd. Als u de resourcegroep wilt verwijderen met behulp van Azure CLI of Azure PowerShell, gebruikt u de volgende opdrachten:

az group delete --name my-resource-group

Volgende stappen