Avvio rapido: Creare avvisi del log attività per le notifiche del servizio usando un file Bicep
Questo articolo descrive come impostare gli avvisi del log attività per le notifiche sull'integrità dei servizi 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.
- Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.
- Per eseguire i comandi dal computer locale, installare l'interfaccia della riga di comando di Azure o i moduli di Azure PowerShell. Per altre informazioni, vedere Installare l'interfaccia della riga di comando di Azure e Installare Azure PowerShell.
Il file Bicep seguente crea un gruppo di azioni con la destinazione del messaggio di posta elettronica e abilita tutte le notifiche sull'integrità dei servizi per la sottoscrizione di destinazione. Salvare questo file 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 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'
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
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
- Informazioni sulle procedure consigliate per la configurazione degli avvisi di Integrità dei servizi di Azure.
- Informazioni su come configurare le notifiche push su dispositivi mobili per Integrità dei servizi di Azure.
- Informazioni su come configurare le notifiche di webhook per i sistemi di gestione dei problemi esistenti.
- Informazioni sulle notifiche per l'integrità del servizio.
- Informazioni sulla limitazione della frequenza delle notifiche.
- Esaminare lo schema webhook degli avvisi del log attività.
- Leggere una panoramica degli avvisi del log attività e informazioni su come ricevere gli avvisi.
- Altre informazioni sui gruppi di azione.