Gerenciar pré e pós-eventos de configuração de manutenção (versão prévia)

Aplica-se a: ✔️ VMs do Windows ✔️ VMs do Linux ✔️ Ambiente local ✔️ VMs do Azure ✔️ Servidores habilitados para Azure Arc ✔️ VMs do Azure.

Este artigo descreve como registrar sua assinatura e gerenciar os pré e pós-eventos no Gerenciador de Atualizações do Azure.

Registre sua assinatura para visualização pública

Para registrar sua assinatura para visualização pública, siga estas etapas:

Portal do Azure

1. Entre no portal do Azure e selecione Mais serviços.

2. Na página Todos os serviços, pesquise Recursos de visualização.

3. Na página Recursos de visualização, pesquise e selecione Pré e Pós Eventos.

4. Selecione o recurso e selecione Registrar para registrar a assinatura.

   

CLI do Azure

az feature register --name InGuestPatchPrePostMaintenanceActivity --namespace Microsoft.Maintenance

PowerShell

Register-AzProviderFeature -FeatureName "InGuestPatchPrePostMaintenanceActivity" -ProviderNamespace "Microsoft.Maintenance"

Gerenciar pré e pós-eventos

Exibir eventos pré e pós

Para visualizar os eventos pré e pós, siga essas etapas:

1. Entre no portal do Azure e vá para Azure Update Manager.

2. Em Gerenciar, selecione Máquinas, Configurações de Manutenção.

3. Na página Configuração de manutenção, selecione a configuração de manutenção à qual você deseja adicionar um pré e pós-evento.

4. Selecione Visão geral e verifique os Eventos de manutenção. Você pode exibir a contagem dos pré e pós-eventos associados à configuração.

   

5. Selecione a contagem de pré e pós-eventos para exibir a lista de eventos e os tipos de evento.

   

Editar os pré e pós-eventos

Para editar os pré e pós-eventos, siga estas etapas:

1. Siga as etapas listadas em Exibir os pré e pós-eventos.
2. Na página de eventos selecionados, selecione o evento anterior ou posterior que você deseja editar.
3. Na página pré ou pós-evento selecionada, você pode editar o manipulador de eventos/ponto de extremidade usado ou a localização do ponto de extremidade.

Gerenciar a execução de pré/pós-evento e agendar a execução

Para verificar a entrega bem-sucedida de um pré e pós-evento a um ponto de extremidade da Grade de Eventos, siga estes passos:

1. Entre no portal do Azure e vá para Azure Update Manager.
2. Em Gerenciar, selecione Computadores.
3. Selecione Configurações de manutenção na faixa de opções na parte superior.
4. Na página Configuração de manutenção, selecione a configuração de manutenção para a qual você deseja exibir o pré e pós-evento.
5. Na página Configuração de manutenção selecionada, em Configurações no ToC, selecione Eventos.
6. Na seção Elementos essenciais, você pode exibir as métricas de todos os eventos da assinatura de evento selecionada. No grafo, a contagem da métrica de Eventos Publicados deve corresponder à contagem da métrica de Eventos Correspondentes. Ambos os valores também devem corresponder à contagem de Eventos Entregues.
7. Para exibir as métricas específicas de um pré ou pós-evento, selecione o nome do evento na grade. Aqui, a contagem da métrica de Eventos Correspondentes deve corresponder à contagem de Eventos Entregues.
8. Para exibir a hora em que o evento foi disparado, passe o mouse sobre o grafo de linha. Saiba mais.

Observação

A Grade de Eventos do Azure segue um paradigma de entrega pelo menos uma vez. Isso implica que, em circunstâncias excepcionais, existe a possibilidade do manipulador de eventos ser invocado mais de uma vez para um determinado evento. Recomendamos que você garanta que as ações do manipulador de eventos sejam idempotentes. Em outras palavras, se o manipulador de eventos for executado várias vezes, ele não deverá ter efeitos adversos. A implementação da idempotência garante a robustez do seu aplicativo diante de possíveis invocações de eventos duplicados.

Para verificar se o ponto de extremidade foi disparado e concluído no pré ou pós-evento

Runbooks de Automação via Webhooks

1. Entre no portal do Azure e acesse a conta da Automação do Azure.

2. Em sua conta de Automação, em Automação de Processos, selecione Runbooks.

3. Selecione o pré ou pós-script vinculado ao seu Webhook na Grade de Eventos.

4. Em Visão geral, você pode exibir o status do trabalho do Runbook. O tempo de gatilho deve ser aproximadamente 30 minutos antes do horário de início do agendamento. Depois que o trabalho for concluído, você poderá voltar para a mesma seção para confirmar se o status está Concluído. Por exemplo, verifique se a VM foi ativada ou desativada.

   

   Para obter mais informações sobre como recuperar detalhes do log de atividades e dos estados de trabalho da conta de Automação, confira Gerenciar runbooks na Automação do Azure.

Azure Functions

1. Entre no portal do Azure e vá para seu aplicativo de funções do Azure.
2. Em seu aplicativo de funções do Azure, acesse a página Visão geral.
3. Selecione a função específica na grade na página Visão geral.
4. Na coluna Monitor, selecione Invocações e muito mais.
5. Isso levará você à guia Invocações, que exibe os detalhes de execução e o status da função.

Para usar insights de aplicativo para monitorar execuções em funções do Azure, consulte aqui.

Cancelar uma execução de agendamento antes de começar a ser executada

Para cancelar a execução do agendamento, a API de cancelamento no seu pré-evento deve ser disparada pelo menos 10 minutos antes do horário de início da configuração de manutenção do agendamento. Você deve chamar a API de cancelamento no seu pré-evento, ou seja, script Runbook ou código de função do Azure.

Cancelar a execução de manutenção de agendamento

Portal do Azure

1. Entre no portal do Azure e vá para Azure Update Manager.
2. Em Gerenciar no ToC, selecione Histórico.
3. Selecione a guia Por ID de execução de manutenção e selecione a ID de execução de manutenção cujo histórico você deseja exibir.
4. Selecione Cancelar atualização de agendamento. Essa opção está habilitada por 10 minutos antes do início da configuração de manutenção.

REST API

Aplicar atualizações – Criar, Atualizar ou Cancelar – API REST (Manutenção do Azure) | Microsoft Learn

PowerShell

New-AzApplyUpdate (Az.Maintenance) | Microsoft Learn

CLI

az maintenance applyupdate | Microsoft Learn

Você pode obter a lista de computadores na execução de manutenção da consulta ARG a seguir. Você também pode exibir a ID de correlação selecionando Exibir detalhes:

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

Observação

O Gerenciador de Atualizações do Azure ou a configuração de manutenção não irá monitorar e cancelar automaticamente o agendamento. Se o usuário não cancelar, a execução agendada prosseguirá com a instalação das atualizações durante a janela de manutenção definida pelo usuário.

Execução pós-agendamento

Exibir o histórico de pré e pós-eventos

1. Entre no portal do Azure e vá para Azure Update Manager.
2. Em Gerenciar, selecione Histórico.
3. Selecione a guia Por ID de execução de manutenção, escolha a ID de execução de manutenção cujo histórico você deseja exibir.
4. Selecione a guia Eventos nesta página de histórico da ID de execução de manutenção selecionada.
5. Você pode exibir a contagem de eventos e os nomes dos eventos junto com o tipo de evento e os detalhes do ponto de extremidade.

Depurar os pré e pós-eventos

Automation-Webhook

Para exibir o histórico de trabalhos de um evento criado por meio do Webhook, siga estas etapas:

1. Localize o nome do evento para o qual você deseja exibir os logs de trabalho.
2. Na coluna Histórico de trabalho, selecione Exibir histórico de runbook correspondente ao nome do evento. Isso leva você à conta de Automação onde residem os runbooks.
3. Selecione o nome específico do runbook que está associado ao pré ou pós-evento. Na página visão geral, você pode exibir os trabalhos recentes do runbook juntamente com os detalhes de execução e status.

Azure Function

Para exibir o histórico de um evento criado por meio da Função do Azure, siga estas etapas:

1. Localize o nome do evento para o qual você deseja exibir os logs de trabalho.
2. Na coluna Histórico de trabalho, selecione Exibir o histórico de funções do Azure correspondente ao nome do evento. Isso leva você à página Invocações de função do Azure.
3. Você pode exibir as invocações recentes junto com os detalhes de execução e status.

Exibir o status de uma execução de agendamento cancelada

1. Entre no portal do Azure e vá para Azure Update Manager.
2. Em Gerenciar, selecione Histórico.
3. Selecione a guia Por ID de execução de manutenção e selecione a ID de execução de manutenção cujo status você deseja exibir.
4. Consulte o Status para exibir o status. Se a execução de manutenção tiver sido cancelada, o status será exibido como cancelado. Selecione o status para exibir os detalhes.

Existem dois tipos de cancelamentos:

• Cancelamento pelo usuário: quando você invoca a API de cancelamento do seu script ou código.
• Cancelamento pelo sistema: quando o sistema invoca a API de cancelamento devido a um erro interno. Isso será feito somente se o sistema não conseguir enviar o pré-evento ao ponto de extremidade do cliente, 30 minutos antes do trabalho de correção agendado. Nesse caso, a próxima configuração de manutenção agendada será cancelada devido à falha na execução dos pré-eventos pelo sistema.

Para confirmar se o cancelamento é por usuário ou sistema, você pode exibir o status da ID de execução de manutenção na consulta ARG mencionada acima em Exibir detalhes. A mensagem de erro exibe se a execução agendada foi cancelada pelo usuário ou pelo sistema e o campo de status confirma o status da execução de manutenção.

A imagem acima mostra um exemplo de cancelamento por parte do usuário, onde a mensagem de erro seria Manutenção cancelada usando a API de cancelamento em AAAA-MM-DD. Se a execução de manutenção for cancelada pelo sistema por qualquer motivo, a mensagem de erro no JSON seria Manutenção cancelada devido a falha interna da plataforma em YYYY-MM-DD.

Excluir antes e depois do evento

Como usar o portal do Azure

Para excluir eventos anteriores e posteriores, siga essas etapas:

1. Entre no portal do Azure e vá para Azure Update Manager.

2. Em Gerenciar, selecione Máquinas, Configurações de Manutenção.

3. Na página Configuração de manutenção, selecione a configuração de manutenção à qual você deseja adicionar um pré e pós-evento.

4. Na página Configuração de manutenção selecionada, em Configurações, escolha Eventos.

5. Selecione o evento Nome que deseja excluir da grade.

6. Na página do evento selecionado, selecione Excluir.

   

Como usar o PowerShell

Remover a Assinatura do evento

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

Remover o tópico do sistema

    Remove-AzEventGridSystemTopic -Name $SystemTopicName -ResourceGroupName $ResourceGroupForSystemTopic

Usando a CLI

Remover a assinatura do evento

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

Remover o tópico do sistema

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

Usar a API REST

Exclusão da assinatura do evento

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

Exclusão do tópico do sistema

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

Próximas etapas

• Para obter uma visão geral dos eventos pré e pós no Gerenciador de Atualizações do Azure, consulte aqui
• Para saber como criar os pré e pós-eventos, confira eventos de configuração de pré e pós-manutenção.
• Para saber como usar os pré e pós-eventos para ativar e desativar suas VMs usando Webhooks, consulte aqui.
• Para saber como usar pré e pós-eventos para ativar e desativar suas VMs usando o Azure Functions, consulte aqui.