Sdílet prostřednictvím

Oznámení o prostředcích Azure – Události prostředků stavu ve službě Azure Event Grid (Preview)

  • Článek

Systémové téma HealthResources poskytuje přesné, spolehlivé a komplexní informace o stavu, které umožňují hlubší porozumění různým problémům se službami, které mají vliv na prostředky Azure, konkrétně virtuální počítače s jednou instancí, virtuální počítače škálovací sady virtuálních počítačů a škálovací sady virtuálních počítačů virtuálních počítačů. Prostředky stavu nabízejí dva typy událostí pro spotřebu: AvailabilityStatusChanged a ResourceAnnotated.

Tento článek obsahuje vlastnosti a schéma událostí prostředků služby Azure Resource Notifications Health. Obecný úvod do schémat událostí najdete ve schématu událostí služby Azure Event Grid. Kromě toho můžete najít ukázky vygenerovaných událostí a odkaz na související článek o tom, jak vytvořit systémové téma pro tento typ tématu.

Typy událostí

Prostředky stavu nabízejí dva typy událostí pro spotřebu:

Typ události Popis
Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged Vyvolá se, když se změní stav dostupnosti virtuálního počítače s jednou instancí, škálovací sadou virtuálních počítačů nebo virtuálním počítačem ve škálovací sadě virtuálních počítačů.

Tyto informace poskytují přehled o všech případech, kdy vaše virtuální počítače, virtuální počítače ve škálovacích sadách virtuálních počítačů nebo samotné škálovací sady virtuálních počítačů nebyly kvůli problémům se službou Azure nedostupné. Další informace o různých stavech najdete v přehledu služby Azure Resource Health – Azure Service Health.

Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated Zvýšení stavu virtuálního počítače, škálovací sady virtuálních počítačů nebo virtuálního počítače ve škálovací sadě virtuálních počítačů má vliv na narušení dostupnosti. Platforma vysílá kontext, proč k přerušení došlo, abyste mohli správně reagovat.

Tyto informace vám pomůžou odvodit stav dostupnosti vašich prostředků tím, že poskytují důležité informace o důvodech a příčinách změn dostupnosti. Pomocí těchto dat můžete provádět rychlejší a cílenější opatření pro zmírnění rizik. Další informace o různých vygenerovaných poznámkách najdete v poznámkách ke stavu virtuálního počítače služby Resource Health.

Řízení přístupu na základě role

V současné době se tyto události vygenerují výhradně v oboru předplatného Azure. Z toho vyplývá, že entita, která vytváří odběr událostí pro tento typ tématu, přijímá oznámení v celém tomto předplatném Azure. Z bezpečnostních důvodů je nezbytné omezit možnost vytvářet odběry událostí v tomto tématu na objekty zabezpečení s přístupem pro čtení pro celé předplatné Azure. Pro přístup k datům prostřednictvím tohoto systémového tématu je kromě obecných oprávnění vyžadovaných službou Event Grid potřeba následující oprávnění pro oznámení o prostředcích Azure: Microsoft.ResourceNotifications/systemTopics/subscribeToHealthResources/action

Schéma událostí

Toto je schéma:

{
    "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
}

Událost má následující data nejvyšší úrovně:

Vlastnost Type Description
id String Jedinečný identifikátor události
source String Předplatné Azure, pro které se toto téma systému vytváří.
subject String Vydavatel definoval cestu k základnímu prostředku, na kterém je tato událost generována.
type String Registrovaný typ události tohoto systémového tématu
time Řetězec
Formát: 2022-11-07T18:43:09.2894075Z		 Čas vygenerování události na základě času UTC poskytovatele
data Object Obsahuje data událostí specifická pro poskytovatele prostředků. Další informace najdete v další tabulce.
specversion String Verze specifikace schématu CloudEvents

Objekt data má následující vlastnosti:

Vlastnost Type Popis
resourceInfo Object Data specifická pro daný prostředek. Další informace najdete v další tabulce.
apiVersion String Verze rozhraní API vlastností prostředku
operationalInfo Object Podrobnosti o provozních informacích týkajících se prostředku

Objekt resourceInfo má následující vlastnosti:

Vlastnost Type Description
id String Vydavatel definoval cestu k předmětu události.
name String Toto pole označuje ID události. Vždy vezme hodnotu poslední části id pole.
type String Typ události, která se vysílá. V tomto kontextu je to buď Microsoft.ResourceHealth/AvailabilityStatuses nebo Microsoft.ResourceHealth/ResourceAnnotated.
properties Object Datová část prostředku Další informace najdete v další tabulce.

Objekt operationalInfo má následující vlastnosti:

Vlastnost Type Popis
resourceEventTime DateTime Datum a čas aktualizace prostředku

Uvnitř properties objektu data se liší pro AvailabilityStatusChanged události a ResourceAnnotated události.

Vlastnosti události AvailabilityStatusChanged

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

AvailabilityStatusChanged Pro událost má properties objekt následující vlastnosti:

Vlastnost Type Description
targetResourceId String Základní prostředek, pro který se generují informace o dostupnosti.
targetResourceType String Typ základního prostředku.
occurredTime String Čas, kdy byla tato skutečná událost vygenerován.
previousAvailabilityState String Předchozí stav dostupnosti
availabilityState String Aktuální stav dostupnosti Seznam hodnot najdete v tématu Stav dostupnosti – Získat podle prostředku – REST API (Azure Resource Health).

Vlastnosti události ResourceAnnotated

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

ResourceAnnotated Pro událost má properties objekt následující vlastnosti:

Vlastnost Type Description
targetResourceId String Základní zdroj, pro který se generují informace o poznámce.
targetResourceType String Typ základního prostředku.
occurredTime String Časové razítko, kdy platforma Azure v reakci na událost ovlivňující dostupnost vygenerovala poznámku.
annotationName String Název poznámky. Seznam poznámek a odpovídajících popisů najdete v poznámkách ke stavu virtuálního počítače služby Resource Health – Azure Service Health.
reason String Stručný popis toho, proč se dostupnost prostředků změnila nebo byla ovlivněna.
summary String Podrobné prohlášení o aktivitě a příčině změny nebo ovlivnění dostupnosti prostředků
context String Určuje, jestli byla dostupnost prostředků ovlivněna z důvodu aktivity způsobené Azure nebo uživatelem.
category String Určuje, jestli byla dostupnost prostředků ovlivněna kvůli plánované nebo neplánované aktivitě. Tato vlastnost se vztahuje pouze na Platform-Initiated události.

Příklady událostí

Událost AvailabilityStatusChanged

Následující příklad ukazuje schéma události změněné klíč-hodnota:

{
  "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"
}

Událost ResourceAnnotated

Následující příklad ukazuje schéma události změněné klíč-hodnota:

{
  "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"
}

Kontaktujte nás

Pokud máte nějaké dotazy nebo zpětnou vazbu k této funkci, neváhejte nás kontaktovat na adrese arnsupport@microsoft.com.

Pokud chcete lépe pomoct s konkrétní zpětnou vazbou na určitou událost, poskytněte následující informace:

U chybějících událostí:

  • Název typu systémového tématu
  • Přibližné časové razítko ve standardu UTC při spuštění operace
  • ID základního prostředku, pro které se oznámení vygenerovalo
  • Přejděte na svůj prostředek na webu Azure Portal a vyberte zobrazení JSON v pravém rohu. ID prostředku je první pole na stránce zobrazení JSON.
  • Očekávaný typ události
  • Operace se spustila (například spuštěný nebo zastavený virtuální počítač, vytvořený účet úložiště atd.)
  • Popis problému (například spuštěný virtuální počítač a negenerovaná událost Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged)
  • Pokud je to možné, zadejte ID korelace provedené operace.

U události, která byla zpožděna nebo má neočekávaný obsah

  • Název typu systémového tématu
  • Celý obsah oznámení s výjimkou data.resourceInfo.properties
  • Popis zjištěného problému a ovlivněných hodnot polí

Ujistěte se, že při sdílení těchto dat nezadáte žádné identifikovatelné informace koncového uživatele.

Další kroky

Viz přihlášení k odběru oznámení o prostředcích Azure – události prostředků stavu.