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

Artigo
06/19/2023

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

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.

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
Esquema de eventos da Grade de Eventos


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

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

Compartilhar via