Skip to content

Commit d4a2fca

Browse files
committed
Accessing explorer - private endpoint
1 parent 418d9be commit d4a2fca

File tree

2 files changed

+11
-9
lines changed

2 files changed

+11
-9
lines changed

articles/event-hubs/event-hubs-data-explorer.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,9 +20,10 @@ Operations run on an Azure Event Hubs namespace are of two kinds.
2020

2121
> [!IMPORTANT]
2222
> * The Event Hubs Data Explorer doesn't support **management operations**. The event hub must be created before the data explorer can send or view events from that event hub.
23-
> * While events payloads (known as **values** in Kafka) sent using the **Kafka protocol** will be visible via the data explorer, the **key** for the specific event will not be visible.
24-
> * We advise against using the Event Hubs Data Explorer for larger messages, as this may result in timeouts, depending on the message size, network latency between client and Service Bus service etc. Instead, we recommend that you use your own client to work with larger messages, where you can specify your own timeout values.
23+
> * While events payloads (known as **values** in Kafka) sent using the **Kafka protocol** is visible via the data explorer, the **key** for the specific event isn't visible.
24+
> * We advise against using the Event Hubs Data Explorer for larger messages, as this may result in time-outs, depending on the message size, network latency between client and Service Bus service etc. Instead, we recommend that you use your own client to work with larger messages, where you can specify your own time-out values.
2525
> * The operations that a user can perform using Event Hubs Data Explorer is determined by the [role-based access control (RBAC)](authorize-access-azure-active-directory.md#azure-built-in-roles-for-azure-event-hubs) role that the user is assigned to.
26+
> * If your Event Hubs namespace can only be accessed via a private endpoint, you must run your web browser on a host in the virtual network with the private endpoint, and also ensure that there are no network security gateways (NSGs) in the way.
2627
2728
## Prerequisites
2829

articles/service-bus-messaging/explorer.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,8 @@ Operations run on an Azure Service Bus namespace are of two kinds.
2121

2222
> [!IMPORTANT]
2323
> - Service Bus Explorer doesn't support **management operations** and **sessions**.
24-
> - We advice against using the Service Bus Explorer for larger messages, as it may result in timeouts, depending on the message size, network latency between client and Service Bus service etc. Instead, we recommend that you use your own client to work with larger messages, where you can specify your own timeout values.
24+
> - We advice against using the Service Bus Explorer for larger messages, as it may result in time-outs, depending on the message size, network latency between client and Service Bus service etc. Instead, we recommend that you use your own client to work with larger messages, where you can specify your own time-out values.
25+
> - If your Service Bus namespace can only be accessed via a private endpoint, you must run your web browser on a host in the virtual network with the private endpoint, and also ensure that there are no network security gateways (NSGs) in the way.
2526
2627

2728
## Prerequisites
@@ -58,7 +59,7 @@ To use the Service Bus Explorer, navigate to the Service Bus namespace on which
5859
> :::image type="content" source="./media/service-bus-explorer/subscription-selected.png" alt-text="Screenshot of dropdown for topic subscriptions." lightbox="./media/service-bus-explorer/subscription-selected.png":::
5960
6061
> [!NOTE]
61-
> When you navigate to Service Bus explorer for an entity in a namespace that has the public access disabled, you see the following message eventhough you access it from a virtual machine that's in the same virtual network as the private endpoint. You can ignore it.
62+
> When you navigate to Service Bus explorer for an entity in a namespace that has the public access disabled, you see the following message even though you access it from a virtual machine that's in the same virtual network as the private endpoint. You can ignore it.
6263
>
6364
> "The namespace has public network access disabled. Data operations such as Peek, Send, or Receive against this Service Bus entit don't work until you switch to all networks or allowlist your client IP in selected networks."
6465
@@ -90,7 +91,7 @@ With the peek functionality, you can use the Service Bus Explorer to view the to
9091
> Since peek isn't a destructive operation the message **won't** be removed from the entity.
9192
9293
> [!NOTE]
93-
> For performance reasons, when peeking messages from a queue or subscription which has it's maximum message size set over 1 MB, the message body isn't retrieved by default. Instead, you can load the message body for a specific message by clicking on the **Load message body** button. If the message body is over 1 MB it's not truncated before being displayed.
94+
> For performance reasons, when peeking messages from a queue or subscription which has its maximum message size set over 1 MB, the message body isn't retrieved by default. Instead, you can load the message body for a specific message by clicking on the **Load message body** button. If the message body is over 1 MB, it's not truncated before being displayed.
9495
> :::image type="content" source="./media/service-bus-explorer/peek-message-from-queue-with-large-message-support.png" alt-text="Screenshot with overview of peeked messages and button to load message body shown." lightbox="./media/service-bus-explorer/peek-message-from-queue-with-large-message-support.png":::
9596
9697
### Peek a message with advanced options
@@ -137,7 +138,7 @@ The receive function on the Service Bus Explorer permits receiving messages from
137138
:::image type="content" source="./media/service-bus-explorer/receive-message-from-queue.png" alt-text="Screenshot indicating the Receive button, and a page where the options can be set." lightbox="./media/service-bus-explorer/receive-message-from-queue.png":::
138139

139140
> [!IMPORTANT]
140-
> Note that the ReceiveAndDelete mode is a ***destructive receive***, i.e. the message is removed from the queue when it's displayed on the Service Bus Explorer tool.
141+
> The ReceiveAndDelete mode is a ***destructive receive***, that is, the message is removed from the queue when it's displayed on the Service Bus Explorer tool.
141142
>
142143
> To browse messages without removing them from the queue, consider using the **Peek** functionality, or using the **PeekLock** receive mode.
143144
@@ -148,7 +149,7 @@ The receive function on the Service Bus Explorer permits receiving messages from
148149
:::image type="content" source="./media/service-bus-explorer/receive-message-from-queue-3.png" alt-text="Screenshot with overview of received messages and message properties shown." lightbox="./media/service-bus-explorer/receive-message-from-queue-3.png":::
149150

150151
> [!NOTE]
151-
> For performance reasons, when receiving messages from a queue or subscription which has it's maximum message size set over 1 MB, only one message is received at a time. If the message body is over 1 MB, it's truncated before being displayed.
152+
> For performance reasons, when receiving messages from a queue or subscription which has its maximum message size set over 1 MB, only one message is received at a time. If the message body is over 1 MB, it's truncated before being displayed.
152153
153154
After a message is received in **PeekLock** mode, there are various actions you can take on it.
154155

@@ -163,7 +164,7 @@ After a message is received in **PeekLock** mode, there are various actions you
163164
:::image type="content" source="./media/service-bus-explorer/receive-message-from-queue-complete.png" alt-text="Screenshot indicating the Complete button." lightbox="./media/service-bus-explorer/receive-message-from-queue-complete.png":::
164165

165166
> [!IMPORTANT]
166-
> Please note that completing a message is a ***destructive receive***, that is, the message is removed from the queue when **Complete** has been selected in the Service Bus Explorer tool.
167+
> Completing a message is a ***destructive receive***, that is, the message is removed from the queue when **Complete** has been selected in the Service Bus Explorer tool.
167168
168169
### Defer a message
169170

@@ -211,7 +212,7 @@ To send a message to a **queue** or a **topic**, select the **Send messages** bu
211212

212213
:::image type="content" source="./media/service-bus-explorer/send-experience.png" alt-text="Screenshot showing the compose message experience." lightbox="./media/service-bus-explorer/send-experience.png":::
213214

214-
1. When the send operation is completed successfully, one of the following changes happen:
215+
1. When the send operation is completed successfully, one of the following changes happens:
215216

216217
- If sending to a queue, **Active Messages** metrics counter is incremented.
217218
- If sending to a topic, **Active Messages** metrics counter is incremented on the subscriptions where the message was routed to.

0 commit comments

Comments
 (0)