ServiceBusAdmin 1.0.3

Goal

Manage messages in your Azure Service Bus namespace with handy CLI. Send, peek and receive messages from your Service Bus entities.

Output format of ServiceBusAdmin is JSON so peeked messages can be easily filtered and transformed with tools like jq. Once you find messages that you were looking for, you can resend them to given Service Bus entity by either using their unique sequence numbers or by exporting them to a file and sending in batch mode.

Quick start

1. Install ServiceBusAdmin .NET tool from nuget

   dotnet tool install --global ServiceBusAdmin
   

2. Configure connection string to your Service Bus Namespace with environment variable

   export SEBA_CONNECTION_STRING="<service_bus_connection_string>"
   

3. Verify your connection string

   seba props
   

   If connection string you configured is valid then you should see output similar to

   {"NamespaceName":"ssz-playground","CreatedTime":"2021-11-08T09:24:12.41+00:00","ModifiedTime":"2021-11-09T09:23:31.117+00:00"}
   

4. Check status of entities in your Service Bus Namespace

   seba status
   

5. Peek messages from a subscription's dead letter queue

   seba subscription peek <topic_name>/<subscription_name> -dlq --max 20
   

   This will return only messages' metadata. If you need their body as well, then use additional option --output-content all
6. Every command has --help option. Use it to find out more about supported options, arguments and sub-commands.

   seba --help
   

7. Common usage scenarios can be found on this documentation page.