You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/service-bus-messaging/includes/event-grid-service-bus.md
+16-16Lines changed: 16 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@
5
5
author: spelluru
6
6
ms.service: event-grid
7
7
ms.topic: include
8
-
ms.date: 10/20/2021
8
+
ms.date: 12/08/2022
9
9
ms.author: spelluru
10
10
ms.custom: include file
11
11
---
@@ -16,16 +16,16 @@ Service Bus emits the following event types:
16
16
17
17
| Event type | Description |
18
18
| ---------- | ----------- |
19
-
| Microsoft.ServiceBus.ActiveMessagesAvailableWithNoListeners | Raised when there are active messages in a Queue or Subscription and no receivers listening. |
20
-
| Microsoft.ServiceBus.DeadletterMessagesAvailableWithNoListeners | Raised when there are active messages in a Dead Letter Queue and no active listeners. |
21
-
| Microsoft.ServiceBus.ActiveMessagesAvailablePeriodicNotifications | Raised every 30 seconds if there are active messages in a queue or subscription, even if there are active listeners on that specific queue or subscription. It's also raised when the active message count transitions from 0 to a positive value for the queue or subscription. |
22
-
| Microsoft.ServiceBus.DeadletterMessagesAvailablePeriodicNotifications | Raised every 30 seconds if there are messages in the dead-letter entity of a queue or subscription, even if there are active listeners on the dead-letter entity of that specific queue or subscription. It's also raised when the dead-letter message count transitions from 0 to a positive value for the dead-letter entity of the queue or subscription. |
19
+
|`Microsoft.ServiceBus.ActiveMessagesAvailableWithNoListeners`| Raised when there are active messages in a queue or subscription and no receivers listening. |
20
+
|`Microsoft.ServiceBus.DeadletterMessagesAvailableWithNoListeners`| Raised when there are active messages in a dead letter queue and no active listeners. |
21
+
|`Microsoft.ServiceBus.ActiveMessagesAvailablePeriodicNotifications`| Raised every 30 seconds if there are active messages in a queue or subscription, even if there are active listeners on that specific queue or subscription. It's also raised when the active message count transitions from 0 to a positive value for the queue or subscription. |
22
+
|`Microsoft.ServiceBus.DeadletterMessagesAvailablePeriodicNotifications`| Raised every 30 seconds if there are messages in the dead-letter entity of a queue or subscription, even if there are active listeners on the dead-letter entity of that specific queue or subscription. It's also raised when the dead-letter message count transitions from 0 to a positive value for the dead-letter entity of the queue or subscription. |
This event is generated if you have active messages in a queue or a subscription and there are no receivers listening.
30
30
31
31
```json
@@ -48,7 +48,7 @@ This event is generated if you have active messages in a queue or a subscription
48
48
}]
49
49
```
50
50
51
-
#### Deadletter Messages Available With No Listeners
51
+
#### Dead-letter messages available with no listeners
52
52
53
53
The schema for a dead letter queue event is similar. You get at least one event per dead-letter queue that has messages and no active receivers.
54
54
@@ -72,8 +72,8 @@ The schema for a dead letter queue event is similar. You get at least one event
72
72
}]
73
73
```
74
74
75
-
#### Active Messages Available Periodic Notifications
76
-
This event is generated periodically if you have active messages on the specific queue or subscription, even if there are active listeners on that specific queue or subscription.
75
+
#### Active messages available periodic notifications
76
+
This event is generated periodically if you have active messages in the specific queue or subscription, even if there are active listeners for that specific queue or subscription.
77
77
78
78
```json
79
79
[{
@@ -95,7 +95,7 @@ This event is generated periodically if you have active messages on the specific
95
95
}]
96
96
```
97
97
98
-
#### Deadletter Messages Available Periodic Notifications
98
+
#### Dead-letter messages available periodic notifications
99
99
This event is generated periodically if you have deadletter messages on the specific queue or subscription, even if there are active listeners on the deadletter entity of that specific queue or subscription.
100
100
101
101
```json
@@ -120,7 +120,7 @@ This event is generated periodically if you have deadletter messages on the spec
120
120
121
121
# [Cloud event schema](#tab/cloud-event-schema)
122
122
123
-
### Active Messages Available With No Listeners
123
+
### Active messages available with no listeners
124
124
This event is generated if you have active messages in a queue or a subscription and there are no receivers listening.
125
125
126
126
```json
@@ -142,7 +142,7 @@ This event is generated if you have active messages in a queue or a subscription
142
142
}]
143
143
```
144
144
145
-
#### Deadletter Messages Available With No Listeners
145
+
#### Deadletter messages available with no listeners
146
146
147
147
The schema for a dead letter queue event is similar. You get at least one event per dead-letter queue that has messages and no active receivers.
148
148
@@ -165,7 +165,7 @@ The schema for a dead letter queue event is similar. You get at least one event
165
165
}]
166
166
```
167
167
168
-
#### Active Messages Available Periodic Notifications
168
+
#### Active messages available periodic notifications
169
169
This event is generated periodically if you have active messages on the specific queue or subscription, even if there are active listeners on that specific queue or subscription.
170
170
171
171
```json
@@ -187,7 +187,7 @@ This event is generated periodically if you have active messages on the specific
187
187
}]
188
188
```
189
189
190
-
#### Deadletter Messages Available Periodic Notifications
190
+
#### Deadletter messages available periodic notifications
191
191
This event is generated periodically if you have deadletter messages on the specific queue or subscription, even if there are active listeners on the deadletter entity of that specific queue or subscription.
192
192
193
193
```json
@@ -220,7 +220,7 @@ An event has the following top-level data:
220
220
221
221
| Property | Type | Description |
222
222
| -------- | ---- | ----------- |
223
-
|`topic`| string | Full resource path to the event source. This field is not writeable. Event Grid provides this value. |
223
+
|`topic`| string | Full resource path to the event source. This field isn't writeable. Event Grid provides this value. |
224
224
|`subject`| string | Publisher-defined path to the event subject. |
225
225
|`eventType`| string | One of the registered event types for this event source. |
226
226
|`eventTime`| string | The time the event is generated based on the provider's UTC time. |
@@ -235,7 +235,7 @@ An event has the following top-level data:
235
235
236
236
| Property | Type | Description |
237
237
| -------- | ---- | ----------- |
238
-
|`source`| string | Full resource path to the event source. This field is not writeable. Event Grid provides this value. |
238
+
|`source`| string | Full resource path to the event source. This field isn't writeable. Event Grid provides this value. |
239
239
|`subject`| string | Publisher-defined path to the event subject. |
240
240
|`type`| string | One of the registered event types for this event source. |
241
241
|`time`| string | The time the event is generated based on the provider's UTC time. |
# Azure Service Bus to Event Grid integration overview
13
-
Service Bus can now emit events to Event Grid when there are messages in a queue or a subscription when no receivers are present. You can create Event Grid subscriptions to your Service Bus namespaces, listen to these events, and then react to the events by starting a receiver. With this feature, you can use Service Bus in reactive programming models. The key scenario of this feature is that Service Bus queues or subscriptions with a low volume of messages do not need to have a receiver that polls for messages continuously.
13
+
Service Bus can emit events to Event Grid when there are messages in a queue or a subscription when no receivers are present. You can create Event Grid subscriptions to your Service Bus namespaces, listen to these events, and then react to the events by starting a receiver. With this feature, you can use Service Bus in reactive programming models. The key scenario of this feature is that Service Bus queues or subscriptions with a low volume of messages do not need to have a receiver that polls for messages continuously.
14
14
15
15
To enable the feature, you need the following items:
16
16
@@ -43,7 +43,7 @@ You can create Event Grid subscriptions for Service Bus namespaces in three diff
43
43
```
44
44
### How many events are emitted, and how often?
45
45
46
-
If you have multiple queues and topics or subscriptions in the namespace, you get at least one event per queue and one per subscription. The events are emitted immediately if there are no messages in the Service Bus entity and a new message arrives. Or the events are emitted every two minutes unless Service Bus detects an active receiver. Message browsing does not interrupt the events.
46
+
If you have multiple queues and topics or subscriptions in the namespace, you get at least one event per queue and one per subscription. The events are emitted immediately if there are no messages in the Service Bus entity and a new message arrives. Or the events are emitted every two minutes unless Service Bus detects an active receiver. Message browsing doesn't interrupt the events.
47
47
48
48
By default, Service Bus emits events for all entities in the namespace. If you want to get events for specific entities only, see the next section.
:::image type="content" source="./media/service-bus-to-event-grid-integration-example/logic-apps-event-grid-trigger.png" alt-text="Screenshot of showing the Logic Apps Designer with Event Grid trigger selected.":::
37
37
4. Select **Sign in**, enter your Azure credentials, and select **Allow Access**.
38
38
5. On the **When a resource event occurs** page, do the following steps:
39
39
1. Select your Azure subscription.
@@ -43,23 +43,26 @@ In this step, you create an Azure logic app that receives Service Bus events via
43
43
44
44
:::image type="content" source="./media/service-bus-to-event-grid-integration-example/add-new-parameter-suffix-filter.png" alt-text="Image showing the addition of a suffix filter.":::
45
45
1. For **Suffix Filter**, enter the name of your Service Bus topic subscription.
:::image type="content" source="./media/service-bus-to-event-grid-integration-example/logic-apps-event-grid-trigger.png" alt-text="Screenshot of showing the Logic Apps Designer with connection configuration for the Service Bus namespace.":::
47
48
1. Select **+ New Step** in the designer, and do the following steps:
48
49
1. Search for **Service Bus**.
49
50
2. Select **Service Bus** in the list.
50
51
3. Select for **Get messages** in the **Actions** list.
51
52
4. Select **Get messages from a topic subscription (peek-lock)**.
52
53
53
-

54
-
5. Enter a **name for the connection**. For example: **Get messages from the topic subscription**, and select the Service Bus namespace.
55
-
56
-

57
-
6. Select **RootManageSharedAccessKey**, and then select **Create**.
58
-
59
-

54
+
:::image type="content" source="./media/service-bus-to-event-grid-integration-example/service-bus-get-messages-step.png" alt-text="Screenshot of showing the Logic Apps Designer with Get messages from a topic subscription selected.":::
55
+
5. Follow these steps:
56
+
1. Enter a **name for the connection**. For example: **Get messages from the topic subscription**.
57
+
1. Confirm that **Authentication Type** is set to **Access Key**.
58
+
1. For **Connection String**, copy and paste the connection string to the Service Bus namespace that you saved earlier.
59
+
1. Select **Create**.
60
+
61
+
:::image type="content" source="./media/service-bus-to-event-grid-integration-example/logic-app-shared-access-key.png" alt-text="Screenshot of showing the Logic Apps Designer with the Service Bus connection string specified.":::
60
62
8. Select your **topic** and **subscription**.
61
63
62
-

64
+
65
+
:::image type="content" source="./media/service-bus-to-event-grid-integration-example/logic-app-shared-access-key.png" alt-text="Screenshot of showing the Logic Apps Designer with the Service Bus topic and subscription specified.":::
63
66
64
67
### Add a step to process and complete received messages
65
68
In this step, you'll add steps to send the received message in an email and then complete the message. In a real-world scenario, you'll process a message in the logic app before completing the message.
0 commit comments