Udostępnij za pośrednictwem

Uzyskiwanie dostępu do danych operacyjnych usługi Azure Update Manager przy użyciu usługi Azure Resource Graph

  • Artykuł

Dzienniki utworzone na podstawie operacji, takich jak oceny aktualizacji i instalacje, są przechowywane przez usługę Azure Update Manager w usłudze Azure Resource Graph. Resource Graph to usługa na platformie Azure przeznaczona do przechowywania szczegółów usługi platformy Azure bez żadnych kosztów ani wymagań dotyczących wdrażania. Usługa Update Manager używa usługi Resource Graph do przechowywania wyników. Historię oceny aktualizacji można wyświetlić w ciągu ostatnich 7 dni i historię instalacji aktualizacji z ostatnich 30 dni na wykresie zasobów.

W tym artykule opisano strukturę dzienników z programu Update Manager oraz sposób używania Eksploratora usługi Azure Resource Graph do analizowania ich pod kątem raportowania, wizualizacji i eksportowania.

Struktura dziennika

Menedżer aktualizacji wysyła wyniki wszystkich operacji do usługi Azure Resource Graph jako dzienniki, które są dostępne przez 30 dni. Poniżej przedstawiono strukturę dzienników wysyłanych do usługi Azure Resource Graph.

Wyniki oceny poprawek

Tabela patchassessmentresources zawiera zasoby związane z oceną poprawek maszyny. W poniższej tabeli opisano jej właściwości.

Właściwości opis
ID Identyfikator usługi Azure Resource Manager przekazujący wynik. Jest ona podobna do ścieżki interfejsu API REST dla oceny systemu operacyjnego gościa. <resourcePath>/patchAssessmentResults/latest Zazwyczaj lub <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>.
NAME Jeśli identyfikator jest typu <resourcePath>/patchAssessmentResults/latest, rekord zawiera unikatowy identyfikator GUID dla operacji oceny zakończonej. Jeśli <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>wartość , rekord zawiera nazwę aktualizacji lub etykietę.
TYPE Określa typ dziennika oceny. Jeśli typ to patchassessmentresults, rekord zawiera podsumowanie oceny systemu operacyjnego z liczbowymi zagregowanymi statystykami. Jeśli typ to patchassessmentresults/softwarepatches, rekord opisuje określoną aktualizację systemu operacyjnego dostępną dla zasobu.
TENANTID Identyfikator dzierżawy platformy Azure dla maszyny wirtualnej platformy Azure lub zasobu serwera z obsługą usługi Azure Arc.
KIND Celowo pozostawione puste do użycia w przyszłości.
LOCATION Region chmury platformy Azure, w którym istnieje zasób maszyny wirtualnej platformy Azure lub serwera z obsługą usługi Azure Arc.
RESOURCEGROUP Grupa zasobów platformy Azure hostująca zasób maszyny wirtualnej platformy Azure lub serwera z obsługą usługi Azure Arc.
SUBSCRIPTIONID Identyfikator subskrypcji platformy Azure dla maszyny wirtualnej platformy Azure lub zasobu serwera z obsługą usługi Azure Arc.
MANAGEDBY Celowo pozostawione puste do użycia w przyszłości.
SKU Celowo pozostawione puste do użycia w przyszłości.
PLAN Celowo pozostawione puste do użycia w przyszłości.
PROPERTIES Przechwytuje szczegóły operacji w formacie JSON. Więcej informacji znajduje się w tej tabeli.
TAGS Celowo pozostawione puste do użycia w przyszłości.
IDENTITY Celowo pozostawione puste do użycia w przyszłości.
ZONES Celowo pozostawione puste do użycia w przyszłości.
EXTENDEDLOCATION Celowo pozostawione puste do użycia w przyszłości.

Opis właściwości patchassessmentresources

Jeśli właściwość typu zasobu to patchassessmentresources, zawiera informacje w poniższej tabeli.

Wartość Opis
rebootPending Flaga określająca, czy określona aktualizacja wymaga ponownego uruchomienia systemu operacyjnego w celu zakończenia instalacji. Zgodnie z usługą aktualizacji systemu operacyjnego lub menedżerem pakietów maszyny. Jeśli menedżer pakietów systemu operacyjnego lub usługa aktualizacji nie wymagają ponownego uruchomienia, wartość pola jest ustawiona na falsewartość .
patchServiceUsed Usługa systemu operacyjnego używana na maszynie do instalowania aktualizacji. WU-WSUS dla usługi Windows Update lub usługi Windows Server Update. W przypadku systemu Linux jest to menedżer pakietów systemu operacyjnego, taki jak YUM, APTlub Zypper.
osType Reprezentuje typ systemu operacyjnego: Windows lub Linux.
startDateTime Sygnatura czasowa (UTC) reprezentująca, kiedy zadanie oceny aktualizacji systemu operacyjnego rozpoczęło wykonywanie na maszynie.
lastModifiedDateTime Sygnatura czasowa (UTC) reprezentująca czas ostatniej aktualizacji rekordu.
startedBy Określa, czy użytkownik lub usługa platformy Azure wyzwoliła instalację aktualizacji systemu operacyjnego. Aby uzyskać więcej informacji na temat operacji, zobacz Dziennik aktywności platformy Azure.
errorDetails Pierwsze pięć komunikatów o błędach generowanych podczas wykonywania instalacji aktualizacji z menedżera pakietów systemu operacyjnego maszyny lub usługi aktualizacji.
availablePatchCountByClassification Liczba aktualizacji systemu operacyjnego według kategorii, do których należą określone aktualizacje na podstawie dostawcy systemu operacyjnego. Usługa aktualizacji systemu operacyjnego lub menedżer pakietów maszyny generuje informacje. Jeśli menedżer pakietów systemu operacyjnego lub usługa aktualizacji nie udostępnia szczegółów kategorii, wartość to Others (dla systemu Linux) lub Updates (dla systemu Windows Server).

Jeśli właściwość typu zasobu to patchassessmentresults/softwarepatches, zawiera informacje w poniższej tabeli.

Wartość Opis
lastModifiedDateTime Sygnatura czasowa (UTC) reprezentująca czas ostatniej aktualizacji rekordu.
publishedDateTime Sygnatura czasowa reprezentująca, kiedy określona aktualizacja została udostępniona przez dostawcę systemu operacyjnego. Usługa aktualizacji systemu operacyjnego lub menedżer pakietów maszyny generuje informacje. Jeśli menedżer pakietów systemu operacyjnego lub usługa aktualizacji nie udostępnia szczegółowych informacji o tym, kiedy aktualizacja została dostarczona przez dostawcę systemu operacyjnego, wartość ma wartość null. Obecnie ta wartość nie jest dostępna w przypadku aktualizacji systemu Linux.
classifications Kategoria, do którego należy określona aktualizacja, zgodnie z dostawcą systemu operacyjnego. Usługa aktualizacji systemu operacyjnego lub menedżer pakietów maszyny generuje informacje. Jeśli menedżer pakietów systemu operacyjnego lub usługa aktualizacji nie udostępnia szczegółów kategorii, wartość to Others (dla systemu Linux) lub Updates (dla systemu Windows Server).
rebootRequired Wartość wskazuje, czy określona aktualizacja wymaga ponownego uruchomienia systemu operacyjnego w celu zakończenia instalacji. Usługa aktualizacji systemu operacyjnego lub menedżer pakietów maszyny generuje informacje. Jeśli menedżer pakietów systemu operacyjnego lub usługa aktualizacji nie wymagają ponownego uruchomienia, wartość to false.
rebootBehavior Zachowanie ustawione w instalacji aktualizacji systemu operacyjnego uruchamia zadanie podczas konfigurowania wdrożenia aktualizacji, jeśli program Update Manager może ponownie uruchomić maszynę docelową.
patchName Nazwa lub etykieta określonej aktualizacji wygenerowanej przez menedżera pakietów systemu operacyjnego lub usługę aktualizacji systemu operacyjnego.
Kbid Jeśli system operacyjny maszyny jest systemem operacyjnym Windows Server, wartość zawiera unikatowy identyfikator KB aktualizacji dostarczonej przez usługę Windows Update.
version Jeśli system operacyjny maszyny to Linux, wartość zawiera szczegóły wersji aktualizacji podane przez menedżera pakietów systemu Linux. Na przykład 1.0.1.el7.3.

Wyniki instalacji poprawek

Tabela patchinstallationresources zawiera zasoby związane z oceną poprawek maszyny. W poniższej tabeli opisano jej właściwości.

Właściwości opis
ID Identyfikator usługi Azure Resource Manager przekazujący wynik. Jest ona podobna do ścieżki interfejsu API REST dla oceny systemu operacyjnego gościa. <resourcePath>/patchInstallationResults/<GUID> Zazwyczaj lub <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>.
NAME Jeśli identyfikator jest typu <resourcePath>/patchInstallationResults, rekord zawiera unikatowy identyfikator GUID dla zakończonej operacji aktualizacji. Jeśli <resourcePath>/patchInstallationResults/softwarePatches/<update>rekord zawiera nazwę aktualizacji lub etykietę zainstalowaną na maszynie.
TYPE Określa typ dziennika oceny. Jeśli typ to patchinstallationresults, rekord zawiera podsumowanie instalacji systemu operacyjnego z liczbowymi statystykami agregacji. Jeśli typ to patchinstallationresults/softwarepatches, rekord opisuje określoną aktualizację systemu operacyjnego zainstalowaną dla zasobu.
TENANTID Identyfikator dzierżawy platformy Azure dla maszyny wirtualnej platformy Azure lub zasobu serwera z obsługą usługi Azure Arc.
KIND Celowo pozostawione puste do użycia w przyszłości.
LOCATION Region chmury platformy Azure, w którym istnieje zasób maszyny wirtualnej platformy Azure lub serwera z obsługą usługi Azure Arc.
RESOURCEGROUP Grupa zasobów platformy Azure hostująca zasób maszyny wirtualnej platformy Azure lub serwera z obsługą usługi Azure Arc.
SUBSCRIPTIONID Identyfikator subskrypcji platformy Azure dla maszyny wirtualnej platformy Azure lub zasobu serwera z obsługą usługi Azure Arc.
MANAGEDBY Celowo pozostawione puste do użycia w przyszłości.
SKU Celowo pozostawione puste do użycia w przyszłości.
PLAN Celowo pozostawione puste do użycia w przyszłości.
PROPERTIES Przechwytuje szczegóły operacji w formacie JSON. Więcej informacji znajduje się w tej tabeli.
TAGS Celowo pozostawione puste do użycia w przyszłości.
IDENTITY Celowo pozostawione puste do użycia w przyszłości.
ZONES Celowo pozostawione puste do użycia w przyszłości.
EXTENDEDLOCATION Celowo pozostawione puste do użycia w przyszłości.

Opis właściwości patchinstallationresults

Jeśli właściwość typu zasobu to patchinstallationresults, zawiera informacje w poniższej tabeli.

Wartość Opis
installationActivityId Unikatowy identyfikator GUID dla przebiegu instalacji aktualizacji systemu operacyjnego.
maintenanceWindowExceeded Wartości to True lub False jeśli przebieg instalacji aktualizacji przekroczył zdefiniowane okno obsługi.
lastModifiedDateTime Sygnatura czasowa (UTC) reprezentująca czas ostatniej aktualizacji rekordu.
notSelectedPatchCount Liczba aktualizacji systemu operacyjnego dostępnych na maszynie, która nie została wybrana do instalacji we wdrożeniu aktualizacji.
installedPatchCount Liczba aktualizacji systemu operacyjnego, które zostały pomyślnie zainstalowane, które zostały określone we wdrożeniu aktualizacji.
excludedPatchCount Liczba aktualizacji systemu operacyjnego dostępnych na maszynie i wykluczonych do instalacji we wdrożeniu aktualizacji.
pendingPatchCount Liczba aktualizacji systemu operacyjnego nadal czeka na zainstalowanie, które zostały określone we wdrożeniu aktualizacji.
patchServiceUsed Usługa systemu operacyjnego używana na maszynie do instalowania aktualizacji. WU-WSUS dla usługi Windows Update lub usługi Windows Server Update. W przypadku systemu Linux jest to menedżer pakietów systemu operacyjnego, taki jak YUM, APTlub Zypper.
failedPatchCount Liczba aktualizacji systemu operacyjnego, których nie można pomyślnie zainstalować, które zostały określone we wdrożeniu aktualizacji.
startDateTime Sygnatura czasowa (UTC) reprezentująca, kiedy zadanie instalacji aktualizacji systemu operacyjnego rozpoczęło wykonywanie na maszynie.
rebootStatus Informacje z usługi aktualizacji systemu operacyjnego lub menedżera pakietów, jeśli system operacyjny musi zostać uruchomiony ponownie, aby zakończyć instalację aktualizacji. Wartości stanu to NotNeeded (nie jest wymagane ponowne uruchomienie systemu operacyjnego), Required (ponowne uruchomienie systemu operacyjnego jest wymagane do ukończenia), Started (zainicjowano ponowne uruchomienie systemu operacyjnego), Failed (nie można ponownie uruchomić systemu operacyjnego) i Completed (ponowne uruchomienie zostało wykonane pomyślnie).
startedBy Określa, czy użytkownik lub usługa platformy Azure wyzwoliła instalację aktualizacji systemu operacyjnego. Aby uzyskać więcej informacji na temat operacji, zobacz Dziennik aktywności platformy Azure.
status Stan przebiegu instalacji aktualizacji systemu operacyjnego. Wartości mogą być NotStartedwartościami , , InProgressFailed, Succeededi CompletedWithWarnings. Uruchomienie instalacji aktualizacji jest uznawane za Failed stan, jeśli co najmniej jedna instalacja aktualizacji systemu operacyjnego nie powiedzie się.
osType Reprezentuje typ systemu operacyjnego: Windows lub Linux.
errorDetails Zawiera pięć pierwszych komunikatów o błędach generowanych podczas uruchamiania instalacji aktualizacji z menedżera pakietów systemu operacyjnego lub usługi aktualizacji.
maintenanceRunId Ta wartość jest używana jako identyfikator przebiegu konserwacji dla automatycznego stosowania poprawek gościa maszyny wirtualnej lub identyfikator uruchomienia harmonogramu zamiast cyklicznych aktualizacji.

Jeśli właściwość typu zasobu to patchinstallationresults/softwarepatches, zawiera informacje w poniższej tabeli.

Wartość Opis
installationState Stan instalacji dla określonej aktualizacji systemu operacyjnego. Wartości to Installed, , Failed, NotSelectedPending, i Excluded.
lastModifiedDateTime Sygnatura czasowa (UTC) reprezentująca czas ostatniej aktualizacji rekordu.
publishedDateTime Sygnatura czasowa reprezentująca, kiedy określona aktualizacja została udostępniona przez dostawcę systemu operacyjnego. Usługa aktualizacji systemu operacyjnego lub menedżer pakietów maszyny generuje informacje. Jeśli menedżer pakietów systemu operacyjnego lub usługa aktualizacji nie udostępnia szczegółowych informacji o tym, kiedy aktualizacja została dostarczona przez dostawcę systemu operacyjnego, wartość ma wartość null.
classifications Kategoria, do którego należy określona aktualizacja, zgodnie z dostawcą systemu operacyjnego zgodnie z usługą aktualizacji systemu operacyjnego maszyny lub menedżerem pakietów. Jeśli menedżer pakietów systemu operacyjnego lub usługa aktualizacji nie udostępnia szczegółów kategorii, wartość pola to Others (dla systemu Linux) i Updates (dla systemu Windows Server).
rebootRequired Flaga określająca, czy określona aktualizacja wymaga ponownego uruchomienia systemu operacyjnego w celu zakończenia instalacji, zgodnie z instrukcjami usługi aktualizacji systemu operacyjnego lub menedżera pakietów. Jeśli menedżer pakietów systemu operacyjnego lub usługa aktualizacji nie udostępnia informacji dotyczących konieczności ponownego uruchomienia systemu operacyjnego, wartość pola jest ustawiona na falsewartość .
rebootBehavior Zachowanie ustawione w instalacji aktualizacji systemu operacyjnego uruchamia zadanie przez użytkownika, w odniesieniu do umożliwienia programowi Update Manager ponownego uruchomienia systemu operacyjnego.
patchName Nadaj nazwę lub etykietę określonej aktualizacji podaną przez menedżera pakietów systemu operacyjnego lub usługę aktualizacji systemu operacyjnego.
Kbid Jeśli system operacyjny maszyny jest systemem operacyjnym Windows Server, wartość zawiera unikatowy identyfikator KB aktualizacji dostarczonej przez usługę Windows Update.
version Jeśli system operacyjny maszyny to Linux, wartość zawiera szczegóły wersji aktualizacji podane przez menedżera pakietów systemu Linux. Na przykład 1.0.1.el7.3.

Zasoby konserwacji

Tabela maintenanceresources zawiera zasoby związane z konfiguracją konserwacji. W poniższej tabeli opisano jej właściwości.

Właściwości opis
ID Identyfikator usługi Azure Resource Manager przekazujący wynik. Jest ona podobna do ścieżki interfejsu API REST do tworzenia konfiguracji konserwacji.
NAME Jeśli identyfikator jest typu <resourcePath>/applyupdates, rekord zawiera unikatowy identyfikator GUID dla przebiegu konserwacji. Jeśli <resourcePath>/configurationassignmentsrekord zawiera przypisanie konfiguracji konserwacji do maszyny wirtualnej platformy Azure lub usługi Azure Arc.
TYPE Określa typ dziennika oceny. Jeśli typ to applyupdates, rekord zawiera szczegółowe informacje o rekordzie przebiegu konserwacji na poziomie maszyny. Jeśli typ to configurationassignments, rekord opisuje połączenie między maszyną wirtualną platformy Azure lub maszyną wirtualną usługi Azure Arc i konfiguracją konserwacji.
TENANTID Identyfikator dzierżawy platformy Azure dla maszyny wirtualnej platformy Azure lub zasobu serwera z obsługą usługi Azure Arc.
KIND Celowo pozostawione puste do użycia w przyszłości.
LOCATION Czysty region chmury, w którym istnieje zasób maszyny wirtualnej platformy Azure lub serwera z obsługą usługi Azure Arc.
RESOURCEGROUP Grupa zasobów platformy Azure hostująca zasób maszyny wirtualnej platformy Azure lub serwera z obsługą usługi Azure Arc.
SUBSCRIPTIONID Identyfikator subskrypcji platformy Azure dla maszyny wirtualnej platformy Azure lub zasobu serwera z obsługą usługi Azure Arc.
MANAGEDBY Celowo pozostawione puste do użycia w przyszłości.
SKU Celowo pozostawione puste do użycia w przyszłości.
PLAN Celowo pozostawione puste do użycia w przyszłości.
PROPERTIES Przechwytuje szczegóły operacji w formacie JSON. Więcej informacji znajduje się w tej tabeli.
TAGS Celowo pozostawione puste do użycia w przyszłości.
IDENTITY Celowo pozostawione puste do użycia w przyszłości.
ZONES Celowo pozostawione puste do użycia w przyszłości.
EXTENDEDLOCATION Celowo pozostawione puste do użycia w przyszłości.

Opis właściwości applyupdates

Jeśli właściwość typu zasobu to applyupdates, zawiera informacje w poniższej tabeli.

Wartość Opis
maintenanceConfigurationId Identyfikator zastosowanej konserwacji usługi Azure Resource Manager.
maintenanceScope Zakres konserwacji zastosowanej konfiguracji konserwacji.
resourceId Identyfikator zasobu szablonu usługi Azure Resource Manager maszyny wirtualnej USŁUGI ARC/platformy Azure.
correlationId Identyfikator przebiegu harmonogramu przebiegu przebiegu konserwacji/harmonogramu. Te informacje mogą służyć do znajdowania wszystkich maszyn wirtualnych, które były częścią tego samego harmonogramu.
startDateTime Data i godzina rozpoczęcia harmonogramu.
endDateTime Data i godzina zakończenia harmonogramu.

Jeśli właściwość typu zasobu to configurationassignments, zawiera informacje w poniższej tabeli.

Wartość Opis
resourceId Identyfikator zasobu usługi Azure Resource Manager maszyny wirtualnej ARC/azure
maintenanceConfigurationId Identyfikator usługi Azure Resource Manager zastosowanej konfiguracji konserwacji

Następne kroki