Notificações de Recursos do Azure - eventos de Recursos de Integridade na Grade de Eventos do Azure (Visualização)
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, máquinas virtuais (VMs) de instância única, VMS de Conjunto de Escala de Máquina Virtual e Conjuntos de Dimensionamento de Máquina Virtual. A Health Resources oferece dois tipos de eventos 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 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
A Health Resources oferece dois tipos de eventos para consumo:
| Tipo de evento | Description |
|---|---|
Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged |
Gerado quando o status de disponibilidade de uma VM de instância única, um conjunto de escala de máquina virtual ou uma VM em um conjunto de escala de máquina virtual muda. Essas informações fornecem informações sobre todas as vezes que suas VMs de instância única, VMs em conjuntos de escala de máquina virtual ou conjuntos de escala de máquina virtual não estão disponíveis devido a problemas de serviço do Azure. Para obter mais informações sobre os vários status de integridade, consulte Visão geral da Integridade dos Recursos do Azure - Integridade do Serviço do Azure. |
Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated |
Gerado quando a integridade de uma VM, de um conjunto de dimensionamento de máquina virtual ou de uma VM em um conjunto de dimensionamento de máquina virtual é afetada pela disponibilidade que afeta interrupções. A plataforma emite contexto sobre o motivo pelo qual a interrupção ocorreu para ajudá-lo a responder adequadamente. Estas informações ajudam-no a inferir o estado de disponibilidade dos seus recursos, fornecendo informações cruciais sobre as razões e 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, consulte Anotações de integridade da máquina virtual de integridade do recurso. |
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/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 | 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 a 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. Neste contexto, ou é Microsoft.ResourceHealth/AvailabilityStatuses ou Microsoft.ResourceHealth/ResourceAnnotated. |
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 properties interior do data objeto é diferente para AvailabilityStatusChanged e ResourceAnnotated eventos.
Propriedades para o evento AvailabilityStatusChanged
"properties": {
"targetResourceId": string,
"targetResourceType": string,
"occurredTime": string,
"previousAvailabilityState": string,
"availabilityState": string
}
Para o AvailabilityStatusChanged evento, o properties objeto tem as seguintes propriedades:
| Propriedade | Type | Description |
|---|---|---|
targetResourceId |
String | O recurso base para o qual as informações de disponibilidade estão sendo emitidas. |
targetResourceType |
String | O tipo do recurso base. |
occurredTime |
String | O momento em que este evento real foi emitido. |
previousAvailabilityState |
String | Estado de disponibilidade anterior. |
availabilityState |
String | Status de disponibilidade atual. Para obter a lista de valores, consulte Status de disponibilidade - Obter por recurso - API REST (Azure Resource Health). |
Propriedades para o evento ResourceAnnotated
"properties": {
"targetResourceId": string,
"targetResourceType": string,
"occurredTime": string,
"annotationName": string,
"reason": string,
"summary": string,
"context": string,
"category": string,
}
Para o ResourceAnnotated evento, o properties objeto tem as seguintes propriedades:
| Propriedade | Type | Description |
|---|---|---|
targetResourceId |
String | 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 Azure em resposta a um evento que influencia a disponibilidade. |
annotationName |
String | O nome da anotação. Para obter a lista de anotações e as descrições correspondentes, consulte Anotações de integridade da máquina virtual de integridade do recurso - Integridade do Serviço do Azure. |
reason |
String | Breve declaração sobre por que a disponibilidade de recursos foi alterada ou influenciada. |
summary |
String | Declaração detalhada sobre a atividade e a causa para que a disponibilidade de recursos seja alterada ou influenciada. |
context |
String | Determina se a disponibilidade de recursos foi influenciada devido ao Azure ou à atividade causada pelo usuário. |
category |
String | Determina se a disponibilidade de recursos foi influenciada devido a atividades planejadas ou não planejadas. Esta propriedade só é aplicável a Platform-Initiated eventos. |
Exemplos de eventos
Evento AvailabilityStatusChanged
O exemplo a seguir mostra o esquema de um evento modificado chave-valor:
{
"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 modificado chave-valor:
{
"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"
}
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 eventos de Notificações de Recursos do Azure - Recursos de Integridade.