Barramento de Serviço do Azure como uma origem de Grade de Eventos

  • Artigo

Este artigo fornece as propriedades e o esquema para eventos do Service Bus. Para obter uma introdução aos esquemas de eventos, consulte Esquema de eventos da Grade de Eventos do Azure.

Nota

Somente o namespace do Service Bus de camada Premium oferece suporte à integração de eventos. As camadas Básica e Padrão não suportam a integração com a Grade de Eventos.

Tipos de eventos disponíveis

O Service Bus emite os seguintes tipos de eventos:

Tipo de evento Description
Microsoft.ServiceBus.ActiveMessagesAvailableWithNoListeners Gerado quando uma nova mensagem ativa chega em uma fila ou assinatura e não há recetores ouvindo.
Microsoft.ServiceBus.DeadletterMessagesAvailableWithNoListeners Gerado quando uma nova mensagem ativa chega em uma fila de letra morta e não há ouvintes ativos.
Microsoft.ServiceBus.ActiveMessagesAvailablePeriodicNotifications Gerado a cada 30 segundos se houver mensagens ativas em uma fila ou assinatura, mesmo que haja ouvintes ativos nessa fila ou assinatura específica. Ele também é aumentado quando a contagem de mensagens ativas passa de 0 para um valor positivo para a fila ou assinatura.
Microsoft.ServiceBus.DeadletterMessagesAvailablePeriodicNotifications Gerado a cada 30 segundos se houver mensagens na entidade de letra morta de uma fila ou assinatura, mesmo que haja ouvintes ativos na entidade de letra morta dessa fila ou assinatura específica. Ele também é gerado quando a contagem de mensagens mortas transita de 0 para um valor positivo para a entidade de letra morta da fila ou assinatura.

Exemplo de evento

Mensagens ativas disponíveis sem ouvintes

Este evento é gerado se tiver mensagens ativas numa fila ou subscrição, sem recetores à escuta.

[{
  "topic": "/subscriptions/{subscription-id}/resourcegroups/{your-rg}/providers/Microsoft.ServiceBus/namespaces/{your-service-bus-namespace}",
  "subject": "topics/{your-service-bus-topic}/subscriptions/{your-service-bus-subscription}",
  "eventType": "Microsoft.ServiceBus.ActiveMessagesAvailableWithNoListeners",
  "eventTime": "2018-02-14T05:12:53.4133526Z",
  "id": "dede87b0-3656-419c-acaf-70c95ddc60f5",
  "data": {
    "namespaceName": "YOUR SERVICE BUS NAMESPACE WILL SHOW HERE",
    "requestUri": "https://{your-service-bus-namespace}.servicebus.windows.net/{your-topic}/subscriptions/{your-service-bus-subscription}/messages/head",
    "entityType": "subscriber",
    "queueName": "QUEUE NAME IF QUEUE",
    "topicName": "TOPIC NAME IF TOPIC",
    "subscriptionName": "SUBSCRIPTION NAME"
  },
  "dataVersion": "1",
  "metadataVersion": "1"
}]

Mensagens mortas disponíveis sem ouvintes

O esquema para um evento de fila de letra morta é semelhante. Você recebe pelo menos um evento por fila de mensagens mortas que tem mensagens e nenhum recetor ativo.

[{
  "topic": "/subscriptions/{subscription-id}/resourcegroups/{your-rg}/providers/Microsoft.ServiceBus/namespaces/{your-service-bus-namespace}",
  "subject": "topics/{your-service-bus-topic}/subscriptions/{your-service-bus-subscription}",
  "eventType": "Microsoft.ServiceBus.DeadletterMessagesAvailableWithNoListeners",
  "eventTime": "2018-02-14T05:12:53.4133526Z",
  "id": "dede87b0-3656-419c-acaf-70c95ddc60f5",
  "data": {
    "namespaceName": "YOUR SERVICE BUS NAMESPACE WILL SHOW HERE",
    "requestUri": "https://{your-service-bus-namespace}.servicebus.windows.net/{your-topic}/subscriptions/{your-service-bus-subscription}/$deadletterqueue/messages/head",
    "entityType": "subscriber",
    "queueName": "QUEUE NAME IF QUEUE",
    "topicName": "TOPIC NAME IF TOPIC",
    "subscriptionName": "SUBSCRIPTION NAME"
  },
  "dataVersion": "1",
  "metadataVersion": "1"
}]

Mensagens ativas disponíveis notificações periódicas

Esse evento é gerado periodicamente se você tiver mensagens ativas na fila ou assinatura específica, mesmo que haja ouvintes ativos para essa fila ou assinatura específica.

[{
  "topic": "/subscriptions/<subscription id>/resourcegroups/DemoGroup/providers/Microsoft.ServiceBus/namespaces/<YOUR SERVICE BUS NAMESPACE WILL SHOW HERE>",
  "subject": "topics/<service bus topic>/subscriptions/<service bus subscription>",
  "eventType": "Microsoft.ServiceBus.ActiveMessagesAvailablePeriodicNotifications",
  "eventTime": "2018-02-14T05:12:53.4133526Z",
  "id": "dede87b0-3656-419c-acaf-70c95ddc60f5",
  "data": {
    "namespaceName": "YOUR SERVICE BUS NAMESPACE WILL SHOW HERE",
    "requestUri": "https://YOUR-SERVICE-BUS-NAMESPACE-WILL-SHOW-HERE.servicebus.windows.net/TOPIC-NAME/subscriptions/SUBSCRIPTIONNAME/$deadletterqueue/messages/head",
    "entityType": "subscriber",
    "queueName": "QUEUE NAME IF QUEUE",
    "topicName": "TOPIC NAME IF TOPIC",
    "subscriptionName": "SUBSCRIPTION NAME"
  },
  "dataVersion": "1",
  "metadataVersion": "1"
}]

Mensagens mortas disponíveis notificações periódicas

Esse evento é gerado periodicamente se você tiver mensagens de deadletter na fila ou assinatura específica, mesmo que haja ouvintes ativos na entidade deadletter dessa fila ou assinatura específica.

[{
  "topic": "/subscriptions/<subscription id>/resourcegroups/DemoGroup/providers/Microsoft.ServiceBus/namespaces/<YOUR SERVICE BUS NAMESPACE WILL SHOW HERE>",
  "subject": "topics/<service bus topic>/subscriptions/<service bus subscription>",
  "eventType": "Microsoft.ServiceBus.DeadletterMessagesAvailablePeriodicNotifications",
  "eventTime": "2018-02-14T05:12:53.4133526Z",
  "id": "dede87b0-3656-419c-acaf-70c95ddc60f5",
  "data": {
    "namespaceName": "YOUR SERVICE BUS NAMESPACE WILL SHOW HERE",
    "requestUri": "https://YOUR-SERVICE-BUS-NAMESPACE-WILL-SHOW-HERE.servicebus.windows.net/TOPIC-NAME/subscriptions/SUBSCRIPTIONNAME/$deadletterqueue/messages/head",
    "entityType": "subscriber",
    "queueName": "QUEUE NAME IF QUEUE",
    "topicName": "TOPIC NAME IF TOPIC",
    "subscriptionName": "SUBSCRIPTION NAME"
  },
  "dataVersion": "1",
  "metadataVersion": "1"
}]

Propriedades do evento

Um evento tem os seguintes dados de nível superior:

Propriedade Type Description
topic string Caminho completo do recurso para a origem do evento. Este campo não pode ser gravado. O Event Grid fornece este valor.
subject string Caminho definido pelo publicador para o assunto do evento.
eventType string Um dos tipos de eventos registados para esta origem de 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 de 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. O Event Grid define o esquema das propriedades de nível superior. O Event Grid fornece este valor.

O objeto de dados tem as seguintes propriedades:

Propriedade Type Description
namespaceName string O namespace do Service Bus no qual o recurso existe.
requestUri string O URI para a fila específica ou assinatura que emite o evento.
entityType string O tipo de entidade do Service Bus emitindo eventos (fila ou assinatura).
queueName string A fila com mensagens ativas se estiver se inscrevendo em uma fila. Valor nulo se usar tópicos / assinaturas.
topicName string O tópico ao qual pertence a assinatura do Service Bus com mensagens ativas. Valor nulo se estiver usando uma fila.
subscriptionName string A assinatura do Service Bus com mensagens ativas. Valor nulo se estiver usando uma fila.

Tutorials and how-tos (Tutoriais e procedimentos)

Title Description
Tutorial: Exemplos de integração do Barramento de Serviço do Azure para a Grade de Eventos do Azure A Grade de Eventos envia mensagens do tópico do Service Bus para o aplicativo funcional e o aplicativo lógico.
Integração do Barramento de Serviço do Azure com a Grade de Eventos Visão geral da integração do Service Bus com a Grade de Eventos.

Nota

Quando ocorre um failover para um namespace do Service Bus habilitado para Geo-DR, o namespace secundário não emite eventos para a Grade de Eventos. Você precisa adicionar manualmente a assinatura da Grade de Eventos para o namespace secundário.

Próximos passos