Gestire eventi di configurazione di eventi pre e post manutenzione

Si applica a: ✔️ Macchine virtuali Windows ✔️ Macchine virtuali Linux ✔️ Ambiente locale ✔️ Server abilitati per Azure Arc ✔️ Macchine virtuali Azure.

Questo articolo descrive come gestire gli eventi pre e post in Gestione aggiornamenti di Azure.

Gestire eventi pre e post

Visualizzare gli eventi pre e post

Per visualizzare gli eventi pre e post, seguire questa procedura:

1. Accedere al portale di Azure e passare a Gestore aggiornamenti di Azure.

2. In Gestisci, selezionare Computer, Configurazioni di manutenzione.

3. Nella pagina Configurazione manutenzione selezionare la configurazione della manutenzione a cui si desidera aggiungere un evento pre e post.

4. Selezionare Panoramica e controllare gli eventi di manutenzione. È possibile visualizzare il conteggio degli eventi pre e post associati alla configurazione.

   

5. Selezionare il conteggio degli eventi pre e post per visualizzare l'elenco degli eventi e i tipi di evento.

   

Modificare eventi pre e post

Per modificare eventi pre e post, seguire questi passaggi:

1. Seguire i passaggi elencati in Visualizzare eventi pre e post.
2. Nella pagina degli eventi selezionata, selezionare l'evento pre o post da modificare.
3. Nella pagina dell'evento pre o post selezionata, è possibile modificare il gestore eventi o l'endpoint usati o la posizione dell'endpoint.

Gestire l'esecuzione di eventi pre e post e l'esecuzione della pianificazione

Per assicurarsi del corretto recapito di un evento pre e post a un endpoint da Griglia di eventi, seguire questi passaggi:

1. Accedere al portale di Azure e passare a Gestore aggiornamenti di Azure.
2. In Gestisci, selezionare Computer.
3. Selezionare Configurazioni manutenzione dalla barra multifunzione nella parte superiore.
4. Nella pagina Configurazione manutenzione, selezionare la configurazione della manutenzione per cui si desidera visualizzare un evento pre e post.
5. Nella pagina Configurazione manutenzione selezionata, in Impostazioni nel sommario selezionare Eventi.
6. Nella sezione Informazioni essenziali è possibile visualizzare le metriche per tutti gli eventi nella sottoscrizione eventi selezionata. Nel grafico, il conteggio della metrica Eventi pubblicati deve corrispondere al conteggio della metrica Eventi corrispondenti. Entrambi i valori devono corrispondere anche al conteggio degli eventi recapitati.
7. Per visualizzare le metriche specifiche di un evento pre o post, selezionare il nome dell'evento dalla griglia. In questo caso, il numero di metriche degli eventi corrispondenti deve corrispondere al conteggio degli eventi recapitati.
8. Per visualizzare l'ora in cui è stato attivato l'evento, passare il puntatore del mouse sul grafico a linee. Altre informazioni.

Nota

Griglia di eventi di Azure è conforme a un paradigma di recapito at-least-once. Ciò implica che in circostanze eccezionali è possibile che il gestore eventi venga richiamato più volte per un determinato evento. È consigliabile assicurarsi che le azioni del gestore eventi siano idempotenti. In altre parole, se il gestore eventi viene eseguito più volte, non deve avere alcun effetto avverso. L'implementazione dell'idempotenza garantisce la solidità dell'applicazione in caso di potenziali chiamate di eventi duplicati.

Per controllare se l'endpoint è stato attivato e completato nell'evento pre o post

Runbook di automazione tramite webhook

1. Accedere al portale di Azure e passare all'account di Automazione di Azure.

2. Nell'account di Automazione, in Automazione processo selezionare Runbook.

3. Selezionare lo script pre o post collegato al webhook in Griglia di eventi.

4. In Panoramica è possibile visualizzare lo stato del processo runbook. L'ora di attivazione deve essere circa 30 minuti prima dell'ora di inizio della pianificazione. Al termine del processo, è possibile tornare alla stessa sezione per controllare se lo stato è Completato. Ad esempio, assicurarsi che la VM sia stata accesa o spenta.

   

   Per altre informazioni su come recuperare i dettagli dagli stati dei processi e dal log attività dell'account di Automazione, vedere Gestire runbook in Automazione di Azure.

Funzioni di Azure

1. Accedere al portale di Azure e passare all'app per le funzioni di Azure.
2. Nell'app per le funzioni di Azure, passare alla pagina Panoramica.
3. Selezionare la funzione specifica dalla griglia nella pagina Panoramica.
4. Nella colonna Monitoraggio, selezionare Chiamate e altro.
5. Verrà visualizzata la scheda Chiamate, che mostra i dettagli di esecuzione e lo stato della funzione.

Per usare Application Insights per monitorare le esecuzioni nelle funzioni di Azure, vedere qui.

Annullare un'esecuzione della pianificazione prima del suo inizio

Per annullare l'esecuzione pianificata, l'API di annullamento nel pre-evento deve essere attivata almeno 10 minuti prima dell'orario di inizio della configurazione della manutenzione pianificata. È necessario chiamare l'API di annullamento nell'evento pre, vale a dire lo script runbook o il codice della funzione di Azure.

Per annullare l'esecuzione della manutenzione pianificata

Azure portal

1. Accedere al portale di Azure e passare a Gestore aggiornamenti di Azure.
2. Nel Sommario, andare su Gestisci e selezionare Cronologia.
3. Selezionare la scheda In base all’ID esecuzione manutenzione e selezionare l'ID di esecuzione cui si vuole visualizzare la cronologia.
4. Selezionare Annulla aggiornamento pianificato. Questa opzione è abilitata per 10 minuti prima dell’inizio della configurazione della manutenzione.

REST API

Applicare aggiornamenti - Creare o aggiornare o annullare - API REST (manutenzione di Azure) | Microsoft Learn

PowerShell

New-AzApplyUpdate (Az.Maintenance) | Microsoft Learn

CLI

az maintenance applyupdate | Microsoft Learn

È possibile ottenere l'elenco dei computer nell'esecuzione della manutenzione dalla query ARG seguente. È anche possibile visualizzare l'ID di correlazione selezionando Visualizza dettagli:

maintenanceresources  
| where type =~ "microsoft.maintenance/maintenanceconfigurations/applyupdates"  
| where properties.correlationId has "/subscriptions/your- subscription -id/resourcegroups/your- ResourceGroupName/providers/microsoft.maintenance/maintenanceconfigurations/mc-name/providers/microsoft.maintenance/applyupdates/"  
| order by name desc

Nota

Gestione aggiornamenti di Azure o la configurazione della manutenzione non monitorano né annullano automaticamente la pianificazione. Se l'utente non riesce ad effettuare l’annullamento, l'esecuzione della pianificazione procederà con l'installazione degli aggiornamenti durante la finestra di manutenzione definita dall'utente.

Esecuzione post-pianificazione

Visualizzare la cronologia di eventi pre e post

1. Accedere al portale di Azure e passare a Gestore aggiornamenti di Azure.
2. In Gestisci, selezionare Cronologia.
3. Selezionare la scheda Per ID esecuzione manutenzione e selezionare l'ID di esecuzione della manutenzione per cui si desidera visualizzare la cronologia.
4. Selezionare la scheda Eventi in questa pagina della cronologia dell'ID esecuzione della manutenzione selezionato.
5. È possibile visualizzare il conteggio di eventi e nomi di eventi insieme al tipo di evento e ai dettagli dell'endpoint.

Eseguire il debug di eventi pre e post

Automazione - Webhook

Per visualizzare la cronologia del processo di un evento creato tramite webhook, seguire questi passaggi:

1. Trovare il nome dell'evento per il quale si desidera visualizzare i log del processo.
2. Nella colonna Cronologia processi, selezionare Visualizza cronologia runbook corrispondente al nome dell'evento. Verrà visualizzato l'account di Automazione in cui risiedono i runbook.
3. Selezionare il nome specifico del runbook associato all'evento pre o post. Nella pagina di panoramica, è possibile visualizzare i processi recenti del runbook insieme ai dettagli dell'esecuzione e dello stato.

Funzione di Azure

Per visualizzare la cronologia di un evento creato tramite Funzione di Azure, seguire questi passaggi:

1. Trovare il nome dell'evento per il quale si desidera visualizzare i log del processo.
2. Nella colonna Cronologia processi, selezionare Visualizza cronologia Funzione di Azure corrispondente al nome dell'evento. Verrà visualizzata la pagina Chiamate della funzione di Azure.
3. È possibile visualizzare le chiamate recenti insieme ai dettagli dell'esecuzione e dello stato.

Visualizzare lo stato di un'esecuzione di pianificazione annullata

1. Accedere al portale di Azure e passare a Gestore aggiornamenti di Azure.
2. In Gestisci, selezionare Cronologia.
3. Selezionare la scheda Per ID esecuzione manutenzione e selezionare l'ID di esecuzione della manutenzione per cui si desidera visualizzare lo stato.
4. Per visualizzare lo stato, fare riferimento a Stato. Se l'esecuzione della manutenzione è stata annullata, lo stato verrà visualizzato come annullato. Selezionare lo stato per visualizzare i dettagli.

Esistono due tipi di annullamento:

• Annullamento da parte dell'utente: quando si richiama l'API di annullamento dallo script o dal codice.
• Annullamento da parte del sistema: quando il sistema richiama l'API di annullamento a causa di un errore interno. Questa operazione viene eseguita solo se il sistema non è in grado di inviare l'evento pre al punto finale del cliente, vale a dire 30 minuti prima del processo di applicazione di patch pianificato. In questo caso, la successiva configurazione della manutenzione pianificata verrà annullata a causa dell'errore di esecuzione degli eventi pre da parte del sistema.

Per assicurarsi che l'annullamento sia stato effettuato dall'utente o dal sistema, è possibile visualizzare lo stato dell'ID di esecuzione della manutenzione dalla query ARG menzionata in precedenza in Vedi dettagli. Il messaggio di errore indica se l'esecuzione della pianificazione è stata annullata dall'utente o dal sistema e il campo stato conferma lo stato dell'esecuzione della manutenzione.

L'immagine precedente mostra un esempio di annullamento da parte dell'utente, in cui il messaggio di errore sarebbe Manutenzione annullata tramite l'API di annullamento in data AAAA-MM-GG. Se l'esecuzione della manutenzione viene annullata dal sistema per un motivo qualsiasi, il messaggio di errore nel JSON sarebbe Manutenzione annullata a causa di un errore interno della piattaforma in data AAAA-MM-GG.

Elimina pre e post-evento

Con il portale di Azure

Per eliminare gli eventi pre e post, seguire questa procedura:

1. Accedere al portale di Azure e passare a Gestore aggiornamenti di Azure.

2. In Gestisci, selezionare Computer, Configurazioni di manutenzione.

3. Nella pagina Configurazione manutenzione selezionare la configurazione di manutenzione a cui si vuole aggiungere un evento preliminare e post.

4. Nella pagina Configurazione manutenzione selezionata, in Impostazioni selezionare Eventi.

5. Selezionare l'evento Nome che si desidera eliminare dalla griglia.

6. Nella pagina dell'evento selezionato, selezionare Elimina.

   

Con PowerShell

Rimozione della sottoscrizione eventi

    Remove-AzEventGridSystemTopicEventSubscription -EventSubscriptionName $EventSubscriptionName -ResourceGroupName $ResourceGroupForSystemTopic -SystemTopicName $SystemTopicName

Rimuovere l'argomento di sistema

    Remove-AzEventGridSystemTopic -Name $SystemTopicName -ResourceGroupName $ResourceGroupForSystemTopic

Uso dell'interfaccia della riga di comando

Rimozione della sottoscrizione eventi

    az eventgrid system-topic event-subscription delete --name “<Event subscription name>” --resource-group $ResourceGroupName --system-topic-name     $SystemTopicName

Rimuovere l'argomento di sistema

    az eventgrid system-topic delete --name $SystemTopicName --resource-group $ResourceGroupName

Uso dell'API REST

Eliminazione della sottoscrizione eventi

    DELETE /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>/eventSubscriptions/<Event Subscription name>?api-version=2022-06-15

Eliminazione dell'argomento di sistema

    DELETE /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>;?api-version=2022-06-15

Passaggi successivi

• Per una panoramica degli eventi pre e post in Gestore aggiornamenti di Azure, vedere qui.
• Per informazioni su come creare eventi pre e post, vedere eventi di configurazione della manutenzione pre e post.
• Per informazioni su come usare gli eventi pre e post per attivare e disattivare le VM tramite webhook, vedere qui.
• Per informazioni su come usare gli eventi pre e post per attivare e disattivare le macchine virtuali usando Funzioni di Azure, vedere qui.