Share via

Powiadomienia dotyczące zasobów platformy Azure — zdarzenia zasobów kondycji w usłudze Azure Event Grid (wersja zapoznawcza)

  • Artykuł

Temat systemu HealthResources zawiera dokładne, niezawodne i kompleksowe informacje o kondycji, co umożliwia dokładniejsze zrozumienie zróżnicowanych problemów z usługą wpływających na zasoby platformy Azure, a mianowicie maszyn wirtualnych z pojedynczym wystąpieniem, maszyn wirtualnych, zestawów skalowania maszyn wirtualnych i zestawów skalowania maszyn wirtualnych. Zasoby kondycji oferują dwa typy zdarzeń do użycia: AvailabilityStatusChanged i ResourceAnnotated.

Ten artykuł zawiera właściwości i schemat zdarzeń zasobów usługi Azure Resource Notifications Health. Aby zapoznać się z ogólnym wprowadzeniem do schematów zdarzeń, zobacz Schemat zdarzeń usługi Azure Event Grid. Ponadto można znaleźć przykłady wygenerowanych zdarzeń i link do powiązanego artykułu na temat tworzenia tematu systemowego dla tego typu tematu.

Typy zdarzeń

Zasoby dotyczące kondycji oferują dwa typy zdarzeń do użycia:

Typ zdarzenia opis
Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged Zgłaszane, gdy zmienia się stan dostępności pojedynczego wystąpienia maszyny wirtualnej, zestawu skalowania maszyn wirtualnych lub maszyny wirtualnej w zestawie skalowania maszyn wirtualnych.

Te informacje zapewniają wgląd we wszystkie czasy, w których maszyny wirtualne, maszyny wirtualne w zestawach skalowania maszyn wirtualnych lub same zestawy skalowania maszyn wirtualnych były niedostępne z powodu problemów z usługą platformy Azure. Aby uzyskać więcej informacji na temat różnych stanów kondycji, zobacz Omówienie usługi Azure Resource Health — Azure Service Health.

Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated Zgłaszane, gdy kondycja maszyny wirtualnej, zestawu skalowania maszyn wirtualnych lub maszyny wirtualnej w zestawie skalowania maszyn wirtualnych ma wpływ na dostępność wpływając na zakłócenia. Platforma emituje kontekst, dlaczego wystąpiły zakłócenia, aby pomóc w odpowiednim reagowaniu.

Te informacje pomagają wywnioskować stan dostępności zasobów, dostarczając kluczowe informacje o przyczynach i przyczynach zmian dostępności. Korzystając z tych danych, można podjąć szybsze i bardziej ukierunkowane środki zaradcze. Aby uzyskać więcej informacji na temat różnych emitowanych adnotacji, zobacz Adnotacje dotyczące kondycji maszyny wirtualnej usługi Resource Health.

Kontrola dostępu oparta na rolach

Obecnie te zdarzenia są emitowane wyłącznie w zakresie subskrypcji platformy Azure. Oznacza to, że jednostka tworząca subskrypcję zdarzeń dla tego typu tematu otrzymuje powiadomienia w całej subskrypcji platformy Azure. Ze względów bezpieczeństwa konieczne jest ograniczenie możliwości tworzenia subskrypcji zdarzeń w tym temacie do podmiotów zabezpieczeń z dostępem do odczytu w całej subskrypcji platformy Azure. Aby uzyskać dostęp do danych za pośrednictwem tego tematu systemowego, oprócz ogólnych uprawnień wymaganych przez usługę Event Grid, niezbędne jest następujące uprawnienie specyficzne dla usługi Azure Resource Notifications: Microsoft.ResourceNotifications/systemTopics/subscribeToHealthResources/action.

Schematy zdarzeń

Oto schemat:

{
    "id": string,
    "source": string,
    "subject": string,
    "type": "Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged | Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated",
    "time ": string, 
    "data": {
        "resourceInfo": {
            "id": string,
            "name": string,
            "type": string,
            "properties": { 
                <<Different for AvailabilityStatusChanged event and ResourceAnnotated event>>            
            }
        },
        "operationalInfo":{
			"resourceEventTime": date-time
		},
        "apiVersion": string 
    }, 
    "specversion": string
}

Zdarzenie ma następujące dane najwyższego poziomu:

Właściwość Type opis
id String Unikatowy identyfikator zdarzenia
source String Subskrypcja platformy Azure, dla której jest tworzony ten temat systemowy.
subject String Ścieżka zdefiniowana przez program Publisher do zasobu podstawowego, na którym jest emitowane to zdarzenie.
type String Typ zarejestrowanego zdarzenia tego typu tematu systemowego
time Ciąg
Formacie: 2022-11-07T18:43:09.2894075Z		 Czas generowania zdarzenia na podstawie czasu UTC dostawcy
data Objekt Zawiera dane zdarzenia specyficzne dla dostawcy zasobów. Aby uzyskać więcej informacji, zobacz następną tabelę.
specversion String Wersja specyfikacji schematu CloudEvents.

Obiekt data ma następujące właściwości:

Właściwość Type Opis
resourceInfo Objekt Dane specyficzne dla zasobu. Aby uzyskać więcej informacji, zobacz następną tabelę.
apiVersion String Wersja interfejsu API właściwości zasobu.
operationalInfo Objekt Szczegóły informacji operacyjnych dotyczących zasobu.

Obiekt resourceInfo ma następujące właściwości:

Właściwość Type opis
id String Zdefiniowana ścieżka wydawcy do tematu zdarzenia
name String To pole wskazuje identyfikator zdarzenia. Zawsze przyjmuje wartość ostatniej sekcji id pola.
type String Typ emitowanego zdarzenia. W tym kontekście jest to wartość Microsoft.ResourceHealth/AvailabilityStatuses lub Microsoft.ResourceHealth/ResourceAnnotated.
properties Objekt Ładunek zasobu. Aby uzyskać więcej informacji, zobacz następną tabelę.

Obiekt operationalInfo ma następujące właściwości:

Właściwość Type Opis
resourceEventTime DateTime Data i godzina aktualizacji zasobu.

Obiekt properties w obiekcie data jest inny dla zdarzeń AvailabilityStatusChanged i ResourceAnnotated .

Właściwości zdarzenia AvailabilityStatusChanged

            "properties": {
                "targetResourceId": string,
                "targetResourceType": string,
                "occurredTime": string,
                "previousAvailabilityState": string,
                "availabilityState": string
            }

AvailabilityStatusChanged W przypadku zdarzenia properties obiekt ma następujące właściwości:

Właściwość Type opis
targetResourceId String Zasób podstawowy, dla którego są emitowane informacje o dostępności.
targetResourceType String Typ zasobu podstawowego.
occurredTime String Czas emisji tego rzeczywistego zdarzenia.
previousAvailabilityState String Poprzedni stan dostępności.
availabilityState String Bieżący stan dostępności. Aby uzyskać listę wartości, zobacz Stan dostępności — Pobieranie według zasobu — interfejs API REST (Azure Resource Health).

Właściwości zdarzenia ResourceAnnotated

            "properties": {
                "targetResourceId": string,
                "targetResourceType": string,
                "occurredTime": string,
                "annotationName": string,
                "reason": string,
                "summary": string,
                "context": string,
                "category": string,
            }

ResourceAnnotated W przypadku zdarzenia properties obiekt ma następujące właściwości:

Właściwość Type opis
targetResourceId String Zasób podstawowy, dla którego są emitowane informacje adnotacji.
targetResourceType String Typ zasobu podstawowego.
occurredTime String Sygnatura czasowa emitowania adnotacji przez platformę Azure w odpowiedzi na zdarzenie wpływające na dostępność.
annotationName String Nazwa adnotacji. Aby uzyskać listę adnotacji i odpowiednie opisy, zobacz Adnotacje kondycji maszyny wirtualnej usługi Resource Health — Azure Service Health.
reason String Krótka instrukcja dotycząca tego, dlaczego dostępność zasobów uległa zmianie lub została wpłynęła na nie.
summary String Szczegółowa instrukcja działania i przyczyna zmiany lub wpływu dostępności zasobów.
context String Określa, czy wpływ na dostępność zasobów miał wpływ na platformę Azure, czy na działanie spowodowane przez użytkownika.
category String Określa, czy na dostępność zasobów miała wpływ planowana czy nieplanowana aktywność. Ta właściwość ma zastosowanie tylko do Platform-Initiated zdarzeń.

Przykładowe zdarzenia

Zdarzenie AvailabilityStatusChanged

W poniższym przykładzie przedstawiono schemat zdarzenia zmodyfikowanego przez klucz-wartość:

{
  "id": "1fb6fa94-d965-4306-abeq-4810f0774e97",
  "source": "/subscriptions/{subscription-id}",
  "subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
  "data": {
    "resourceInfo": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}/providers/Microsoft.ResourceHealth/availabilityStatuses/{event-id}",
      "name": "{event-id}",
      "type": "Microsoft.ResourceHealth/availabilityStatuses",
      "properties": {
        "targetResourceId": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
        "targetResourceType": "Microsoft.Compute/virtualMachines",
        "occurredTime": "2023-07-24T19:20:37.9245071Z",
        "previousAvailabilityState": "Unavailable",
        "availabilityState": "Available"
      }
    },
    "operationalInfo": {
      "resourceEventTime": "2023-07-24T19:20:37.9245071Z"
    },
    "apiVersion": "2023-12-01"
  },
  "type": "Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged",
  "specversion": "1.0",
  "time": "2023-07-24T19:20:37.9245071Z"
}

Zdarzenie ResourceAnnotated

W poniższym przykładzie przedstawiono schemat zdarzenia zmodyfikowanego przez klucz-wartość:

{
  "id": "8945cf9b-e220-496e-ab4f-f3a239318995",
  "source": "/subscriptions/{subscription-id}",
  "subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
  "data": {
    "resourceInfo": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}/providers/Microsoft.ResourceHealth/resourceAnnotations/{event-id}",
      "name": "{event-id}",
      "type": "Microsoft.ResourceHealth/resourceAnnotations",
      "properties": {
        "targetResourceId": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
        "targetResourceType": "Microsoft.Compute/virtualMachines",
        "occurredTime": "2023-07-24T19:20:37.9245071Z",
        "annotationName": "VirtualMachineDeallocationInitiated",
        "reason": "Stopping and deallocating",
        "summary": "This virtual machine is stopped and deallocated as requested by an authorized user or process.",
        "context": "Customer Initiated",
        "category": "Not Applicable"
      }
    },
    "operationalInfo": {
      "resourceEventTime": "2023-07-24T19:20:37.9245071Z"
    },
    "apiVersion": "2022-08-01"
  },
  "type": "Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated",
  "specversion": "1.0",
  "time": "2023-07-24T19:20:37.9245071Z"
}

Kontakt z nami

Jeśli masz jakiekolwiek pytania lub opinie dotyczące tej funkcji, nie wahaj się skontaktować się z nami pod adresem arnsupport@microsoft.com.

Aby lepiej pomóc w konkretnej opinii na temat określonego zdarzenia, podaj następujące informacje:

W przypadku brakujących zdarzeń:

  • Nazwa typu tematu systemowego
  • Przybliżony znacznik czasu w formacie UTC podczas wykonywania operacji
  • Identyfikator zasobu podstawowego, dla którego zostało wygenerowane powiadomienie
  • Przejdź do zasobu w witrynie Azure Portal i wybierz widok JSON w prawym górnym rogu. Identyfikator zasobu to pierwsze pole na stronie widoku JSON.
  • Oczekiwany typ zdarzenia
  • Wykonano operację (na przykład uruchomiono lub zatrzymano maszynę wirtualną, utworzono konto magazynu itp.)
  • Opis napotkanego problemu (na przykład maszyna wirtualna została uruchomiona i nie wygenerowano zdarzenia Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged)
  • Jeśli to możliwe, podaj identyfikator korelacji wykonanej operacji

W przypadku zdarzenia, które zostało opóźnione lub ma nieoczekiwaną zawartość

  • Nazwa typu tematu systemowego
  • Cała zawartość powiadomienia z wyłączeniem właściwości data.resourceInfo.properties
  • Opis napotkanego problemu i wartości pól, których dotyczy problem

Upewnij się, że podczas udostępniania tych danych nie udostępniasz żadnych informacji możliwych do zidentyfikowania przez użytkownika końcowego.

Następne kroki

Zobacz Subskrybowanie powiadomień o zasobach platformy Azure — zdarzenia zasobów kondycji.