Share via

Guida introduttiva: Creare avvisi del log attività per le notifiche del servizio usando un file Bicep

  • Articolo

Questo articolo illustra come configurare gli avvisi del log attività per le notifiche sull'integrità del servizio usando un file Bicep.

Bicep è un linguaggio specifico di dominio (DSL) che usa la sintassi dichiarativa per distribuire le risorse di Azure. Offre sintassi concisa, indipendenza dai tipi affidabile e supporto per il riutilizzo del codice. Bicep offre la migliore esperienza di creazione per le soluzioni di infrastruttura come codice in Azure.

Le notifiche sull'integrità del servizio vengono archiviate nel log attività di Azure. Poiché le informazioni archiviate nel log attività possono raggiungere volumi elevati, è disponibile un'interfaccia utente separata che facilita la visualizzazione e la configurazione degli avvisi per le notifiche sull'integrità del servizio.

È possibile ricevere un avviso quando Azure invia le notifiche sull'integrità del servizio alla sottoscrizione di Azure. È possibile configurare l'avviso in base a:

  • La classe di notifica dell'integrità del servizio (problemi del servizio, manutenzione pianificata, avvisi di integrità).
  • La sottoscrizione interessata.
  • I servizi interessati.
  • Le aree interessate.

Nota

Le notifiche sull'integrità del servizio non inviano un avviso relativo a eventi di integrità delle risorse.

È anche possibile configurare l'utente a cui deve essere inviato l'avviso:

  • Selezionare un gruppo di azione esistente.
  • Creare un nuovo gruppo di azione che può essere usato per avvisi futuri.

Per altre informazioni sui gruppi di azioni, vedere Creare e gestire gruppi di azioni.

Prerequisiti

Esaminare il file Bicep

Il file Bicep seguente crea un gruppo di azioni con una destinazione di posta elettronica e abilita tutte le notifiche di integrità del servizio per la sottoscrizione di destinazione. Salvare questo bicep come 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
  }
}

Il file Bicep definisce due risorse:

Distribuire il file Bicep

Distribuire il file Bicep usando l'interfaccia della riga di comando di Azure e Azure PowerShell. Sostituire i valori di esempio di ResourceGroupName e emailAddress con quelli appropriati per l'ambiente in uso.

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

Convalidare la distribuzione

Per verificare che l'area di lavoro sia stata creata, usare uno dei comandi seguenti. Sostituire il valore di esempio di Resource Group con quello usato in precedenza.

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

Pulire le risorse

Se si prevede di usare le guide di avvio rapido e le esercitazioni successive, è consigliabile non cancellare le risorse create. Quando non è più necessario, eliminare il gruppo di risorse per eliminare la regola di avviso e le risorse correlate. Per eliminare il gruppo di risorse con l'interfaccia della riga di comando di Azure oppure con Azure PowerShell

az group delete --name my-resource-group

Passaggi successivi