Powiadomienia dotyczące zasobów platformy Azure — zdarzenia zasobów kondycji w usłudze Azure Event Grid (wersja zapoznawcza)
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 |
Struna Format: 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.