22
33A command-line tool for managing Azure Service Bus.
44
5- ## Prerequisites
5+ ## Installation
66
7- - .NET 10 SDK or later
8- - Azure CLI logged in (` az login ` )
7+ ### Global Tool (Recommended)
98
10- ## Installation
9+ ``` bash
10+ # Install from NuGet
11+ dotnet tool install -g ServiceBusToolset
12+
13+ # Update to latest version
14+ dotnet tool update -g ServiceBusToolset
15+
16+ # Install preview/alpha version
17+ dotnet tool install -g ServiceBusToolset --prerelease
18+ ```
19+
20+ ### Build from Source
1121
1222``` bash
23+ git clone https://github.com/kyurkchyan/ServiceBusToolset.git
24+ cd ServiceBusToolset
1325dotnet build
1426```
1527
28+ ## Prerequisites
29+
30+ - .NET 10 SDK or later
31+ - Azure CLI logged in (` az login ` )
32+
1633## Commands
1734
1835| Command | Description |
@@ -27,34 +44,36 @@ dotnet build
2744
2845``` bash
2946# Purge all DLQ messages from a queue
30- dotnet run -- purge-dlq -n mynamespace.servicebus.windows.net -q myqueue
47+ sbtools purge-dlq -n mynamespace.servicebus.windows.net -q myqueue
3148
3249# Interactive mode - select which message categories to purge
33- dotnet run -- purge-dlq -n mynamespace.servicebus.windows.net -q myqueue -i
50+ sbtools purge-dlq -n mynamespace.servicebus.windows.net -q myqueue -i
3451
3552# Resubmit DLQ messages back to the main queue
36- dotnet run -- resubmit-dlq -n mynamespace.servicebus.windows.net -q myqueue
53+ sbtools resubmit-dlq -n mynamespace.servicebus.windows.net -q myqueue
3754
3855# Interactive mode - select which message categories to resubmit
39- dotnet run -- resubmit-dlq -n mynamespace.servicebus.windows.net -q myqueue -i
56+ sbtools resubmit-dlq -n mynamespace.servicebus.windows.net -q myqueue -i
4057
4158# Dump DLQ messages to a JSON file
42- dotnet run -- dump-dlq -n mynamespace.servicebus.windows.net -q myqueue -o dlq-messages.json
59+ sbtools dump-dlq -n mynamespace.servicebus.windows.net -q myqueue -o dlq-messages.json
4360
4461# Interactive mode - select which message categories to dump
45- dotnet run -- dump-dlq -n mynamespace.servicebus.windows.net -q myqueue -o dlq-messages.json -i
62+ sbtools dump-dlq -n mynamespace.servicebus.windows.net -q myqueue -o dlq-messages.json -i
4663
4764# Diagnose DLQ messages using Application Insights
48- dotnet run -- diagnose-dlq -n mynamespace.servicebus.windows.net -q myqueue \
65+ sbtools diagnose-dlq -n mynamespace.servicebus.windows.net -q myqueue \
4966 -a " /subscriptions/.../resourceGroups/.../providers/microsoft.insights/components/my-app-insights"
5067
5168# Monitor all queues with live-updating table
52- dotnet run -- monitor-queues -n mynamespace.servicebus.windows.net
69+ sbtools monitor-queues -n mynamespace.servicebus.windows.net
5370
5471# Monitor queues matching a pattern with 10-second refresh
55- dotnet run -- monitor-queues -n mynamespace.servicebus.windows.net -f " order-*" -r 10
72+ sbtools monitor-queues -n mynamespace.servicebus.windows.net -f " order-*" -r 10
5673```
5774
75+ > ** Note:** If running from source instead of the global tool, replace ` sbtools ` with ` dotnet run -- ` in the commands above.
76+
5877## Authentication
5978
6079Uses [ DefaultAzureCredential] ( https://learn.microsoft.com/en-us/dotnet/api/azure.identity.defaultazurecredential ) . For
0 commit comments