Condividi tramite

Notifiche delle risorse di Azure - Eventi ContainerService in Griglia di eventi di Azure (anteprima)

  • Articolo

Il servizio Azure Kubernetes (servizio Azure Kubernetes) usa l'argomento del sistema Risorse eventi del servizio contenitore per recapitare notifiche preemptive per le attività di manutenzione pianificata nei cluster del servizio Azure Kubernetes. Questa funzionalità consente la ricezione di notifiche push per le attività di manutenzione essenziali in diverse fasi degli eventi, tra cui pianificate, avviate, completate, annullate e non riuscite. In particolare, per la fase pianificata, le notifiche vengono inviate 7 giorni e 24 ore prima dell'attività di manutenzione effettiva.

Le notifiche includono:

  • Manutenzione avviata dal servizio Azure Kubernetes (ad esempio, migrazione underlay, commutatore del tunnel Konnectivity)
  • Manutenzione avviata dai clienti (ad esempio aggiornamento automatico, aggiornamento del sistema operativo del nodo e finestre di rilascio settimanali)

Queste notifiche forward-looking aiutano i clienti offrendo la possibilità di prepararsi meglio per potenziali interruzioni, mirando infine a ridurre al minimo le spese operative.

Questo articolo fornisce le proprietà e lo schema per gli eventi Contenitore di notifiche delle risorse di AzureService. Per un'introduzione agli schemi di eventi in generale, vedere Schema di eventi di Griglia di eventi di Azure. Inoltre, è possibile trovare esempi di eventi generati e un collegamento a un articolo correlato su come creare un argomento di sistema per questo tipo di argomento.

Tipi di evento

ContainerService offre il tipo di evento seguente per l'utilizzo:

Tipo di evento Descrizione
Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted fornisce notifiche avanzate per gli eventi di manutenzione pianificata nei cluster del servizio Azure Kubernetes.

Controllo degli accessi in base al ruolo

Attualmente, questi eventi vengono generati esclusivamente nell'ambito della sottoscrizione di Azure. Implica che l'entità che crea la sottoscrizione di eventi per questo tipo di argomento riceve notifiche in tutta la sottoscrizione di Azure. Per motivi di sicurezza, è fondamentale limitare la possibilità di creare sottoscrizioni di eventi in questo argomento alle entità con accesso in lettura nell'intera sottoscrizione di Azure. Per accedere ai dati tramite questo argomento di sistema, oltre alle autorizzazioni generiche richieste da Griglia di eventi, è necessaria l'autorizzazione specifica per le notifiche delle risorse di Azure seguente: ''.

Microsoft.ResourceNotifications/systemTopics/subscribeToContainerServiceEventResources/action

Schemi di eventi

Ecco lo 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"
}

Un evento presenta i seguenti dati di primo livello:

Proprietà Type Descrizione
id Stringa Identificatore univoco dell'evento
source String Sottoscrizione di Azure per cui viene creato questo argomento di sistema.
subject String Percorso definito dal server di pubblicazione della risorsa di base in cui viene generato questo evento.
type String Tipo di evento registrato di questo tipo di argomento di sistema
time string
Formato: 2022-11-07T18:43:09.2894075Z		 Ora di generazione dell'evento in base all'ora UTC del provider
data Object Contiene dati dell'evento specifici del provider di risorse. Per altre informazioni, vedere la tabella seguente.
specversion String Versione della specifica dello schema CloudEvents.

Di seguito sono elencate le proprietà dell'oggetto data:

Proprietà Type Descrizione
resourceInfo Object Dati specifici della risorsa. Per altre informazioni, vedere la tabella seguente.
apiVersion String Versione API delle proprietà della risorsa.
operationalInfo Object Dettagli delle informazioni operative relative alla risorsa.

Di seguito sono elencate le proprietà dell'oggetto resourceInfo:

Proprietà Type Descrizione
id Stringa Percorso definito dall'editore all'oggetto dell'evento
name String Questo campo indica l'ID evento. Accetta sempre il valore dell'ultima sezione del id campo.
type String Tipo di evento generato.
location String Posizione o area geografica in cui si trova la risorsa.
properties Object Payload della risorsa. Per altre informazioni, vedere la tabella seguente.

Di seguito sono elencate le proprietà dell'oggetto operationalInfo:

Proprietà Type Descrizione
resourceEventTime Data/Ora Data e ora di aggiornamento della risorsa.

L'evento ScheduledEventEmitted ha le proprietà seguenti:

Proprietà Type Descrizione
description Stringa Descrizione dell'evento.
eventId String ID evento dell'evento.
eventSource String L’oggetto origine dell’evento.
eventStatus Enumerazione (stringa) Stato dell'evento che può essere : Pianificato, Avviato, Completato, Annullato, Non riuscito.
eventDetails String Dettagli dell'evento.
scheduledTime Stringa (formato data/ora) L'ora dell'evento è pianificata per l'avvio.
lastUpdateTime Stringa (formato data/ora) Ultima volta che lo stato dell'evento è stato aggiornato.
resources Matrice di stringhe (formato ID di Azure Resource Manager) Elenco delle risorse interessate dall'evento.
resourceType String Tipo di risorsa dell'evento

Eventi di esempio

L'esempio seguente illustra lo schema di un evento modificato con valore chiave:

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

Contatti

In caso di domande o commenti riguardo questa funzionalità, contattarci all'indirizzo arnsupport@microsoft.com.

Per ricevere assistenza più mirata con feedback specifico su un determinato evento, fornire le informazioni seguenti:

Per eventi mancanti:

  • Nome del tipo di argomento di sistema
  • Timestamp approssimativo in ora UTC di quando è stata eseguita l'operazione
  • ID risorsa di base per cui è stata generata la notifica
  • Passare alla risorsa nel portale di Azure e selezionare Visualizzazione JSON nell'angolo all'estrema destra. L'ID risorsa è il primo campo nella pagina di visualizzazione JSON.
  • Tipo di evento previsto
  • Operazione eseguita (ad esempio, macchina virtuale avviata o arrestata, account di archiviazione creato e così via)
  • Descrizione del problema rilevato (ad esempio, macchina virtuale avviata e nessun evento Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged generato)
  • Se possibile, specificare l'ID di correlazione dell'operazione eseguita

Per un evento ritardato o con contenuto imprevisto

  • Nome del tipo di argomento di sistema
  • Intero contenuto della notifica, escluso data.resourceInfo.properties
  • Descrizione del problema rilevato e dei valori dei campi interessati

Assicurarsi di non fornire informazioni personali dell'utente finale durante la condivisione di questi dati.

Passaggi successivi

Vedere Sottoscrivere le notifiche delle risorse di Azure - Eventi del servizio contenitore.