Dela via

Azure Resource Notifications – ContainerService-händelser i Azure Event Grid (förhandsversion)

  • Artikel

Azure Kubernetes Service (AKS) använder systemämnet Container Service Event Resources för att leverera förebyggande meddelanden för schemalagda underhållsaktiviteter i AKS-kluster. Den här funktionen gör det möjligt att ta emot push-meddelanden för viktiga underhållsaktiviteter i olika händelsesteg, inklusive schemalagda, initierade, slutförda, avbrutna och misslyckade. I det schemalagda steget skickas meddelanden 7 dagar och 24 timmar före den faktiska underhållsaktiviteten.

Meddelanden omfattar:

  • Underhåll som initieras av AKS (till exempel underläggsmigrering, Konnectivity Tunnel Switch)
  • Underhåll som initieras av kunder (till exempel automatisk uppgradering, Node OS-uppgradering och veckovisa versionsfönster)

Dessa framåtblickande meddelanden hjälper kunderna genom att erbjuda möjlighet att bättre förbereda sig för potentiella störningar, vilket i slutändan syftar till att minimera driftskostnaderna.

Den här artikeln innehåller egenskaperna och schemat för Azure Resource Notifications ContainerService-händelser. En introduktion till händelsescheman i allmänhet finns i Händelseschema för Azure Event Grid. Dessutom hittar du exempel på genererade händelser och en länk till en relaterad artikel om hur du skapar systemämne för den här ämnestypen.

Händelsetyper

ContainerService erbjuder följande händelsetyp för förbrukning:

Händelsetyp beskrivning
Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted tillhandahåller förhandsmeddelanden för schemalagda underhållshändelser i AKS-kluster.

Rollbaserad åtkomstkontroll

För närvarande genereras dessa händelser exklusivt i Azure-prenumerationsomfånget. Det innebär att entiteten som skapar händelseprenumerationen för den här ämnestypen tar emot meddelanden i hela den här Azure-prenumerationen. Av säkerhetsskäl är det absolut nödvändigt att begränsa möjligheten att skapa händelseprenumerationer i det här avsnittet till huvudkonton med läsåtkomst över hela Azure-prenumerationen. För att få åtkomst till data via det här systemavsnittet, utöver de allmänna behörigheter som krävs av Event Grid, krävs följande specifika behörighet för Azure Resource Notifications: ''.

Microsoft.ResourceNotifications/systemTopics/subscribeToContainerServiceEventResources/action

Händelsescheman

Här är schemat:

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

En händelse har följande data på den översta nivån:

Property Type Description
id String Unik identifierare för händelsen
source String Den Azure-prenumeration som det här systemämnet skapas för.
subject String Den utgivardefinierade sökvägen till den basresurs som händelsen genereras på.
type String Registrerad händelsetyp av den här systemämnestypen
time Sträng
Format: 2022-11-07T18:43:09.2894075Z		 Den tid då händelsen genereras baserat på leverantörens UTC-tid
data Objekt Innehåller händelsedata som är specifika för resursprovidern. Mer information finns i nästa tabell.
specversion String CloudEvents schemaspecifikationsversion.

Objektet data har följande egenskaper:

Property Type Beskrivning
resourceInfo Objekt Data som är specifika för resursen. Mer information finns i nästa tabell.
apiVersion String API-versionen av resursegenskaperna.
operationalInfo Objekt Information om driftinformation som rör resursen.

Objektet resourceInfo har följande egenskaper:

Property Type Description
id String Publisher-definierad sökväg till händelseämnet
name String Det här fältet anger händelse-ID: t. Det tar alltid värdet för det sista avsnittet i id fältet.
type String Den typ av händelse som genereras.
location String Plats eller region där resursen finns.
properties Objekt Nyttolasten för resursen. Mer information finns i nästa tabell.

Objektet operationalInfo har följande egenskaper:

Property Type Beskrivning
resourceEventTime Datum/tid Datum och tid då resursen uppdaterades.

Händelsen ScheduledEventEmitted har följande egenskaper:

Property Type Description
description String Beskrivningen av händelsen.
eventId String Händelsens händelse-ID.
eventSource String Källan till händelsen.
eventStatus Uppräkning (sträng) Status för händelsen som kan vara – Schemalagd, Startad, Slutförd, Avbruten, Misslyckad.
eventDetails String Information om händelsen.
scheduledTime Sträng (datum-tidsformat) Tidpunkten för händelsen är schemalagd att starta.
lastUpdateTime Sträng (datum-tidsformat) Senaste gången händelsens tillstånd uppdaterades.
resources Matris med strängar (Azure Resource Manager-ID-format) Listan över resurser som påverkas av händelsen.
resourceType String Händelsens resurstyp

Exempelhändelser

I följande exempel visas schemat för en ändrad nyckel/värde-händelse:

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

Kontakta oss

Om du har frågor eller feedback om den här funktionen kan du kontakta oss på arnsupport@microsoft.com.

Ange följande information för att bättre hjälpa dig med specifik feedback om en viss händelse:

För saknade händelser:

  • Namn på systemämnestyp
  • Ungefärlig tidsstämpel i UTC när åtgärden kördes
  • Basresurs-ID som meddelandet genererades för
  • Gå till resursen i Azure Portal och välj JSON-vyn längst till höger. Resurs-ID är det första fältet på JSON-vysidan.
  • Förväntad händelsetyp
  • Åtgärden utfördes (till exempel startad eller stoppad virtuell dator, lagringskonto som skapats osv.)
  • Beskrivning av påträffade problem (till exempel startad virtuell dator och ingen Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged-händelse genererad)
  • Ange om möjligt korrelations-ID för den utförda åtgärden

För händelse som har fördröjts eller har oväntat innehåll

  • Namn på systemämnestyp
  • Hela innehållet i meddelandet exklusive data.resourceInfo.properties
  • Beskrivning av problem som påträffas och påverkade fältvärden

Se till att du inte tillhandahåller någon identifierbar information för slutanvändare när du delar dessa data.

Nästa steg

Se Prenumerera på Azure Resource Notifications – Container Service-händelser.