Vue d’ensemble des journaux des requêtes dans le Centre de gestion des mises à jour (Préversion)

  • Article
  • 14 minutes de lecture

Les journaux créés à partir d’opérations telles que les évaluations de mise à jour et les installations sont stockés par le Centre de gestion des mises à jour (préversion) dans un Resource Graph Azure. Azure Resource Graph est un service dans Azure conçu pour être le magasin des détails du service Azure sans aucune exigence de coût ou de déploiement. Le Centre de gestion des mises à jour (préversion) utilise Resource Graph Azure pour stocker ses résultats, et vous pouvez afficher l’historique des mises à jour des 30 derniers jours à partir des ressources.

Le langage de requête d'Azure Resource Graph est basé sur le langage de requête Kusto utilisé par Azure Data Explorer.

L’article décrit la structure des journaux à partir du Centre de gestion des mises à jour (préversion) et la façon dont vous pouvez utiliser Azure Resource Graph Explorer pour les analyser en support de vos rapports, visualisation et besoins d’exportation.

Structure journal

Le Centre de gestion des mises à jour (préversion) envoie les résultats de toute son opération dans Azure Resource Graph en tant que journaux, qui sont disponibles pendant 30 jours. Vous trouverez ci-dessous la structure des journaux envoyés à Azure Resource Graph.

Résultats de l'évaluation de patch

Le tableau patchassessmentresources inclut des ressources liées à l’évaluation des correctifs de machine. Le tableau suivant décrit les propriétés.

Propriété Description
ID ID d’Resource Manager Azure qui transfère le résultat. Il sera similaire au chemin d’accès de l’API REST pour l’évaluation du système d’exploitation invité. En général, <resourcePath>/patchAssessmentResults/latest ou <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>
NAME Si l’ID est de type <resourcePath>/patchAssessmentResults/latest - l’enregistrement contient un GUID unique pour l’opération d’évaluation terminée. Si <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update> - l’enregistrement contient le nom ou l’étiquette de mise à jour.
TYPE Spécifie le type de journal pour l’évaluation. Si le type est patchassessmentresults , l’enregistrement fournit un résumé de l’évaluation du système d’exploitation avec des statistiques d’agrégation numériques. Si le type est patchassessmentresults/softwarepatches, l’enregistrement décrit une mise à jour de système d’exploitation spécifique disponible pour la ressource.
TENANTID ID de locataire Azure pour la machine virtuelle Azure ou la ressource de serveur avec Azure Arc
KIND Laissé intentionnellement vide pour une utilisation ultérieure.
LOCATION Région cloud Azure où se trouve la machine virtuelle Azure ou la ressource de serveur avec Azure Arc
RESOURCEGROUP Groupe de ressources Azure hébergeant la machine virtuelle Azure ou la ressource de serveur avec Azure Arc
SUBSCRIPTIONID ID de l'abonnement Azure pour la VM Azure ou la ressource serveur compatible avec Azure Arc
MANAGEDBY Laissé intentionnellement vide pour une utilisation ultérieure.
SKU Laissé intentionnellement vide pour une utilisation ultérieure.
PLAN Laissé intentionnellement vide pour une utilisation ultérieure.
PROPERTIES Capture les détails de l’opération au format JSON. Des informations complémentaires suivent ce tableau.
TAGS Balises Azure définies pour la machine virtuelle Azure ou les serveurs avec Azure Arc
IDENTITY Laissé intentionnellement vide pour une utilisation ultérieure.
ZONES Laissé intentionnellement vide pour une utilisation ultérieure.
EXTENDEDLOCATION Laissé intentionnellement vide pour une utilisation ultérieure.

Description de la propriété PROPERTIES

Si la PROPERTIES propriété du type de ressource est patchassessmentresources, elle inclut les informations suivantes :

Valeur Description
rebootPending Indicateur pour spécifier si la mise à jour spécifique nécessite que le système d’exploitation redémarre pour terminer l’installation. Comme indiqué par le service de mise à jour du système d’exploitation ou le gestionnaire de package de l’ordinateur. Si votre gestionnaire de package de système d’exploitation ou votre service de mise à jour ne nécessite pas de redémarrage, la valeur du champ est définie sur false.
patchServiceUsed Service de système d’exploitation utilisé sur l’ordinateur pour installer les mises à jour. WU-WSUSpour Windows Update service et/ou Windows Server Update Service. Pour Linux, il s’agit du gestionnaire de package de système d’exploitation comme YUM, APTou Zypper.
osType Représente le type de système d’exploitation Windows ou Linux.
startDateTime Horodatage (UTC) représentant le moment où la tâche d’évaluation de la mise à jour du système d’exploitation a démarré l’exécution sur l’ordinateur.
lastModifiedDateTime Horodatage (UTC) représentant le moment où l’enregistrement a été mis à jour pour la dernière fois.
startedBy Identifie si l’exécution de l’installation de la mise à jour du système d’exploitation a été déclenchée par un utilisateur ou un service Azure. Vous trouverez plus d’informations sur l’opération dans le journal d’activité Azure.
errorDetails Cinq premiers messages d’erreur générés lors de l’exécution de l’installation de la mise à jour à partir du gestionnaire de package du système d’exploitation ou du service de mise à jour de l’ordinateur.
availablePatchCountByClassification Nombre de mises à jour du système d’exploitation par catégorie que les mises à jour spécifiques appartiennent en fonction du fournisseur du système d’exploitation. Les informations sont générées par le service de mise à jour du système d’exploitation ou le gestionnaire de package de l’ordinateur. Si le gestionnaire de package du système d’exploitation ou le service de mise à jour ne fournit pas les détails de la catégorie, la valeur est Others (pour Linux) ou Updates (pour Windows Server).

Si la PROPERTIES propriété du type de ressource est patchassessmentresults/softwarepatches, elle inclut les informations suivantes :

Valeur Description
lastModifiedDateTime Horodatage (UTC) représentant le moment où l’enregistrement a été mis à jour pour la dernière fois.
publishedDateTime Horodatage représentant le moment où la mise à jour spécifique a été mise à disposition par le fournisseur du système d’exploitation. Les informations sont générées par le service de mise à jour du système d’exploitation ou le gestionnaire de package de l’ordinateur. Si votre gestionnaire de package de système d’exploitation ou votre service de mise à jour ne fournit pas les détails du moment où une mise à jour a été fournie par le fournisseur du système d’exploitation, la valeur est Null.
classifications Catégorie à laquelle la mise à jour spécifique appartient conformément au fournisseur du système d’exploitation. Les informations sont générées par le service de mise à jour du système d’exploitation ou le gestionnaire de package de l’ordinateur. Si le gestionnaire de paquets de votre système d'exploitation ou le service de mise à jour ne fournit pas le détail de la catégorie, la valeur est Others (pour Linux) ou Updates (pour Windows Server).
rebootRequired La valeur indique si la mise à jour spécifique nécessite un redémarrage du système d'exploitation pour terminer l'installation. Les informations sont générées par le service de mise à jour du système d’exploitation ou le gestionnaire de package de l’ordinateur. Si le gestionnaire de paquets ou le service de mise à jour de votre système d'exploitation ne nécessite pas de redémarrage, la valeur est false.
rebootBehavior Le comportement défini dans l’installation de la mise à jour du système d’exploitation exécute le travail lors de la configuration du déploiement de mise à jour si le centre de gestion des mises à jour (préversion) peut redémarrer l’ordinateur cible.
patchName Nom ou étiquette de la mise à jour spécifique générée par le gestionnaire de package du système d’exploitation ou le service de mise à jour de l’ordinateur.
Kbid Si le système d’exploitation de l’ordinateur est Windows Server, la valeur inclut l’ID de base de connaissances unique pour la mise à jour fournie par le service Windows Update.
version Si le système d’exploitation de l’ordinateur est Linux, la valeur inclut les détails de version de la mise à jour, comme indiqué par le gestionnaire de package Linux. Par exemple : 1.0.1.el7.3.

Résultats de l'installation de patch

Le tableau patchinstallationresources inclut des ressources liées à l’évaluation des correctifs de machine. Le tableau suivant décrit les propriétés.

Propriété Description
ID ID d’Resource Manager Azure qui transfère le résultat. Il sera similaire au chemin d’accès de l’API REST pour l’évaluation du système d’exploitation invité. En général, <resourcePath>/patchInstallationResults/<GUID> ou <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>
NAME Si l'ID est de type <resourcePath>/patchInstallationResults -, l'enregistrement contient un GUID unique pour l'opération de mise à jour effectuée. Si <resourcePath>/patchInstallationResults/softwarePatches/<update> - l’enregistrement contient le nom ou l’étiquette de mise à jour installé sur l’ordinateur.
TYPE Spécifie le type de journal pour l’évaluation. Si le type est patchinstallationresults , l'enregistrement fournit un résumé de l'installation du système d'exploitation avec des statistiques numériques globales. Si le type est patchinstallationresults/softwarepatches , alors l'enregistrement décrit une mise à jour spécifique du système d'exploitation installée pour la ressource.
TENANTID ID de locataire Azure pour la machine virtuelle Azure ou la ressource de serveur avec Azure Arc
KIND Laissé intentionnellement vide pour une utilisation ultérieure.
LOCATION Région cloud Azure où se trouve la machine virtuelle Azure ou la ressource de serveur avec Azure Arc
RESOURCEGROUP Groupe de ressources Azure hébergeant la machine virtuelle Azure ou la ressource de serveur avec Azure Arc
SUBSCRIPTIONID ID de l'abonnement Azure pour la VM Azure ou la ressource serveur compatible avec Azure Arc
MANAGEDBY Laissé intentionnellement vide pour une utilisation ultérieure.
SKU Laissé intentionnellement vide pour une utilisation ultérieure.
PLAN Laissé intentionnellement vide pour une utilisation ultérieure.
PROPERTIES Capture les détails de l’opération au format JSON. Des informations complémentaires suivent ce tableau.
TAGS Balises Azure définies pour la machine virtuelle Azure ou les serveurs avec Azure Arc
IDENTITY Laissé intentionnellement vide pour une utilisation ultérieure.
ZONES Laissé intentionnellement vide pour une utilisation ultérieure.
EXTENDEDLOCATION Laissé intentionnellement vide pour une utilisation ultérieure.

Description de la propriété PROPERTIES

Si la PROPERTIES propriété du type de ressource est patchinstallationresults, elle inclut les informations suivantes :

Valeur Description
installationActivityId GUID unique pour l’exécution de l’installation de la mise à jour du système d’exploitation.
maintenanceWindowExceeded Les valeurs sont True ou False si l’exécution de l’installation de mise à jour a dépassé la fenêtre de maintenance définie.
lastModifiedDateTime Horodatage (UTC) représentant la date de la dernière mise à jour de l'enregistrement
notSelectedPatchCount Nombre de mises à jour du système d’exploitation disponibles sur l’ordinateur non sélectionné pour l’installation dans un déploiement de mise à jour.
installedPatchCount Nombre de mises à jour du système d’exploitation qui ont été correctement installées qui ont été spécifiées dans un déploiement de mise à jour.
excludedPatchCount Nombre de mises à jour du système d'exploitation disponibles sur la machine et exclues pour l'installation dans un déploiement de mise à jour.
pendingPatchCount Nombre de mises à jour du système d’exploitation en attente d’installation qui ont été spécifiées dans un déploiement de mise à jour.
patchServiceUsed Service de système d’exploitation utilisé sur l’ordinateur pour installer les mises à jour. WU-WSUSpour Windows Update service et/ou Windows Server Update Service. Pour Linux, il s’agit du gestionnaire de package de système d’exploitation comme YUM, APTou Zypper.
failedPatchCount Nombre de mises à jour du système d'exploitation qui n'ont pas réussi à être installées et qui étaient spécifiées dans un déploiement de mise à jour.
startDateTime Horodatage (UTC) représentant le moment où la tâche d'installation de la mise à jour du système d'exploitation a commencé son exécution sur la machine.
rebootStatus Informations du service de mise à jour du système d’exploitation ou du gestionnaire de package, si le système d’exploitation doit être redémarré pour terminer l’installation de la mise à jour. Les valeurs d’état sont NotNeeded (Aucun redémarrage n’est nécessaire), Required (le redémarrage du système d’exploitation est nécessaire pour l’achèvement), Started (Le redémarrage a été lancé), (le système d’exploitation n’a pas pu être redémarré) Failed et Completed (Le redémarrage a été effectué avec succès).
startedBy Identifie si l'exécution de l'installation de la mise à jour du système d'exploitation a été déclenchée par un utilisateur ou un service Azure. Vous trouverez plus d’informations sur l’opération dans le journal d’activité Azure.
status État de l’exécution de l’installation de la mise à jour du système d’exploitation. Les valeurs peuvent être : NotStarted, InProgress, Failed, Succeeded and CompletedWithWarnings. L’exécution de l’installation de la mise à jour est considérée comme « Échec », si une ou plusieurs installations de mise à jour du système d’exploitation échouent.
osType Représente le type de système d’exploitation Windows ou Linux.
errorDetails Comprend les cinq premiers messages d'erreur générés lors de l'exécution d'une installation de mise à jour à partir du gestionnaire de paquets du système d'exploitation de la machine ou du service de mise à jour.
maintenanceRunId Cette valeur est utilisée comme identificateur d’exécution de maintenance pour le correctif d’invité de machine virtuelle automatique ou l’ID d’exécution de planification au lieu de mises à jour périodiques

Si la PROPERTIES propriété du type de ressource est patchinstallationresults/softwarepatches, elle inclut les informations suivantes :

Valeur Description
installationState État d’installation de la mise à jour du système d’exploitation spécifique. Les valeurs sont Installed, , Failed, PendingNotSelected, et Excluded.
lastModifiedDateTime Horodatage (UTC) représentant le moment où l’enregistrement a été mis à jour pour la dernière fois.
publishedDateTime Horodatage représentant le moment où la mise à jour spécifique a été mise à disposition par le fournisseur du système d’exploitation. Les informations sont générées par le service de mise à jour du système d’exploitation ou le gestionnaire de package de l’ordinateur. Si votre gestionnaire de package de système d’exploitation ou votre service de mise à jour ne fournit pas les détails du moment où une mise à jour a été fournie par le fournisseur du système d’exploitation, la valeur est Null.
classifications Catégorie à laquelle la mise à jour spécifique appartient selon le fournisseur du système d'exploitation. Comme indiqué par le service de mise à jour du système d’exploitation ou le gestionnaire de package de l’ordinateur. Si votre gestionnaire de package de système d’exploitation ou votre service de mise à jour, ne fournit pas le détail de la catégorie, la valeur du champ sera d’autres (pour Linux) et Mises à jour (pour Windows Server).
rebootRequired Indicateur pour spécifier si la mise à jour spécifique nécessite que le système d’exploitation redémarre pour terminer l’installation. Comme indiqué par le service de mise à jour du système d’exploitation ou le gestionnaire de package de l’ordinateur. Si votre gestionnaire de package de système d’exploitation ou votre service de mise à jour ne fournit pas d’informations concernant le redémarrage du système d’exploitation, la valeur du champ est définie sur « false ».
rebootBehavior Le comportement défini dans l’installation de la mise à jour du système d’exploitation exécute le travail par l’utilisateur en ce qui concerne l’autorisation du centre de gestion des mises à jour (préversion) de redémarrer le système d’exploitation.
patchName Nom ou étiquette de la mise à jour spécifique fournie par le gestionnaire de paquets du système d'exploitation de la machine ou le service de mise à jour.
Kbid Si le système d’exploitation de l’ordinateur est Windows Server, la valeur inclut l’ID de base de connaissances unique pour la mise à jour fournie par le service Windows Update.
version Si le système d’exploitation de l’ordinateur est Linux, la valeur inclut les détails de version de la mise à jour, comme indiqué par le gestionnaire de package Linux. Par exemple : 1.0.1.el7.3.

Ressources de maintenance

La table maintenanceresources inclut des ressources liées à la configuration de la maintenance. Le tableau suivant décrit les propriétés.

Propriété Description
ID ID d’Resource Manager Azure qui transfère le résultat. Il est similaire au chemin d’accès de l’API REST pour créer une configuration de maintenance.
NAME Si l’ID est de type <resourcePath>/applyupdates - l’enregistrement contient un GUID unique pour l’exécution de maintenance. Si <resourcePath>/configurationassignments - l’enregistrement contient l’affectation de la configuration de maintenance à une machine virtuelle Azure ou Arc.
TYPE Spécifie le type de journal pour l’évaluation. Si le type est applyupdates , l’enregistrement fournit des détails sur l’enregistrement d’exécution de maintenance au niveau de l’ordinateur. Si le type est configurationassignments, l’enregistrement décrit le lien entre une machine virtuelle Azure ou Arc et une configuration de maintenance.
TENANTID ID de locataire Azure pour la machine virtuelle Azure ou la ressource de serveur avec Azure Arc
KIND Laissé intentionnellement vide pour une utilisation ultérieure.
LOCATION Région de nuage pur où se trouve la VM Azure ou la ressource serveur compatible avec Azure Arc
RESOURCEGROUP Groupe de ressources Azure hébergeant la machine virtuelle Azure ou la ressource de serveur avec Azure Arc
SUBSCRIPTIONID ID de l'abonnement Azure pour la VM Azure ou la ressource serveur compatible avec Azure Arc
MANAGEDBY Laissé intentionnellement vide pour une utilisation ultérieure.
SKU Laissé intentionnellement vide pour une utilisation ultérieure.
PLAN Laissé intentionnellement vide pour une utilisation ultérieure.
PROPERTIES Capture les détails de l’opération au format JSON. Des informations complémentaires suivent ce tableau.
TAGS Les balises Azure définies pour la ressource Azure VM ou les serveurs compatibles avec Azure Arc
IDENTITY Laissé intentionnellement vide pour une utilisation ultérieure.
ZONES Laissé intentionnellement vide pour une utilisation ultérieure.
EXTENDEDLOCATION Laissé intentionnellement vide pour une utilisation ultérieure.

Description de la propriété PROPERTIES

Si la PROPERTIES propriété du type de ressource est applyupdates, elle inclut les informations suivantes :

Valeur Description
maintenanceConfigurationId ID azure Resource Manager (ARM) de configuration de maintenance appliquée
maintenanceScope Étendue de maintenance de la configuration de maintenance appliquée
resourceId ID de ressource de modèle ARM de machine virtuelle ARC/Azure
correlationId Planifier l’ID d’exécution de maintenance/exécution de planification. Cela peut être utilisé pour rechercher toutes les machines virtuelles qui faisaient partie de la même planification.
startDateTime Date et heure de début d'un programme
endDateTime Date et heure de fin d'un programme

Si la PROPERTIES propriété du type de ressource est configurationassignments, elle comprend les informations suivantes :

Valeur Description
resourceId ID de ressource ARM de machine virtuelle ARC/Azure
maintenanceConfigurationId ID ARM de la configuration de maintenance appliquée

Étapes suivantes