Notificações de Recursos do Azure - eventos ContainerService na Grade de Eventos do Azure (Visualização)
O Serviço Kubernetes do Azure (AKS) usa o tópico do sistema Recursos de Eventos do Serviço de Contêiner para fornecer notificações preventivas para atividades de manutenção agendadas em clusters AKS. Essa funcionalidade permite a receção de notificações push para tarefas de manutenção essenciais em diferentes estágios do evento, incluindo agendado, iniciado, concluído, cancelado e com falha. Notavelmente, para a fase programada, as notificações são enviadas 7 dias e 24 horas antes da atividade de manutenção real.
As notificações incluem:
- Manutenção iniciada pelo AKS (por exemplo, migração Underlay, Konnectivity Tunnel Switch)
- 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 prospetivas ajudam os clientes, oferecendo a oportunidade de se prepararem melhor para possíveis interrupções, com o objetivo final de minimizar as despesas operacionais.
Este artigo fornece as propriedades e o esquema para eventos do Azure Resource Notifications ContainerService. Para obter uma introdução aos esquemas de eventos em geral, consulte 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 | Description |
|---|---|
Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted |
fornece notificações antecipadas para eventos de manutenção programada em clusters AKS. |
Controlo de acesso baseado em funções
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 esse tipo de tópico receba notificações em toda essa assinatura do Azure. Por motivos de segurança, é imperativo restringir a capacidade de criar assinaturas de eventos neste tópico para entidades com acesso de leitura em toda a assinatura do Azure. Para acessar dados por meio deste 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 | Description |
|---|---|---|
id |
String | 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 Publisher 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 |
Object | Contém dados de evento específicos para o provedor de recursos. Para obter mais informações, consulte a tabela a seguir. |
specversion |
String | Versão da especificação do esquema CloudEvents. |
O data objeto tem as seguintes propriedades:
| Propriedade | Type | Description |
|---|---|---|
resourceInfo |
Object | Dados específicos do recurso. Para obter mais informações, consulte a tabela a seguir. |
apiVersion |
String | Versão da API das propriedades do recurso. |
operationalInfo |
Object | Detalhes das informações operacionais referentes ao recurso. |
O resourceInfo objeto tem as seguintes propriedades:
| Propriedade | Type | Description |
|---|---|---|
id |
String | Caminho definido pelo editor para o assunto do evento |
name |
String | Este campo indica o ID do evento. Ele sempre leva o valor da última seção do id campo. |
type |
String | O tipo de evento que está sendo emitido. |
location |
String | Local ou região onde o recurso está localizado. |
properties |
Object | Carga útil do recurso. Para obter mais informações, consulte a tabela a seguir. |
O operationalInfo objeto tem as seguintes propriedades:
| Propriedade | Type | Description |
|---|---|---|
resourceEventTime |
DateTime | Data e hora em que o recurso foi atualizado. |
O ScheduledEventEmitted evento tem as seguintes propriedades:
| Propriedade | Type | Description |
|---|---|---|
description |
String | A descrição do evento. |
eventId |
String | A ID do evento do evento. |
eventSource |
String | A origem do evento. |
eventStatus |
Enum (Corda) | Status do evento que pode ser – Agendado, Iniciado, Concluído, Cancelado, Reprovado. |
eventDetails |
String | Os detalhes do evento. |
scheduledTime |
String (formato de data-hora) | O horário do evento está programado para começar. |
lastUpdateTime |
String (formato de data-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 impactados pelo evento. |
resourceType |
String | O tipo de recurso do evento |
Exemplos de eventos
O exemplo a seguir mostra o esquema de um evento modificado chave-valor:
{
"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"
}
Contactos
Se você tiver alguma dúvida ou feedback sobre este recurso, não hesite em contactar-nos em arnsupport@microsoft.com.
Para melhor ajudá-lo com feedback específico sobre um determinado evento, forneça as seguintes informações:
Para eventos em falta:
- Nome do tipo de tópico do sistema
- Carimbo de data/hora aproximado em UTC quando a operação foi executada
- ID do recurso de base para o qual a notificação foi gerada
- Navegue até seu recurso no portal do Azure e selecione o modo de exibição JSON no canto direito. 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 o ID de correlação da operação executada
Para eventos que foram atrasados ou têm conteúdo inesperado
- Nome do tipo de tópico do sistema
- Todo o conteúdo da notificação, excluindo data.resourceInfo.properties
- Descrição do problema encontrado e dos valores de campo afetados
Certifique-se de que não está a fornecer quaisquer informações identificáveis do utilizador final enquanto partilha estes dados.
Próximos passos
Consulte Inscrever-se em Notificações de Recursos do Azure - Eventos do Serviço de Contêiner.