Compartilhar via

Notificações de Recursos do Azure – Eventos de Recursos de Integridade na Grade de Eventos do Azure (versão prévia)

  • Artigo

O tópico do sistema HealthResources fornece informações de integridade precisas, confiáveis e abrangentes, permitindo uma compreensão mais profunda dos diversos problemas de serviço que afetam seus recursos do Azure, ou seja, VMs (máquinas virtuais) de instância única, VMS do Conjunto de Dimensionamento de Máquinas Virtuais e Conjuntos de Dimensionamento de Máquinas Virtuais. Os Recursos de Integridade oferecem dois tipos de evento para consumo: AvailabilityStatusChanged e ResourceAnnotated.

Este artigo fornece as propriedades e o esquema para eventos de Recursos de Integridade de 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

Os Recursos de Integridade oferecem dois tipos de evento para consumo:

Tipo de evento Descrição
Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged Gerado quando o status de disponibilidade de uma única VM, um conjunto de dimensionamento de máquinas virtuais ou uma VM em um conjunto de dimensionamento de máquinas virtuais é alterado.

Essas informações fornecem informações sobre todas as vezes em que suas VMs de instância única, VMs em conjuntos de dimensionamento de máquinas virtuais ou conjuntos de dimensionamento de máquinas virtuais estão indisponíveis devido a problemas de serviço do Azure. Para obter mais informações sobre os vários status de integridade, confira Visão geral do Azure Resource Health - Integridade do Serviço do Azure.

Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated Gerado quando a integridade de uma VM, um conjunto de dimensionamento de máquinas virtuais ou uma VM em um conjunto de dimensionamento de máquinas virtuais, é afetada pela disponibilidade que afeta as interrupções. A plataforma emite contexto sobre por que a interrupção ocorreu para ajudá-lo a responder adequadamente.

Essas informações ajudam você a inferir o estado de disponibilidade de seus recursos fornecendo informações cruciais sobre os motivos e as causas das alterações na disponibilidade. Usando esses dados, você pode tomar medidas de mitigação mais rápidas e direcionadas. Para obter mais informações sobre as várias anotações emitidas, confira Anotações de Integridade da máquina virtual do Resource Health.

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/subscribeToHealthResources/action.

Esquemas de eventos

Aqui está o esquema:

{
    "id": string,
    "source": string,
    "subject": string,
    "type": "Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged | Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated",
    "time ": string, 
    "data": {
        "resourceInfo": {
            "id": string,
            "name": string,
            "type": string,
            "properties": { 
                <<Different for AvailabilityStatusChanged event and ResourceAnnotated event>>            
            }
        },
        "operationalInfo":{
			"resourceEventTime": 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. Nesse contexto, é Microsoft.ResourceHealth/AvailabilityStatuses ou Microsoft.ResourceHealth/ResourceAnnotated.
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 properties dentro do objeto data é diferente para eventos AvailabilityStatusChanged e ResourceAnnotated.

Propriedades do evento AvailabilityStatusChanged

            "properties": {
                "targetResourceId": string,
                "targetResourceType": string,
                "occurredTime": string,
                "previousAvailabilityState": string,
                "availabilityState": string
            }

Para o evento AvailabilityStatusChanged, o objeto properties tem as seguintes propriedades:

Propriedade Type Descrição
targetResourceId Cadeia de caracteres O recurso base para o qual as informações de disponibilidade estão sendo emitidas.
targetResourceType String O tipo do recurso base.
occurredTime String A hora em que esse evento real foi emitido.
previousAvailabilityState String Status de disponibilidade anterior.
availabilityState String Status de disponibilidade atual. Para obter a lista de valores, confira Status de Disponibilidade - Obter por Recurso - API REST (Azure Resource Health).

Propriedades do evento ResourceAnnotated

            "properties": {
                "targetResourceId": string,
                "targetResourceType": string,
                "occurredTime": string,
                "annotationName": string,
                "reason": string,
                "summary": string,
                "context": string,
                "category": string,
            }

Para o evento ResourceAnnotated, o objeto properties tem as seguintes propriedades:

Propriedade Type Descrição
targetResourceId Cadeia de caracteres O recurso base para o qual as informações de anotação estão sendo emitidas.
targetResourceType String O tipo do recurso base.
occurredTime String Carimbo de data/hora quando a anotação foi emitida pela plataforma do Azure em resposta ao evento que influencia a disponibilidade.
annotationName String O nome da anotação. Para obter a lista de anotações e as descrições correspondentes, confira Anotações de Integridade da máquina virtual do Resource Health - Integridade do Serviço do Azure.
reason String Breve instrução sobre por que a disponibilidade de recursos foi alterada ou influenciada.
summary String Instrução detalhada sobre a atividade e a causa da alteração ou influência da disponibilidade de recursos.
context String Determina se a disponibilidade de recursos foi influenciada devido à atividade causada pelo usuário ou pelo Azure.
category String Determina se a disponibilidade de recursos foi influenciada devido à atividade planejada ou não planejada. Essa propriedade só é aplicável a eventos Platform-Initiated.

Exemplos de eventos

Evento AvailabilityStatusChanged

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

{
  "id": "1fb6fa94-d965-4306-abeq-4810f0774e97",
  "source": "/subscriptions/{subscription-id}",
  "subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
  "data": {
    "resourceInfo": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}/providers/Microsoft.ResourceHealth/availabilityStatuses/{event-id}",
      "name": "{event-id}",
      "type": "Microsoft.ResourceHealth/availabilityStatuses",
      "properties": {
        "targetResourceId": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
        "targetResourceType": "Microsoft.Compute/virtualMachines",
        "occurredTime": "2023-07-24T19:20:37.9245071Z",
        "previousAvailabilityState": "Unavailable",
        "availabilityState": "Available"
      }
    },
    "operationalInfo": {
      "resourceEventTime": "2023-07-24T19:20:37.9245071Z"
    },
    "apiVersion": "2023-12-01"
  },
  "type": "Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged",
  "specversion": "1.0",
  "time": "2023-07-24T19:20:37.9245071Z"
}

Evento ResourceAnnotated

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

{
  "id": "8945cf9b-e220-496e-ab4f-f3a239318995",
  "source": "/subscriptions/{subscription-id}",
  "subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
  "data": {
    "resourceInfo": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}/providers/Microsoft.ResourceHealth/resourceAnnotations/{event-id}",
      "name": "{event-id}",
      "type": "Microsoft.ResourceHealth/resourceAnnotations",
      "properties": {
        "targetResourceId": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
        "targetResourceType": "Microsoft.Compute/virtualMachines",
        "occurredTime": "2023-07-24T19:20:37.9245071Z",
        "annotationName": "VirtualMachineDeallocationInitiated",
        "reason": "Stopping and deallocating",
        "summary": "This virtual machine is stopped and deallocated as requested by an authorized user or process.",
        "context": "Customer Initiated",
        "category": "Not Applicable"
      }
    },
    "operationalInfo": {
      "resourceEventTime": "2023-07-24T19:20:37.9245071Z"
    },
    "apiVersion": "2022-08-01"
  },
  "type": "Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated",
  "specversion": "1.0",
  "time": "2023-07-24T19:20:37.9245071Z"
}

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

Confira Assinar Notificações de Recursos do Azure - Eventos de Recursos de Integridade.