Varför en egen Service Bus-utforskare?
Det finns inget bra alternativ för macOS, så jag ville ha något som fungerar bra. Azures webbaserade Service Bus Explorer i portalen är alldeles för seg och kräver många extra klick varje gång.
Service Bus Explorer
Service Bus Explorer visar köer, topics och prenumerationer i Azure Service Bus i ett träd, med antalet aktiva meddelanden och dead letters direkt på varje rad. Dead letters syns i varningsfärg, och en topic summerar sina prenumerationer. Flera namespaces sparas lokalt och grupperas, till exempel i Prod och Test. Man loggar in med en anslutningssträng eller med Entra ID via az login.
Det appen gör:
- en översikt per namespace, sorterad med flest dead letters först, och automatisk uppdatering
- konfigurationen för varje kö, topic och prenumeration, och prenumerationernas regler (SQL- och korrelationsfilter)
- bläddra i meddelanden och dead letters sida för sida, med sökning. Kroppen formateras som JSON eller XML, och alla egenskaper visas med sina typer
- skicka om eller ta bort valda dead letters, tömma en kö, skicka nya meddelanden och exportera till JSON
- extra försiktighet i produktion, och ett läge för bara läsning som stänger av allt som ändrar något

Att titta ändrar ingenting. Appen använder äkta peek, som läser meddelandena utan att låsa dem och utan att deras räknare för leveransförsök ökar. Det låter självklart, men det finns liknande verktyg som låser och släpper meddelandet för att visa det, och då räknas varje titt som ett försök.
Allt som ändrar något bekräftas. I ett namespace som är markerat som produktion får arbetsytan en röd ram, och man måste skriva in köns namn innan knappen går att trycka på. Att skicka om eller tömma många meddelanden går i bakgrunden, med förlopp och möjlighet att avbryta.

Programmet är byggt med Claude Code, i Rust med egui, för Windows och macOS, och ikonen är gjord med Codex. Nätverket körs på en egen tråd, aldrig i gränssnittet. Testerna går mot Microsofts Service Bus-emulator i Docker, och allt som tar bort eller skickar om provas bara där – aldrig mot ett riktigt namespace. Alla bilder i inlägget är tagna mot emulatorn.
Arbetet styrdes från en ärendebräda, som i mina andra projekt. Claude Code började med research på liknande program – Paolo Salvatoris Service Bus Explorer, portalens, och verktyg i .NET, Electron och Rust – och på vad användarna klagar på. Det mesta av det som står ovan kommer därifrån.
På vägen
Skicka om utan att förstöra. I förebildens ärendelista finns rapporter om meddelanden som ändrats när de skickats om: tappade fält, extra citattecken och nya radslut. Här behandlas kroppen som orörda bytes, och egenskaperna behåller sina typer. Bara det som Service Bus själv lagt till, och orsaken till att meddelandet blev ett dead letter, tas bort.
Bara det första dead lettern syntes. En prenumeration hade fem dead letters, men bara ett visades, och Load more var avstängd. Service Bus fyller inte alltid en sida, även när det finns fler meddelanden, och appen tolkade en halvfull sida som slutet. I en partitionerad topic kommer meddelandena dessutom inte i nummerordning, så nästa sida måste börja efter det sista meddelandet i svaret – inte efter det högsta numret.
Oläsliga tider. En tid som ett .NET-program lagt i ett meddelande visades som Described(… com.microsoft:datetime-offset …, Long(639281619336876125)) – antalet tick sedan år 1. Nu visas den som en tid, och detsamma gäller tidsspann och adresser.
Emulatorn räknar inte. Microsofts emulator svarar på nästan allt, men ger inga antal. För att trädets och översiktens siffror ändå skulle gå att granska fyller testerna i påhittade antal, och räkningen prövas mot ett svar i samma form som Azures.
En app från Finder hittar inte az. En app som startas från Finder eller Dock får inte terminalens sökväg, så inloggningen med Entra ID hittade inte Azure CLI. Appen letar nu själv på kända ställen.
Jämfört med portalen och Salvatoris program
Azure-portalens Service Bus Explorer finns alltid till hands men är seg, kräver många klick och visar som mest hundra meddelanden åt gången. Paolo Salvatoris Service Bus Explorer kan allt och är förebilden, men finns bara för Windows.
Det Service Bus Explorer ger mig:
- samma program på Windows och macOS
- antalen och dead letters direkt i trädet, utan extra klick
- peek som inte ändrar något
- extra försiktighet i produktion, och ett läge för bara läsning
Prova själv
Under Filer ligger IDEA.md: en fullständig beskrivning av programmet och allt jag lärt mig under bygget, skriven som en uppdragsbeskrivning. Ge den i sin helhet till Claude Code så har du underlaget för en egen Service Bus-utforskare – stacken, de beslut som visade sig avgörande, fallgroparna ovan som regler och en färdig prompt att utgå från.
