Installing the Service Bus Explorer

To view actual BOD messages in a Bentley hosted environment, install the Service Bus Explorer. Service Bus Explorer is open source software.

Get the binaries at https://github.com/paolosalvatori/ServiceBusExplorer/releases/ or install using Chocolatey in an administrator command prompt

choco install -y servicebusexplorer

Viewing the queues

This is the Service Bus Explorer. Once connected to a service bus, the left-hand listing shows topics and subscriptions.

The number of messages waiting in the queue and the number of messages in the dead letter queue are shown next to the subscription name.

Click on a subscription and click on the Messages button to see the messages in the queue.

Click on a subscription and click on the Dead-letter button to see messages in the dead letter queue.

Connection string

If this is your first time connecting to a given environment, someone with Interop admin access to look up the service bus connection string for the tenant.

The admin should navigate to the Tenants listing, expand the details of the desired tenant, and near the bottom of the list of properties is the service bus connection string. Copy it.

The ServiceBusConnectionString value is required for Service Bus Explorer to connect. The ServiceBusConnectionString is a sensitive secret and should be treated with the same care as a password.

Connecting to the Service Bus

In the service bus explorer menu, select File | Connect.

In the resulting dialog, in the Service Bus Namespaces section, choose Enter connection string.

Enter the connection string into the large edit box on the right side of the dialog.

Click Save.

The connection is saved and is available in the menu File | Saved connections.

Launching explorer

Once the Connection String has been saved, select the desired Namespace from the Service Bus Namespaces dropdown.