bus di servizio di Azure come origine di Griglia di eventi

  • Articolo

Questo articolo illustra le proprietà e lo schema per gli eventi del bus di servizio. Per un'introduzione agli schemi di eventi, vedere Schema di eventi di Griglia di eventi di Azure.

Nota

Solo il livello Premium bus di servizio spazio dei nomi supporta l'integrazione degli eventi. I livelli Basic e Standard non supportano l'integrazione con Griglia di eventi.

Tipi di evento disponibili

Il bus di servizio genera i tipi di eventi seguenti:

Tipo di evento Descrizione
Microsoft.ServiceBus.ActiveMessagesAvailableWithNoListeners Generato quando arriva un nuovo messaggio attivo in una coda o una sottoscrizione e non sono presenti ricevitori in ascolto.
Microsoft.ServiceBus.DeadletterMessagesAvailableWithNoListeners Generato quando arriva un nuovo messaggio attivo in una coda di messaggi non recapitabili e non sono presenti listener attivi.
Microsoft.ServiceBus.ActiveMessagesAvailablePeriodicNotifications Generato ogni 30 secondi se sono presenti messaggi attivi in una coda o in una sottoscrizione, anche se sono presenti listener attivi in tale coda o sottoscrizione specifica. Viene generato anche quando il numero di messaggi attivi passa da 0 a un valore positivo per la coda o la sottoscrizione.
Microsoft.ServiceBus.DeadletterMessagesAvailablePeriodicNotifications Generato ogni 30 secondi se sono presenti messaggi nell'entità di messaggi non recapitabili di una coda o di una sottoscrizione, anche se sono presenti listener attivi nell'entità di messaggi non recapitabili di tale coda o sottoscrizione specifica. Viene generato anche quando il conteggio dei messaggi non recapitabili passa da 0 a un valore positivo per l'entità di messaggi non recapitabili della coda o della sottoscrizione.

Evento di esempio

Messaggi attivi disponibili senza listener

Questo evento viene generato se in una coda o una sottoscrizione sono presenti messaggi attivi e nessun ricevitore è in ascolto.

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

Messaggi non recapitabili disponibili senza listener

Lo schema per un evento di coda di messaggi non recapitabili è simile. Si ottiene almeno un evento per coda di messaggi non recapitabili con messaggi e senza ricevitori attivi.

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

Messaggi attivi disponibili notifiche periodiche

Questo evento viene generato periodicamente se sono presenti messaggi attivi nella coda o nella sottoscrizione specifica, anche se sono presenti listener attivi per tale coda o sottoscrizione specifica.

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

Messaggi non recapitabili disponibili notifiche periodiche

Questo evento viene generato periodicamente se sono presenti messaggi non recapitabili nella coda o nella sottoscrizione specifica, anche se sono presenti listener attivi nell'entità deadletter di tale coda o sottoscrizione specifica.

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

Proprietà dell'evento

Un evento presenta i seguenti dati di primo livello:

Proprietà Type Descrzione
topic string Percorso completo della risorsa all'origine evento. Questo campo non è scrivibile. Questo valore viene specificato da Griglia di eventi.
subject string Percorso definito dall'editore all'oggetto dell'evento.
eventType string Uno dei tipi di evento registrati per l'origine evento.
eventTime string Ora di generazione dell'evento in base all'ora UTC del provider.
id string Identificatore univoco per l'evento.
data oggetto Dati relativi all'evento di archiviazione BLOB.
dataVersion string Versione dello schema dell'oggetto dati. La versione dello schema è definita dall'origine di pubblicazione.
metadataVersion string Versione dello schema dei metadati dell'evento. Lo schema delle proprietà di primo livello è definito da Griglia di eventi. Questo valore viene specificato da Griglia di eventi.

Di seguito sono elencate le proprietà dell'oggetto dati:

Proprietà Type Descrzione
namespaceName string Spazio dei nomi del bus di servizio in cui esiste la risorsa.
requestUri string URI della coda o della sottoscrizione specifica che crea l'evento.
entityType string Tipo di entità del bus di servizio che crea gli eventi (coda o sottoscrizione).
queueName string Coda con messaggi attivi in caso di sottoscrizione di una coda. Valore null se si usano argomenti/sottoscrizioni.
topicName string Argomento a cui appartiene la sottoscrizione del bus di servizio con messaggi attivi. Valore null se si usa una coda.
subscriptionName string Sottoscrizione del bus di servizio con messaggi attivi. Valore null se si usa una coda.

Esercitazioni e procedure

Posizione Descrizione
Esercitazione: esempi dell'integrazione del bus di servizio di Azure in Griglia di eventi di Azure Griglia di eventi invia i messaggi dall'argomento del bus di servizio all'app per le funzioni e all'app per la logica.
bus di servizio di Azure all'integrazione di Griglia di eventi Panoramica dell'integrazione del bus di servizio con Griglia di eventi.

Nota

Quando si verifica un failover per uno spazio dei nomi bus di servizio abilitato per il ripristino di emergenza geografico, lo spazio dei nomi secondario non genera eventi in Griglia di eventi. È necessario aggiungere manualmente la sottoscrizione di Griglia di eventi per lo spazio dei nomi secondario.

Passaggi successivi