Delen via

Azure Resource Notifications - ContainerService-gebeurtenissen in Azure Event Grid (preview)

  • Artikel

De Azure Kubernetes Service (AKS) maakt gebruik van het systeemonderwerp Container Service Event Resources voor het leveren van preventieve meldingen voor geplande onderhoudsactiviteiten op AKS-clusters. Met deze functionaliteit kunt u pushmeldingen ontvangen voor essentiële onderhoudstaken in verschillende gebeurtenisfasen, waaronder gepland, geïnitieerd, voltooid, geannuleerd en mislukt. Met name voor de geplande fase worden meldingen 7 dagen en 24 uur vóór de werkelijke onderhoudsactiviteit verzonden.

Meldingen omvatten:

  • Onderhoud geïnitieerd door AKS (bijvoorbeeld underlaymigratie, Konnectivity Tunnel Switch)
  • Onderhoud geïnitieerd door klanten (zoals automatische upgrade, upgrade van knooppuntbesturingssystemen en wekelijkse releasevensters)

Deze forward-looking meldingen helpen klanten door de mogelijkheid te bieden om zich beter voor te bereiden op mogelijke onderbrekingen, en uiteindelijk gericht op het minimaliseren van operationele uitgaven.

Dit artikel bevat de eigenschappen en het schema voor ContainerService-gebeurtenissen voor Azure Resource Notifications. Zie het Gebeurtenisschema van Azure Event Grid voor een inleiding tot gebeurtenisschema's in het algemeen. Daarnaast vindt u voorbeelden van gegenereerde gebeurtenissen en een koppeling naar een gerelateerd artikel over het maken van systeemonderwerp voor dit onderwerptype.

Gebeurtenistypen

ContainerService biedt het volgende gebeurtenistype voor verbruik:

Gebeurtenistype Beschrijving
Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted biedt geavanceerde meldingen voor geplande onderhoudsevenementen op AKS-clusters.

Op rollen gebaseerd toegangsbeheer

Deze gebeurtenissen worden momenteel uitsluitend verzonden op het azure-abonnementsbereik. Het impliceert dat de entiteit die het gebeurtenisabonnement voor dit onderwerptype maakt, meldingen ontvangt in dit Azure-abonnement. Om veiligheidsredenen is het noodzakelijk om de mogelijkheid om gebeurtenisabonnementen op dit onderwerp te maken te beperken tot principals met leestoegang voor het hele Azure-abonnement. Voor toegang tot gegevens via dit systeemonderwerp is naast de algemene machtigingen die vereist zijn voor Event Grid, de volgende specifieke machtiging voor Azure-resourcemeldingen nodig: ''.

Microsoft.ResourceNotifications/systemTopics/subscribeToContainerServiceEventResources/action

Gebeurtenisschema's

Dit is het schema:

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

Een gebeurtenis bevat de volgende gegevens op het hoogste niveau:

Eigenschap Type Omschrijving
id String Unieke id van de gebeurtenis
source String Het Azure-abonnement waarvoor dit systeemonderwerp wordt gemaakt.
subject String Door Publisher gedefinieerd pad naar de basisresource waarop deze gebeurtenis wordt verzonden.
type String Geregistreerd gebeurtenistype van dit type systeemonderwerp
time Snaar
Formatteren: 2022-11-07T18:43:09.2894075Z		 Het tijdstip waarop de gebeurtenis wordt gegenereerd op basis van de UTC-tijd van de provider
data Object Bevat gebeurtenisgegevens die specifiek zijn voor de resourceprovider. Zie de volgende tabel voor meer informatie.
specversion String CloudEvents schemaspecificatieversie.

Het data object heeft de volgende eigenschappen:

Eigenschap Type Description
resourceInfo Object Gegevens die specifiek zijn voor de resource. Zie de volgende tabel voor meer informatie.
apiVersion String API-versie van de resource-eigenschappen.
operationalInfo Object Details van operationele informatie met betrekking tot de resource.

Het resourceInfo object heeft de volgende eigenschappen:

Eigenschap Type Omschrijving
id String Door Publisher gedefinieerd pad naar het gebeurtenisonderwerp
name String Dit veld geeft de gebeurtenis-id aan. Hierbij wordt altijd de waarde van het laatste gedeelte van het id veld gebruikt.
type String Het type gebeurtenis dat wordt verzonden.
location String Locatie of regio waar de resource zich bevindt.
properties Object Nettolading van de resource. Zie de volgende tabel voor meer informatie.

Het operationalInfo object heeft de volgende eigenschappen:

Eigenschap Type Description
resourceEventTime Datum en tijd Datum en tijd waarop de resource is bijgewerkt.

De ScheduledEventEmitted gebeurtenis heeft de volgende eigenschappen:

Eigenschap Type Omschrijving
description String De beschrijving van de gebeurtenis.
eventId String De gebeurtenis-id van de gebeurtenis.
eventSource String De bron van de gebeurtenis.
eventStatus Opsomming (tekenreeks) Status van de gebeurtenis die kan zijn: Gepland, Gestart, Voltooid, Geannuleerd, Mislukt.
eventDetails String De details van de gebeurtenis.
scheduledTime Tekenreeks (datum-tijdnotatie) De tijd van de gebeurtenis wordt gepland om te starten.
lastUpdateTime Tekenreeks (datum-tijdnotatie) De laatste keer dat de status van de gebeurtenis is bijgewerkt.
resources Matrix van tekenreeksen (Azure Resource Manager-id-indeling) De lijst met resources die worden beïnvloed door de gebeurtenis.
resourceType String Het resourcetype van de gebeurtenis

Voorbeeld van gebeurtenissen

In het volgende voorbeeld ziet u het schema van een gewijzigde sleutelwaardegebeurtenis:

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

Contact opnemen

Als u vragen of feedback over deze functie hebt, aarzel dan niet om ons te bereiken op arnsupport@microsoft.com.

Geef de volgende informatie op om u beter te helpen met specifieke feedback over een bepaalde gebeurtenis:

Voor ontbrekende gebeurtenissen:

  • Naam van systeemonderwerptype
  • Geschatte tijdstempel in UTC toen de bewerking werd uitgevoerd
  • Basisresource-id waarvoor de melding is gegenereerd
  • Navigeer naar uw resource in Azure Portal en selecteer de JSON-weergave uiterst rechts. Resource-id is het eerste veld op de JSON-weergavepagina.
  • Verwacht gebeurtenistype
  • De bewerking is uitgevoerd (bijvoorbeeld vm gestart of gestopt, opslagaccount gemaakt, enzovoort)
  • Beschrijving van het probleem dat is opgetreden (bijvoorbeeld dat de VM is gestart en er geen gebeurtenis Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged is gegenereerd)
  • Geef indien mogelijk de correlatie-id op van de uitgevoerde bewerking

Voor gebeurtenissen die zijn vertraagd of onverwachte inhoud hebben

  • Naam van systeemonderwerptype
  • Volledige inhoud van de melding met uitzondering van data.resourceInfo.properties
  • Beschrijving van probleem opgetreden en beïnvloede veldwaarden

Zorg ervoor dat u geen identificeerbare informatie voor eindgebruikers opgeeft terwijl u deze gegevens deelt.

Volgende stappen

Zie Abonneren op Azure-resourcemeldingen - Container Service-gebeurtenissen.