Compartilhar via

Visão geral dos logs de consulta no Azure Update Manager

  • Artigo

Os logs criados a partir de operações como avaliações de atualização e instalações são armazenados pelo Gerenciador de Atualização do Azure no Gráfico de Recursos do Azure. O Gráfico de Recursos é um serviço no Azure projetado para ser o repositório de detalhes do serviço do Azure sem qualquer custo ou requisitos de implantação. O Update Manager usa o Gráfico de Recursos para armazenar seus resultados. Você pode exibir o histórico de atualizações dos últimos 30 dias a partir dos recursos.

Este artigo descreve a estrutura dos logs do Update Manager e como você pode usar o Azure Resource Graph Explorer para analisá-los para dar suporte às suas necessidades de relatórios, visualização e exportação.

Estrutura de log

O Update Manager envia os resultados de todas as suas operações para o Gráfico de Recursos do Azure como logs, que ficam disponíveis por 30 dias. Aqui estão listadas a estrutura de logs que estão sendo enviados para o Gráfico de Recursos do Azure.

Resultados da avaliação de patch

A tabela patchassessmentresources inclui os recursos relacionados à avaliação de patch do computador. A tabela a seguir descreve suas propriedades.

Propriedade Descrição
ID A ID do Azure Resource Manager encaminhando o resultado. É semelhante ao caminho da API REST para avaliação do SO convidado. Normalmente, <resourcePath>/patchAssessmentResults/latest ou <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>.
NAME Se o ID for do tipo <resourcePath>/patchAssessmentResults/latest, o registro conterá o GUID exclusivo para a operação de avaliação concluída. Se <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>, o registro conterá o nome ou rótulo da atualização.
TYPE Especifica o tipo de log para avaliação. Se o tipo for patchassessmentresults, o registro fornece um resumo da avaliação do sistema operacional com estatísticas agregadas numéricas. Se o tipo for patchassessmentresults/softwarepatches, o registro descreve uma atualização específica do sistema operacional disponível para o recurso.
TENANTID ID do locatário do Azure para a VM do Azure ou o recurso de servidor habilitado para Azure Arc.
KIND Intencionalmente deixado em branco para uso futuro.
LOCATION Região de nuvem do Azure onde a VM do Azure ou o recurso de servidor habilitado para Azure Arc existe.
RESOURCEGROUP Grupo de recursos do Azure que hospeda a VM do Azure ou o recurso de servidor habilitado para Azure Arc.
SUBSCRIPTIONID ID de assinatura do Azure para a VM do Azure ou o recurso de servidor habilitado para Azure Arc.
MANAGEDBY Intencionalmente deixado em branco para uso futuro.
SKU Intencionalmente deixado em branco para uso futuro.
PLAN Intencionalmente deixado em branco para uso futuro.
PROPERTIES Captura detalhes da operação no formato JSON. Mais informações seguem esta tabela.
TAGS Marcas do Azure definidas para o recurso de servidores habilitados para VM do Azure ou Azure Arc.
IDENTITY Intencionalmente deixado em branco para uso futuro.
ZONES Intencionalmente deixado em branco para uso futuro.
EXTENDEDLOCATION Intencionalmente deixado em branco para uso futuro.

Descrição da propriedade patchassessmentresources

Se a propriedade do tipo de recurso for patchassessmentresources, ela incluirá as informações na tabela a seguir.

Valor Descrição
rebootPending Sinalizador para especificar se a atualização específica requer que o sistema operacional seja reinicializado para concluir a instalação. Conforme fornecido pelo serviço de atualização do SO da máquina ou pelo gerenciador de pacotes. Se o gerenciador de pacotes do SO ou o serviço de atualização não exigir uma reinicialização, o valor do campo será definido como false.
patchServiceUsed Serviço do SO usado na máquina para instalar atualizações. WU-WSUS para o serviço Windows Update ou Windows Server Update Service. Para Linux, é o gerenciador de pacotes do SO como YUM, APT ou Zypper.
osType Representa o tipo de sistema operacional: Windows ou Linux.
startDateTime Carimbo de data e hora (UTC) que representa quando a tarefa de avaliação de atualização do SO iniciou a execução na máquina.
lastModifiedDateTime Carimbo de data/hora (UTC) que representa quando o registro foi atualizado pela última vez.
startedBy Identifica se um usuário ou um serviço do Azure disparou a instalação da atualização do sistema operacional. Para obter mais informações sobre a operação, consulte Log de atividades do Azure.
errorDetails As primeiras cinco mensagens de erro geradas durante a execução da instalação da atualização do gerenciador de pacotes do SO da máquina ou do serviço de atualização.
availablePatchCountByClassification Número de atualizações do sistema operacional por categoria à qual as atualizações específicas pertencem com base no fornecedor do sistema operacional. O serviço de atualização do sistema operacional ou o gerenciador de pacotes da máquina gera as informações. Se o gerenciador de pacotes do sistema operacional ou o serviço de atualização não fornecer os detalhes da categoria, o valor será Others (para Linux) ou Updates (para Windows Server).

Se a propriedade do tipo de recurso for patchassessmentresults/softwarepatches, ela incluirá as informações na tabela a seguir.

Valor Descrição
lastModifiedDateTime Carimbo de data/hora (UTC) que representa quando o registro foi atualizado pela última vez.
publishedDateTime Carimbo de data e hora que representa quando a atualização específica foi disponibilizada pelo fornecedor do SO. O serviço de atualização do sistema operacional ou o gerenciador de pacotes da máquina gera as informações. Se o gerenciador de pacotes do sistema operacional ou o serviço de atualização não fornecer os detalhes de quando uma atualização foi fornecida pelo fornecedor do sistema operacional, o valor será nulo.
classifications Categoria à qual a atualização específica pertence de acordo com o fornecedor do sistema operacional. O serviço de atualização do sistema operacional ou o gerenciador de pacotes da máquina gera as informações. Se o gerenciador de pacotes do sistema operacional ou o serviço de atualização não fornecer os detalhes da categoria, o valor será Others (para Linux) ou Updates (para Windows Server).
rebootRequired O valor indica se a atualização específica requer que o sistema operacional seja reinicializado para concluir a instalação. O serviço de atualização do sistema operacional ou o gerenciador de pacotes da máquina gera as informações. Se o gerenciador de pacotes do sistema operacional ou o serviço de atualização não exigir uma reinicialização, o valor será false.
rebootBehavior O comportamento definido na instalação da atualização do sistema operacional executa o trabalho ao configurar a implantação da atualização se o Update Manager puder reinicializar a máquina de destino.
patchName Nome ou rótulo para a atualização específica gerada pelo gerenciador de pacotes do SO da máquina ou pelo serviço de atualização.
Kbid Se o sistema operacional do computador for Windows Server, o valor incluirá a ID de KB exclusiva para a atualização fornecida pelo serviço Windows Update.
version Se o sistema operacional da máquina for Linux, o valor incluirá os detalhes da versão da atualização, conforme fornecido pelo gerenciador de pacotes Linux. Por exemplo, 1.0.1.el7.3.

Resultados da instalação de patches

A tabela patchinstallationresources inclui os recursos relacionados à avaliação de patch do computador. A tabela a seguir descreve suas propriedades.

Propriedade Descrição
ID A ID do Azure Resource Manager encaminhando o resultado. É semelhante ao caminho da API REST para avaliação do SO convidado. Normalmente, <resourcePath>/patchInstallationResults/<GUID> ou <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>.
NAME Se o ID for do tipo <resourcePath>/patchInstallationResults, o registro conterá GUID exclusivo para a operação de atualização concluída. Se <resourcePath>/patchInstallationResults/softwarePatches/<update>, o registro conterá o nome ou o rótulo de atualização que está sendo instalado na máquina.
TYPE Especifica o tipo de log para avaliação. Se o tipo for patchinstallationresults, o registro fornecerá um resumo da instalação do SO com estatísticas agregadas numéricas. Se o tipo for patchinstallationresults/softwarepatches, o registro descreverá uma atualização específica do SO instalada para o recurso.
TENANTID ID do locatário do Azure para a VM do Azure ou o recurso de servidor habilitado para Azure Arc.
KIND Intencionalmente deixado em branco para uso futuro.
LOCATION Região de nuvem do Azure onde a VM do Azure ou o recurso de servidor habilitado para Azure Arc existe.
RESOURCEGROUP Grupo de recursos do Azure que hospeda a VM do Azure ou o recurso de servidor habilitado para Azure Arc.
SUBSCRIPTIONID ID de assinatura do Azure para a VM do Azure ou o recurso de servidor habilitado para Azure Arc.
MANAGEDBY Intencionalmente deixado em branco para uso futuro.
SKU Intencionalmente deixado em branco para uso futuro.
PLAN Intencionalmente deixado em branco para uso futuro.
PROPERTIES Captura detalhes da operação no formato JSON. Mais informações seguem esta tabela.
TAGS Marcas do Azure definidas para o recurso de servidores habilitados para VM do Azure ou Azure Arc.
IDENTITY Intencionalmente deixado em branco para uso futuro.
ZONES Intencionalmente deixado em branco para uso futuro.
EXTENDEDLOCATION Intencionalmente deixado em branco para uso futuro.

Descrição da propriedade patchinstallationresults

Se a propriedade do tipo de recurso for patchinstallationresults, ela incluirá as informações na tabela a seguir.

Valor Descrição
installationActivityId GUID exclusivo para a execução da instalação da atualização do SO.
maintenanceWindowExceeded Os valores serão True ou False se a execução da instalação da atualização exceder a janela de manutenção definida.
lastModifiedDateTime Carimbo de data/hora (UTC) que representa quando o registro foi atualizado pela última vez.
notSelectedPatchCount Número de atualizações de SO disponíveis no computador não selecionadas para instalação em uma implantação de atualização.
installedPatchCount Número de atualizações do SO que foram instaladas com êxito e especificadas em uma implantação de atualização.
excludedPatchCount Número de atualizações de SO disponíveis no computador e excluídas para instalação em uma implantação de atualização.
pendingPatchCount Número de atualizações do SO ainda aguardando a instalação e que foram especificadas em uma implantação de atualização.
patchServiceUsed Serviço do SO usado na máquina para instalar atualizações. WU-WSUS para o serviço Windows Update ou Windows Server Update Service. Para Linux, é o gerenciador de pacotes do SO como YUM, APT ou Zypper.
failedPatchCount Número de atualizações do sistema operacional que não foram instaladas com êxito e que foram especificadas em uma implantação de atualização.
startDateTime Carimbo de data/hora (UTC) que representa quando a tarefa de instalação de atualização do SO iniciou a execução no computador.
rebootStatus Informações do serviço de atualização do sistema operacional ou do gerenciador de pacotes se o sistema operacional precisar ser reiniciado para concluir a instalação da atualização. Os valores de status são NotNeeded (nenhuma reinicialização é necessária), (a reinicialização do sistema operacional é necessária para a conclusão), (a reinicialização foi iniciada), FailedRequiredStarted (o sistema operacional não pôde ser reiniciado) e Completed (a reinicialização foi feita com êxito).
startedBy Identifica se um usuário ou um serviço do Azure disparou a instalação da atualização do sistema operacional. Para obter mais informações sobre a operação, consulte Log de atividades do Azure.
status Status da execução da instalação da atualização do SO. Os valores podem ser NotStarted, , , SucceededInProgressFailede .CompletedWithWarnings A execução da instalação da atualização é considerada Failed status se uma ou mais instalações de atualização do sistema operacional não forem bem-sucedidas.
osType Representa o tipo de sistema operacional: Windows ou Linux.
errorDetails Inclui as cinco primeiras mensagens de erro geradas durante a execução da instalação de atualização a partir do gerenciador de pacotes do sistema operacional ou do serviço de atualização da máquina.
maintenanceRunId Esse valor é usado como um identificador de execução de manutenção para Auto VM Guest Patching ou agendar ID de execução em vez de atualizações recorrentes.

Se a propriedade do tipo de recurso for patchinstallationresults/softwarepatches, ela incluirá as informações na tabela a seguir.

Valor Descrição
installationState Status de instalação para a atualização específica do SO. Os valores são Installed, Failed, Pending, NotSelected e Excluded.
lastModifiedDateTime Carimbo de data/hora (UTC) que representa quando o registro foi atualizado pela última vez.
publishedDateTime Carimbo de data e hora que representa quando a atualização específica foi disponibilizada pelo fornecedor do SO. O serviço de atualização do sistema operacional ou o gerenciador de pacotes da máquina gera as informações. Se o gerenciador de pacotes do sistema operacional ou o serviço de atualização não fornecer os detalhes de quando uma atualização foi fornecida pelo fornecedor do sistema operacional, o valor será nulo.
classifications Categoria à qual a atualização específica pertence de acordo com o fornecedor do sistema operacional, conforme fornecido pelo serviço de atualização do sistema operacional ou gerenciador de pacotes da máquina. Se o gerenciador de pacotes do sistema operacional ou o serviço de atualização não fornecer os detalhes da categoria, o valor do campo será Others (para Linux) e Updates (para Windows Server).
rebootRequired Sinalizador para especificar se a atualização específica requer que o sistema operacional seja reinicializado para concluir a instalação, conforme fornecido pelo serviço de atualização do sistema operacional ou pelo gerenciador de pacotes da máquina. Se o gerenciador de pacotes do sistema operacional ou o serviço de atualização não fornecer informações sobre a necessidade de reinicialização do sistema operacional, o valor do campo será definido como false.
rebootBehavior O comportamento definido na instalação da atualização do sistema operacional executa o trabalho por usuário, em relação a permitir que o Gerenciador de atualizações reinicialize o sistema operacional.
patchName Nome ou rótulo para a atualização específica, conforme fornecido pelo gerenciador de pacotes do sistema operacional ou serviço de atualização da máquina.
Kbid Se o sistema operacional do computador for Windows Server, o valor incluirá a ID de KB exclusiva para a atualização fornecida pelo serviço Windows Update.
version Se o sistema operacional da máquina for Linux, o valor incluirá os detalhes da versão da atualização, conforme fornecido pelo gerenciador de pacotes Linux. Por exemplo, 1.0.1.el7.3.

Recursos de manutenção

A tabela maintenanceresources inclui os recursos relacionados à configuração de manutenção. A tabela a seguir descreve suas propriedades.

Propriedade Descrição
ID A ID do Azure Resource Manager encaminhando o resultado. É semelhante ao caminho da API REST para criar uma configuração de manutenção.
NAME Se o ID for do tipo <resourcePath>/applyupdates, o registro conterá um GUID exclusivo para a execução de manutenção. Se <resourcePath>/configurationassignments, o registro conterá a atribuição da configuração de manutenção a uma VM do Azure ou do Azure Arc.
TYPE Especifica o tipo de log para avaliação. Se o tipo for applyupdates, o registro fornecerá detalhes do registro de execução de manutenção no nível da máquina. Se o tipo for configurationassignments, o registro descreve o vínculo entre uma VM do Azure ou uma VM do Azure Arc e uma configuração de manutenção.
TENANTID ID do locatário do Azure para a VM do Azure ou o recurso de servidor habilitado para Azure Arc.
KIND Intencionalmente deixado em branco para uso futuro.
LOCATION Região de nuvem pura onde existe a VM do Azure ou o recurso de servidor habilitado para Azure Arc.
RESOURCEGROUP Grupo de recursos do Azure que hospeda a VM do Azure ou o recurso de servidor habilitado para Azure Arc.
SUBSCRIPTIONID ID de assinatura do Azure para a VM do Azure ou o recurso de servidor habilitado para Azure Arc.
MANAGEDBY Intencionalmente deixado em branco para uso futuro.
SKU Intencionalmente deixado em branco para uso futuro.
PLAN Intencionalmente deixado em branco para uso futuro.
PROPERTIES Captura detalhes da operação no formato JSON. Mais informações seguem esta tabela.
TAGS Marcas do Azure definidas para o recurso de servidores habilitados para VM do Azure ou Azure Arc.
IDENTITY Intencionalmente deixado em branco para uso futuro.
ZONES Intencionalmente deixado em branco para uso futuro.
EXTENDEDLOCATION Intencionalmente deixado em branco para uso futuro.

Descrição da propriedade applyupdates

Se a propriedade do tipo de recurso for applyupdates, ela incluirá as informações na tabela a seguir.

Valor Descrição
maintenanceConfigurationId ID do Azure Resource Manager da configuração de manutenção aplicada.
maintenanceScope Escopo de manutenção da configuração de manutenção aplicada.
resourceId ID de recurso de modelo do Azure Resource Manager da ARC/VM do Azure.
correlationId ID de execução da programação de manutenção/execução de agendamento. Essas informações podem ser usadas para localizar todas as VMs que faziam parte da mesma agenda.
startDateTime Data e hora de início de uma programação.
endDateTime Data e hora de término de uma agenda.

Se a propriedade do tipo de recurso for configurationassignments, ela incluirá as informações na tabela a seguir.

Valor Descrição
resourceId ID de recurso do Azure Resource Manager da ARC/Azure VM
maintenanceConfigurationId ID do Azure Resource Manager da configuração de manutenção aplicada

Próximas etapas