Поделиться через

Доступ к данным операций Azure Update Manager с помощью Azure Resource Graph

  • Статья

Журналы, созданные из операций, таких как оценки обновлений и установки, хранятся в Azure Update Manager в Azure Resource Graph. Resource Graph — это служба в Azure, предназначенная для хранения сведений о службах Azure без затрат или развертывания. Диспетчер обновлений использует Resource Graph для хранения результатов. Вы можете просмотреть последнюю историю оценки обновлений за последние 7 дней и журнал установок обновлений за последние 30 дней из графа ресурсов.

В этой статье описывается структура журналов из Диспетчера обновлений и способы их анализа в azure Resource Graph Explorer для поддержки ваших отчетов, визуализации и экспорта.

Структура журнала

Диспетчер обновлений отправляет результаты всех операций в Azure Resource Graph в виде журналов, которые доступны в течение 30 дней. Ниже приведена структура журналов, отправляемых в Azure Resource Graph.

Результаты оценки исправлений

patchassessmentresources Таблица содержит ресурсы, связанные с оценкой исправлений компьютера. Ее свойства рассматриваются в приведенной ниже таблице.

Свойство Description
ID Идентификатор Azure Resource Manager, перенаправляющий результат. Он похож на путь REST API для оценки гостевой ОС. Как правило, <resourcePath>/patchAssessmentResults/latest или <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>.
NAME Если идентификатор имеет тип <resourcePath>/patchAssessmentResults/latest, запись содержит уникальный GUID для завершенной операции оценки. Если <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>запись содержит имя обновления или метку.
TYPE Указывает тип журнала для оценки. Если тип имеется patchassessmentresults, запись содержит сводку оценки ОС с числовыми статистическими данными. Если тип имеет тип patchassessmentresults/softwarepatches, запись описывает определенное обновление ОС, доступное для ресурса.
TENANTID Идентификатор клиента Azure для виртуальной машины Azure или серверного ресурса с поддержкой Azure Arc.
KIND Намеренно не заполнено для использования в будущем.
LOCATION Облачный регион Azure, в котором существует виртуальная машина Azure или серверный ресурс с поддержкой Azure Arc.
RESOURCEGROUP Группа ресурсов Azure, в которой размещена виртуальная машина Azure или серверный ресурс с поддержкой Azure Arc.
SUBSCRIPTIONID Идентификатор подписки Azure для виртуальной машины Azure или серверного ресурса с поддержкой Azure Arc.
MANAGEDBY Намеренно не заполнено для использования в будущем.
SKU Намеренно не заполнено для использования в будущем.
PLAN Намеренно не заполнено для использования в будущем.
PROPERTIES Записывает сведения об операции в формате JSON. Дополнительные сведения см. после этой таблицы.
TAGS Намеренно не заполнено для использования в будущем.
IDENTITY Намеренно не заполнено для использования в будущем.
ZONES Намеренно не заполнено для использования в будущем.
EXTENDEDLOCATION Намеренно не заполнено для использования в будущем.

Описание свойств patchassessmentResults

Если свойство для типа ресурса имеет значение patchassessmentresults, оно содержит сведения в следующей таблице.

значение Описание
rebootPending Флаг, указывающий, требуется ли перезагрузка ОС для завершения установки конкретного обновления. Как указано службой обновления ОС или диспетчером пакетов компьютера. Если диспетчер пакетов ОС или служба обновления не требует перезагрузки, для поля задано falseзначение .
patchServiceUsed Служба ОС, используемая на компьютере для установки обновлений. WU-WSUSдля службы Обновл. Windows или службы обновления Windows Server. Для Linux это диспетчер пакетов ОС, например YUM, APTили Zypper.
osType Представляет тип операционной системы: Windows или Linux.
startDateTime Метка времени (в формате UTC), показывающая, когда было начато выполнение задачи оценки обновления ОС на компьютере.
lastModifiedDateTime Метка времени (в формате UTC), показывающая, когда состоялось последнее обновление записи.
startedBy Указывает, кто активировал установку обновления ОС: пользователь или служба Azure. Дополнительные сведения об операции см . в журнале действий Azure.
errorDetails Первые пять сообщений об ошибках, созданных при выполнении установки обновления из диспетчера пакетов ОС компьютера или службы обновлений.
availablePatchCountByClassification Количество обновлений ОС в разбивке по категориям, к которым относятся конкретные обновления, исходя из поставщика ОС. Эту информацию создает служба обновления или диспетчер пакетов ОС компьютера. Если диспетчер пакетов ОС или служба обновления не предоставляет подробные сведения о категории, значение — Others (для Linux) или Updates (для Windows Server).

Если свойство для типа ресурса имеет значение patchassessmentresults/softwarepatches, оно содержит сведения в следующей таблице.

значение Описание
lastModifiedDateTime Метка времени (в формате UTC), показывающая, когда состоялось последнее обновление записи.
publishedDateTime Метка времени, показывающая, когда конкретное обновление было предоставлено поставщиком ОС. Эту информацию создает служба обновления или диспетчер пакетов ОС компьютера. Если диспетчер пакетов или служба обновления ОС не передает сведения о том, когда обновление было предоставлено поставщиком ОС, то значение равно NULL. В настоящее время применительно к обновлениям Linux это значение недоступно.
classifications Категория, к которой относится конкретное обновление, исходя из поставщика ОС. Эту информацию создает служба обновления или диспетчер пакетов ОС компьютера. Если диспетчер пакетов ОС или служба обновления не предоставляют сведения о категории, значение — Others (для Linux) или Updates (для Windows Server).
rebootRequired Значение, указывающее, требуется ли перезагрузка ОС для завершения установки конкретного обновления. Эту информацию создает служба обновления или диспетчер пакетов ОС компьютера. Если диспетчер пакетов ОС или служба обновления не требуют перезагрузки, это значение равно false.
rebootBehavior Поведение, заданное для выполнения задачи по установке обновления ОС при настройке развертывания обновления, если Диспетчер обновлений может перезагрузить целевой компьютер.
patchName Имя или метка конкретного обновления, созданного диспетчером пакетов или службой обновлений ОС компьютера.
Kbid Если ОС компьютера — это Windows Server, значение включает уникальный идентификатор базы знаний для обновления, предоставленный службой обновления Windows.
version Если ОС компьютера — это Linux, значение содержит сведения о версии обновления, предоставленные диспетчером пакетов Linux. Например, 1.0.1.el7.3.

Результаты установки исправлений

patchinstallationresources Таблица содержит ресурсы, связанные с оценкой исправлений компьютера. Ее свойства рассматриваются в приведенной ниже таблице.

Свойство Description
ID Идентификатор Azure Resource Manager, перенаправляющий результат. Он похож на путь REST API для оценки гостевой ОС. Как правило, <resourcePath>/patchInstallationResults/<GUID> или <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>.
NAME Если идентификатор имеет тип <resourcePath>/patchInstallationResults, запись содержит уникальный GUID для завершенной операции обновления. Если <resourcePath>/patchInstallationResults/softwarePatches/<update>запись содержит имя обновления или метку, установленную на компьютере.
TYPE Указывает тип журнала для оценки. Если используется patchinstallationresultsтип, запись содержит сводку по установке ОС с числовыми статистическими статистическими данными. Если используется patchinstallationresults/softwarepatchesтип, запись описывает определенное обновление ОС, установленное для ресурса.
TENANTID Идентификатор клиента Azure для виртуальной машины Azure или серверного ресурса с поддержкой Azure Arc.
KIND Намеренно не заполнено для использования в будущем.
LOCATION Облачный регион Azure, в котором существует виртуальная машина Azure или серверный ресурс с поддержкой Azure Arc.
RESOURCEGROUP Группа ресурсов Azure, в которой размещена виртуальная машина Azure или серверный ресурс с поддержкой Azure Arc.
SUBSCRIPTIONID Идентификатор подписки Azure для виртуальной машины Azure или серверного ресурса с поддержкой Azure Arc.
MANAGEDBY Намеренно не заполнено для использования в будущем.
SKU Намеренно не заполнено для использования в будущем.
PLAN Намеренно не заполнено для использования в будущем.
PROPERTIES Записывает сведения об операции в формате JSON. Дополнительные сведения см. после этой таблицы.
TAGS Намеренно не заполнено для использования в будущем.
IDENTITY Намеренно не заполнено для использования в будущем.
ZONES Намеренно не заполнено для использования в будущем.
EXTENDEDLOCATION Намеренно не заполнено для использования в будущем.

Описание свойства patchinstallationresults

Если свойство для типа ресурса имеет значение patchinstallationresults, оно содержит сведения в следующей таблице.

значение Описание
installationActivityId Уникальный GUID для выполнения установки обновления ОС.
maintenanceWindowExceeded Значения имеют значение True или False если запуск установки обновления превысил определенное время обслуживания.
lastModifiedDateTime Метка времени (в формате UTC), показывающая, когда состоялось последнее обновление записи.
notSelectedPatchCount Количество обновлений ОС, доступных на компьютере, но не выбранных для установки при развертывании обновлений.
installedPatchCount Количество обновлений ОС, которые были успешно установлены и были выбраны при развертывании обновлений.
excludedPatchCount Количество обновлений ОС, доступных на компьютере, но исключенных из установки при развертывании обновлений.
pendingPatchCount Количество обновлений ОС, которые все еще ожидают установки и были выбраны при развертывании обновлений.
patchServiceUsed Служба ОС, используемая на компьютере для установки обновлений. WU-WSUSдля службы Обновл. Windows или службы обновления Windows Server. Для Linux это диспетчер пакетов ОС, например YUM, APTили Zypper.
failedPatchCount Количество обновлений ОС, которые не удалось установить, и которые были выбраны при развертывании обновлений.
startDateTime Метка времени (в формате UTC), показывающая, когда было начато выполнение задачи установки ОС на компьютере.
rebootStatus Информация из службы обновления или диспетчера пакетов ОС, если требуется перезагрузить ОС для завершения установки обновления. Значения состояния : NotNeeded (перезагрузка не требуется), Required (перезагрузка ОС необходима для завершения), Started (перезапуск был инициирован), Failed (не удалось перезапустить ОС) и Completed (перезапуск был выполнен успешно).
startedBy Указывает, кто активировал установку обновления ОС: пользователь или служба Azure. Дополнительные сведения об операции см . в журнале действий Azure.
status Состояние выполнения установки обновления ОС. Значения могут быть NotStarted, , InProgress, SucceededFailedи CompletedWithWarnings. Запуск установки обновления считается Failed состоянием, если одна или несколько установок обновлений ОС завершается неудачно.
osType Представляет тип операционной системы: Windows или Linux.
errorDetails Включает первые пять сообщений об ошибках, созданные при выполнении установки обновления диспетчером пакетов или службой обновлений ОС компьютера.
maintenanceRunId Это значение используется в качестве идентификатора выполнения обслуживания для автоматического исправления гостевой виртуальной машины или идентификатора запланированного выполнения вместо повторяющихся обновлений.

Если свойство для типа ресурса имеет значение patchinstallationresults/softwarepatches, оно содержит сведения в следующей таблице.

значение Описание
installationState Состояние установки для конкретного обновления ОС. Значения: Installed, , PendingFailed, NotSelectedи Excluded.
lastModifiedDateTime Метка времени (в формате UTC), показывающая, когда состоялось последнее обновление записи.
publishedDateTime Метка времени, показывающая, когда конкретное обновление было предоставлено поставщиком ОС. Эту информацию создает служба обновления или диспетчер пакетов ОС компьютера. Если диспетчер пакетов или служба обновления ОС не передает сведения о том, когда обновление было предоставлено поставщиком ОС, то значение равно NULL.
classifications Категория, к которой относится конкретное обновление, исходя из поставщика ОС, в соответствии со сведениями, переданными службой обновления ли диспетчером пакетов ОС компьютера. Если диспетчер пакетов ОС или служба обновления не предоставляют подробные сведения о категории, значение поля — Others (для Linux) и Updates (для Windows Server).
rebootRequired Флаг, указывающий, требуется ли перезагрузка ОС для завершения установки конкретного обновления, в соответствии со сведениями, переданными службой обновления или диспетчером пакетов ОС компьютера. Если диспетчер пакетов ОС или служба обновления не предоставляют сведения о необходимости перезагрузки ОС, для поля задано falseзначение .
rebootBehavior Поведение, заданное пользователем для выполнения задачи по установке обновления ОС относительно того, разрешено ли Диспетчеру обновлений перезагрузить ОС.
patchName Имя или метка конкретного обновления, предоставленные диспетчером пакетов или службой обновлений ОС компьютера.
Kbid Если ОС компьютера — это Windows Server, значение включает уникальный идентификатор базы знаний для обновления, предоставленный службой обновления Windows.
version Если ОС компьютера — это Linux, значение содержит сведения о версии обновления, предоставленные диспетчером пакетов Linux. Например, 1.0.1.el7.3.

Ресурсы обслуживания

maintenanceresources Таблица содержит ресурсы, связанные с конфигурацией обслуживания. Ее свойства рассматриваются в приведенной ниже таблице.

Свойство Description
ID Идентификатор Azure Resource Manager, перенаправляющий результат. Он похож на путь REST API для создания конфигурации обслуживания.
NAME Если идентификатор имеет тип <resourcePath>/applyupdates, запись содержит уникальный GUID для выполнения обслуживания. Если <resourcePath>/configurationassignmentsзапись содержит назначение конфигурации обслуживания виртуальной машине Azure или Azure Arc.
TYPE Указывает тип журнала для оценки. Если это applyupdatesтип, запись содержит сведения о записи выполнения обслуживания на уровне компьютера. Если это configurationassignmentsтип, запись описывает связь между виртуальной машиной Azure или виртуальной машиной Azure Arc и конфигурацией обслуживания.
TENANTID Идентификатор клиента Azure для виртуальной машины Azure или серверного ресурса с поддержкой Azure Arc.
KIND Намеренно не заполнено для использования в будущем.
LOCATION Чисто облачный регион, в котором существует виртуальная машина Azure или серверный ресурс с поддержкой Azure Arc.
RESOURCEGROUP Группа ресурсов Azure, в которой размещена виртуальная машина Azure или серверный ресурс с поддержкой Azure Arc.
SUBSCRIPTIONID Идентификатор подписки Azure для виртуальной машины Azure или серверного ресурса с поддержкой Azure Arc.
MANAGEDBY Намеренно не заполнено для использования в будущем.
SKU Намеренно не заполнено для использования в будущем.
PLAN Намеренно не заполнено для использования в будущем.
PROPERTIES Записывает сведения об операции в формате JSON. Дополнительные сведения см. после этой таблицы.
TAGS Намеренно не заполнено для использования в будущем.
IDENTITY Намеренно не заполнено для использования в будущем.
ZONES Намеренно не заполнено для использования в будущем.
EXTENDEDLOCATION Намеренно не заполнено для использования в будущем.

Описание свойства applyupdates

Если свойство для типа ресурса имеет значение applyupdates, оно содержит сведения в следующей таблице.

значение Описание
maintenanceConfigurationId Идентификатор Azure Resource Manager для примененной конфигурации обслуживания.
maintenanceScope Область обслуживания для примененной конфигурации обслуживания.
resourceId ID ресурса шаблона Azure Resource Manager для виртуальной машины ARC/Azure.
correlationId Идентификатор ппанового выполнения для выполнения обслуживания/запланированного выполнения. Эти сведения можно использовать для поиска всех виртуальных машин, которые входили в состав одного расписания.
startDateTime Начальная дата и время расписания.
endDateTime Конечная дата и время расписания.

Если свойство для типа ресурса имеет значение configurationassignments, оно содержит сведения в следующей таблице.

значение Описание
resourceId Идентификатор ресурса Azure Resource Manager для виртуальной машины ARC/Azure
maintenanceConfigurationId Идентификатор Azure Resource Manager для примененной конфигурации обслуживания

Следующие шаги