AKS (Serviço de Kubernetes do Azure) como origem da Grade de Eventos

Este artigo mostra as propriedades e o esquema para eventos do AKS. Além disso, conta com uma lista de guias de início rápido e tutoriais para usar o AKS como origem do evento. Para obter uma introdução a esquemas de evento, confira Esquema de eventos da Grade de Eventos do Azure e Esquema de eventos de nuvem.

Tipos de evento disponíveis

O AKS emite os seguintes tipos de evento

Tipo de evento	Descrição
Microsoft.ContainerService.NewKubernetesVersionAvailable	Disparado quando a lista de versões disponíveis do Kubernetes é atualizada.
Microsoft.ContainerService.ClusterSupportEnded	Disparado quando o cluster fica sem suporte
Microsoft.ContainerService.ClusterSupportEnding	Disparado quando a versão do kubernetes de clusters ficará sem suporte em breve
Microsoft.ContainerService.NodePoolRollingFailed	Disparado quando NodepoolRolling falha como resultado de upgrade ou atualização
Microsoft.ContainerService.NodePoolRollingStarted	Disparado quando NodepoolRolling foi iniciado como resultado de upgrade ou atualização
Microsoft.ContainerService.NodePoolRollingSucceeded	Disparado quando NodepoolRolling foi bem-sucedido como resultado de upgrade ou atualização

Propriedades comuns a todos os eventos

Esquema de evento de nuvem

Quando um evento é disparado, o serviço de Grade de Eventos envia dados sobre esse evento para o ponto de extremidade de assinatura. Esta seção mostra um exemplo de como os dados seriam para cada evento. Cada evento tem os seguintes dados de nível superior:

Propriedade	Type	Descrição
source	string	Caminho de recurso completo para a origem do evento. Este campo não é gravável. A Grade de Eventos fornece esse valor.
subject	string	Caminho definido pelo publicador para o assunto do evento.
type	string	Um dos tipos de evento registrados para a origem do evento.
time	string	A hora em que o evento é gerado com base na hora UTC do provedor.
id	string	Identificador exclusivo do evento.
data	objeto	Dados de eventos do armazenamento de blob.
specversion	string	Versão de especificação do esquema CloudEvents.

Esquema de eventos da Grade de Eventos

Quando um evento é disparado, o serviço de Grade de Eventos envia dados sobre esse evento para o ponto de extremidade de assinatura. Esta seção mostra um exemplo de como os dados seriam para cada evento. Cada evento tem os seguintes dados de nível superior:

Propriedade	Type	Descrição
topic	string	Caminho de recurso completo para a origem do evento. Este campo não é gravável. A Grade de Eventos fornece esse valor.
subject	string	Caminho definido pelo publicador para o assunto do evento.
eventType	string	Um dos tipos de evento registrados para a origem do evento.
eventTime	string	A hora em que o evento é gerado com base na hora UTC do provedor.
id	string	Identificador exclusivo do evento.
data	objeto	Dados de eventos do armazenamento de blob.
dataVersion	string	A versão do esquema do objeto de dados. O publicador define a versão do esquema.
metadataVersion	string	A versão do esquema dos metadados do evento. Grade de Eventos define o esquema de propriedades de nível superior. A Grade de Eventos fornece esse valor.

Exemplos de eventos

NewKubernetesVersionAvailable

Esquema de evento de nuvem

{
    "source": "/subscriptions/<id>/resourceGroups<rg>/providers/Microsoft.ContainerService/managedClusters/<cluster>",
    "subject": "<cluster>",
    "type": "Microsoft.ContainerService.NewKubernetesVersionAvailable",
    "id": "1234567890abcdef1234567890abcdef12345678",
    "data": {
      "latestSupportedKubernetesVersion": "1.20.7",
      "latestStableKubernetesVersion": "1.19.11",
      "lowestMinorKubernetesVersion": "1.18.19",
      "latestPreviewKubernetesVersion": "1.21.1"
    },
    "specversion": "1.0",
    "time": "2021-07-01T04:52:57.0000000Z"
}

Esquema de eventos da Grade de Eventos

{
    "topic": "/subscriptions/<id>/resourceGroups<rg>/providers/Microsoft.ContainerService/managedClusters/<cluster>",
    "subject": "<cluster>",
    "eventType": "Microsoft.ContainerService.NewKubernetesVersionAvailable",
    "id": "1234567890abcdef1234567890abcdef12345678",
    "data": {
      "latestSupportedKubernetesVersion": "1.20.7",
      "latestStableKubernetesVersion": "1.19.11",
      "lowestMinorKubernetesVersion": "1.18.19",
      "latestPreviewKubernetesVersion": "1.21.1"
    },
    "dataVersion": "1",
    "metadataVersion": "1",
    "eventTime": "2021-07-01T04:52:57.0000000Z"
}

O objeto de dados contém as seguintes propriedades:

Propriedade	Type	Descrição
latestSupportedKubernetesVersion	string	A versão mais recente compatível com o Kubernetes disponível.
latestStableKubernetesVersion	string	A versão estável mais recente compatível com o Kubernetes disponível.
lowestMinorKubernetesVersion	string	A versão mais antiga compatível com o Kubernetes disponível.
latestPreviewKubernetesVersion	string	A versão prévia mais recente do Kubernetes disponível.

Próximas etapas

Confira o tutorial a seguir: Início Rápido: assinar eventos do AKS (Serviço de Kubernetes do Azure) com a Grade de Eventos do Azure.