User guide
To setup Service Bus Cloud Explorer to be used for your tenant; create a Service Bus Cloud Explorer resource in Azure Portal or from Azure Marketplace. For more details on setup process; please visit: Setup in your tenant page.
To start Service Bus Cloud Explorer; users need to navigate to servicebus.cloudbricks.io and login with their organization accounts.
During the first time any user logs in to the app, a consent screen will show up (if your organization administrator didn't consent on behalf of all users). Users have to consent on the following:
- Access Azure Service Management As you. This is required as the app users Azure Service Management APIs to load all namespaces, topics, queues and other information like active message counts and dead letter queue counts.
- Have full access to Azure Service Bus service This is required to be able to perform service bus operation on behalf of logged in user like peeking a message off a queue or sending a message to a topic. (Please note that App access is limited to the access of the user despite what appears in the title.)
- View your basic profile. This is required to log in users and get access to basic information like user email.
- Maintain access to data you have give it access to. This is required to be able to use refresh tokens to avoid having to log in users every time they use the app.
The name of the logged-in user will appear in the application top bar. To log out; click on user name and click log out button from the popup menue.
The default method to authenticate to Service Bus entities is via user's Azure AD identity.
A basic read access over Service Bus namespaces is enough to populate all entities in left sidebar. In addition to that; the following permissions might be needed:
- To send messages via user identity; users need
Azure Service Bus Data Senderpermission. - To peek or receive messages via user identity; users need
Azure Service Bus Data Receiverpermission.
The following screenshot is showing the permissions applied on a Resource Group level:
On the left sidebar, a tree of all namespaces in which the logged-in user have access to will show up. Users can expand nodes of the tree, which will load selected entities i.e. topics, queues and subscriptions on demand. Multiple namespaces can be expanded at the same time:
Users can filter topic and queues by name to narrow down the tree to a subset or a specific entity.
In left sidebar you can see active and dead-lettered message counts for all entities in the format: [active], [dead-lettered].
Users can set selected entity by clicking a topic, queue or subscription on the left sidebar. Which will reflect on entity information window:
In the middle of the screen, the tab navigation is showing all the actions that can be performed on Service Bus messages: Browse, Send, Peek, Receive and Replay.
Browse messages enables users to browse all messages in queues and subscriptions without locking them (i.e. message retry count will not be increased upon reading messages). For more information check message-browsing.
Use the filtering functionality to filter rows of the grid via a particular criteria.
Browse messages grid by-default displays few of the most important columns. However, you can use the show/hide column features to control what should be displayed.
Use the ordering functionality to order by any column ascending or descending.
If you're dealing with a large number of messages you can use the limit dropdown to define an approximate number of messages to retrieve to save time and resources.
- Loading messages will
pauseif number of loaded messages equals or more than defined limit. - Loading messages will
resumeif number of loaded messages are less than limit.
In the paging section you can see exactly how many messages loaded in memory.
Click on any row on the grid to select the message and reveal its full details in the right sidebar.
Press ctrl and click a selected row to unselect.
