Compartilhar via

Notificações de Recursos do Azure – Eventos ContainerService na Grade de Eventos do Azure (Versão Prévia)

  • Artigo

O Serviço de Kubernetes do Azure (AKS) usa o tópico do sistema de Recursos de Eventos do Serviço de Contêiner para fornecer notificações preventivas para atividades de manutenção agendadas em clusters do AKS. Essa funcionalidade permite a recepção de notificações por push para tarefas de manutenção essenciais em diferentes estágios de evento, incluindo agendadas, iniciadas, concluídas, canceladas e com falha. Notavelmente, para o estágio agendado, as notificações são expedidas 7 dias e 24 horas antes da atividade de manutenção real.

As notificações abrangem:

  • Manutenção iniciada pelo AKS (por exemplo, migração de subposição, Comutador de Túnel Konnectivity)
  • Manutenção iniciada pelos clientes (como atualização automática, atualização do sistema operacional do Nó e janelas de lançamento semanais)

Essas notificações prospectivas ajudam os clientes oferecendo a oportunidade de se preparar melhor para possíveis interrupções, com o objetivo de minimizar as despesas operacionais.

Este artigo fornece as propriedades e o esquema para eventos ContainerService dos Recursos das Notificações de Recursos do Azure. Para obter uma introdução geral dos esquemas de evento, confira Esquema de eventos da Grade de Eventos do Azure. Além disso, você pode encontrar exemplos de eventos gerados e um link para um artigo relacionado sobre como criar um tópico do sistema para esse tipo de tópico.

Tipos de evento

ContainerService oferece o seguinte tipo de evento para consumo:

Tipo de evento Descrição
Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted fornece notificações antecipadas para eventos de manutenção agendados em clusters do AKS.

Controle de acesso baseado em função

Atualmente, esses eventos são emitidos exclusivamente no escopo da assinatura do Azure. Isso implica que a entidade que cria a assinatura de evento para este tipo de tópico recebe notificações em toda essa assinatura do Azure. Por motivos de segurança, é imperativo restringir a capacidade de criar assinaturas de evento nesse tópico para entidades de segurança com acesso de leitura em toda a assinatura do Azure. Para acessar dados por meio desse tópico do sistema, além das permissões genéricas exigidas pela Grade de Eventos, a seguinte permissão específica de Notificações de Recursos do Azure é necessária: ``.

Microsoft.ResourceNotifications/systemTopics/subscribeToContainerServiceEventResources/action

Esquemas de eventos

Aqui está o esquema:

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

Um evento tem os seguintes dados de nível superior:

Propriedade Type Descrição
id Cadeia de caracteres Identificador exclusivo do evento
source String A assinatura do Azure para a qual este tópico do sistema está sendo criado.
subject String Caminho definido pelo publicador para o recurso base no qual esse evento é emitido.
type String Tipo de evento registrado deste tipo de tópico do sistema
time String
Formato: 2022-11-07T18:43:09.2894075Z		 A hora em que o evento é gerado com base na hora UTC do provedor
data Objeto Contém dados de evento específicos para o provedor de recursos. Para obter mais informações, confira a próxima seção.
specversion String Versão de especificação do esquema CloudEvents.

O objeto data tem as seguintes propriedades:

Propriedade Type Descrição
resourceInfo Objeto Dados específicos do recurso. Para obter mais informações, confira a próxima seção.
apiVersion String Versão da API das propriedades do recurso.
operationalInfo Objeto Detalhes das informações operacionais relativas ao recurso.

O objeto resourceInfo tem as seguintes propriedades:

Propriedade Type Descrição
id Cadeia de caracteres Caminho definido pelo publicar para o assunto do evento
name String Esse campo indica a ID do evento. Ele sempre usa o valor da última seção do campo id.
type String O tipo de evento que está sendo emitido.
location String Região em que o recursos está localizado
properties Objeto Conteúdo do recurso. Para obter mais informações, confira a próxima seção.

O objeto operationalInfo tem as seguintes propriedades:

Propriedade Type Descrição
resourceEventTime DateTime Data e hora em que o recurso foi atualizado.

O evento ScheduledEventEmitted tem as seguintes propriedades:

Propriedade Type Descrição
description String A descrição do evento.
eventId String A ID do evento do evento.
eventSource String A fonte do evento.
eventStatus Enumeração (cadeia de caracteres) Status do evento que pode ser – Agendado, Iniciado, Concluído, Cancelado, Com Falha.
eventDetails String Os detalhes do evento.
scheduledTime Cadeia de caracteres (formato de data e hora) A hora do evento está agendada para começar.
lastUpdateTime Cadeia de caracteres (formato de data e hora) A última vez que o estado do evento foi atualizado.
resources Matriz de cadeias de caracteres (formato de ID do Azure Resource Manager) A lista de recursos afetados pelo evento.
resourceType String O tipo de recurso do evento

Exemplos de eventos

O exemplo a seguir mostra o esquema de um evento de modificação de valor-chave:

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

Fale conosco

Se você tiver dúvidas ou comentários sobre esse recursos, não hesite em nos contatar em arnsupport@microsoft.com.

Para ajudar você melhor com comentários específicos sobre um determinado evento, forneça as seguintes informações:

Para eventos ausentes:

  • Nome do tipo de tópico do sistema
  • Carimbo de data/hora aproximado em UTC quando a operação foi executada
  • ID do recurso base para a qual a notificação foi gerada
  • Navegue até o recurso no portal do Azure e selecione o modo de exibição JSON no canto superior direito. A ID do recurso é o primeiro campo na página de exibição JSON.
  • Tipo de evento esperado
  • Operação executada (por exemplo, VM iniciada ou interrompida, conta de armazenamento criada etc.)
  • Descrição do problema encontrado (por exemplo, VM iniciada e nenhum evento Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged gerado)
  • Se possível, forneça a ID de correlação da operação executada

Para o evento que foi atrasado ou tem conteúdo inesperado

  • Nome do tipo de tópico do sistema
  • Conteúdo inteiro da notificação excluindo data.resourceInfo.properties
  • Descrição do problema encontrado e valores de campo afetados

Verifique se você não está fornecendo informações identificáveis do usuário final enquanto compartilha esses dados.

Próximas etapas

Consulte Assinar Notificações de Recursos do Azure – Eventos do Serviço de Contêiner.