Oznámení o prostředcích Azure – Události ContainerService ve službě Azure Event Grid (Preview)
Azure Kubernetes Service (AKS) používá téma Systému prostředků událostí služby Container Service k doručování preemptivních oznámení pro plánované aktivity údržby v clusterech AKS. Tato funkce umožňuje příjem nabízených oznámení pro základní úlohy údržby v různých fázích událostí, včetně naplánovaných, zahájených, dokončených, zrušených a neúspěšných. Zejména pro plánovanou fázi se oznámení odesílají 7 dní a 24 hodin před skutečnou aktivitou údržby.
Oznámení zahrnují:
- Údržba iniciovaná službou AKS (například migrace Underlay, Přepínač tunelu Konnectivity)
- Údržba iniciovaná zákazníky (například automatický upgrade, upgrade operačního systému uzlu a týdenní období vydávání verzí)
Tato oznámení s výhledem do budoucna pomáhají zákazníkům tím, že nabízejí příležitost lépe se připravit na potenciální přerušení, a v konečném důsledku se zaměřují na minimalizaci provozních nákladů.
Tento článek obsahuje vlastnosti a schéma událostí ContainerService oznámení o prostředcích Azure. 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í
ContainerService nabízí pro spotřebu následující typ události:
| Typ události | Popis |
|---|---|
Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted |
poskytuje předběžná oznámení o událostech plánované údržby v clusterech AKS. |
Ří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. Pokud chcete získat přístup k datům prostřednictvím tohoto systémového tématu, kromě obecných oprávnění vyžadovaných službou Event Grid, je nezbytné následující oprávnění specifické pro oznámení o prostředcích Azure: ''.
Microsoft.ResourceNotifications/systemTopics/subscribeToContainerServiceEventResources/action
Schéma událostí
Toto je schéma:
{
"id": "string",
"source": "string",
"subject": "string",
"type": "Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted",
"time ": "string in date-time",
"data": {
"resourceInfo": {
"id": "string",
"name": "string",
"type": "string",
"location": "string",
"properties": {
"description": "string",
"eventId": "string",
"eventSource": "string",
"eventStatus": "string",
"eventDetails": "string",
"scheduledTime": "string in date-time",
"startTime": "string in date-time",
"lastUpdateTime": "string in date-time",
"resources": "array of strings",
"resourceType": "string"
}
},
"operationalInfo": {
"resourceEventTime": "string in 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 |
Objekt | 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 |
Objekt | Data specifická pro daný prostředek. Další informace najdete v další tabulce. |
apiVersion |
String | Verze rozhraní API vlastností prostředku |
operationalInfo |
Objekt | 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á. |
location |
String | Umístění nebo oblast, kde se prostředek nachází. |
properties |
Objekt | 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 |
Událost ScheduledEventEmitted má následující vlastnosti:
| Vlastnost | Type | Description |
|---|---|---|
description |
String | Popis události. |
eventId |
String | ID události. |
eventSource |
String | Zdroj události |
eventStatus |
Výčet (řetězec) | Stav události, která může být – Naplánováno, Spuštěno, Dokončeno, Zrušeno, Selhání. |
eventDetails |
String | Podrobnosti události. |
scheduledTime |
Řetězec (formát data a času) | Čas události je naplánován na spuštění. |
lastUpdateTime |
Řetězec (formát data a času) | Čas poslední aktualizace stavu události |
resources |
Pole řetězců (formát ID Azure Resource Manageru) | Seznam prostředků ovlivněných událostí |
resourceType |
String | Typ prostředku události |
Příklady událostí
Následující příklad ukazuje schéma události změněné klíč-hodnota:
{
"id": "5bdb52cf-5489-4845-86c8-7fe94a4fc6c1",
"source": "/subscriptions/{subscription-id}",
"subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.ContainerService/managedClusters/{managedcluster-name}/scheduledEvents/{event-id}",
"data": {
"resourceInfo": {
"id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.ContainerService/managedClusters/{managedcluster-name}/scheduledEvents/{event-id}",
"name": "{event-id}",
"type": "Microsoft.ContainerService/managedClusters/scheduledEvents",
"properties": {
"description": "ScheduledEvents",
"eventId": "bbe82027-0444-4f73-897a-0bbfe3af66f1",
"eventSource": "AutoUprader",
"eventStatus": "Started",
"eventDetails": "Start to upgrade security vhd",
"scheduledTime": "2024-04-16T22:17:12.103268606Z",
"startTime": "0001-01-01T00:00:00.0000000Z",
"lastUpdateTime": "0001-01-01T00:00:00.0000000Z",
"resources": [
"/subscriptions/{subscription-id}/resourcegroups/{rg-name}/providers/Microsoft.ContainerService/managedClusters/{managedcluster-name}"
],
"resourceType": "ManagedCluster"
}
},
"operationalInfo": {
"resourceEventTime": "2024-04-16T22:17:12.1032748"
},
"apiVersion": "2023-11-02-preview"
},
"type": "Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted",
"specversion": "1.0",
"time": "2024-04-16T22:17:12.1032748Z"
}
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 služby Container Service.