Servicebusexplorer

대시보드 탭

대시보드 탭에서는 모든 큐와 구독에 대한 메시지 수(활성, 데드레터, 예약, 총계)를 실시간으로 확인할 수 있으며, 자동 새로 고침과 색상으로 구분된 데드레터 경고 기능을 제공합니다.

TreeView 검색 및 필터링

TreeView에서는 큐, 토픽 및 구독에 대한 실시간 필터링이 가능하며, Ctrl+F를 눌러 검색창에 바로 집중할 수 있습니다.

메시지 본문 클립보드 복사

메시지 미리보기 창에서 한 번의 클릭으로 메시지 본문을 클립보드에 복사할 수 있습니다.

Microsoft Entra ID 로그인

대화형 브라우저 인증을 통해 Azure Service Bus 네임스페이스에 SAS 비밀을 로컬에 저장하지 않고도 안전하게 연결할 수 있습니다. 이 기능은 퍼블릭 Azure 클라우드에서만 지원되며, 주권 클라우드(Azure Government, Azure China 등)는 현재 지원되지 않습니다.

네임스페이스 구성 가져오기 및 내보내기

Service Bus 네임스페이스의 전체 구성을 가져오거나 내보낼 수 있어 환경 간 이동이나 백업이 용이합니다.

메시지 전송, 수신 및 피크

큐, 토픽 및 구독에 대해 메시지를 보내고, 받고, 피크(내용을 보지만 큐에서 제거하지 않음)할 수 있습니다.

데드레터 메시지 관리

데드레터 큐에 들어간 메시지를 확인하고, 필요에 따라 다시 처리하거나 삭제할 수 있습니다.

추가 지원 서비스

릴레이 서비스, 알림 허브 및 이벤트 허브도 탐색 및 관리가 가능합니다.

Chocolatey를 통한 설치

처음 설치하는 경우 다음 명령을 실행합니다:

choco install ServiceBusExplorer

업그레이드 시에는 다음 명령을 사용합니다:

choco upgrade ServiceBusExplorer

설치 후 실행 파일은 기본적으로 C:ProgramDatachocolateylibServiceBusExplorertoolsServiceBusExplorer.exe에 위치합니다.

Scoop을 통한 설치

Scoop 패키지는 공식적으로 유지되지 않으므로 사용 전 패키지와 해당 URL을 신중히 확인해야 합니다. 현재 패키지는 업그레이드 시 구성 파일 문제를 일으킬 수 있으므로 업그레이드에는 권장되지 않습니다.

설치 명령은 다음과 같습니다:

scoop install extras/servicebusexplorer

설치 후 실행 파일은 기본적으로 %USERPROFILE%scoopappsservicebusexplorercurrenttoolsServiceBusExplorer.exe에 위치합니다.

Winget을 통한 설치

다음 명령을 통해 Winget으로 설치할 수 있습니다:

winget install –id paolosalvatori.ServiceBusExplorer –source winget

GitHub 릴리스에서 직접 다운로드

최신 릴리스의 다운로드 URL을 얻으려면 다음 명령을 사용할 수 있습니다:

curl -s https://api.github.com/repos/paolosalvatori/ServiceBusExplorer/releases/latest | grep browser_download_url | cut -d ‘”‘ -f 4

Microsoft Entra ID를 통한 연결 방법

1. 정기적인 Service Bus 연결 dialog를 엽니다.
2. `Select a service bus namespace…`를 선택하여 수동 연결하거나, 기존 저장된 연결을 편집합니다.
3. 인증 방법을 `Azure Active Directory`로 변경합니다.
4. 네임스페이스 엔드포인트를 `sb://.servicebus.windows.net/` 또는 `.servicebus.windows.net` 형식으로 입력합니다.
5. 선택적으로 테넌트 ID와 엔티티 경로를 입력합니다. 테넌트 ID를 비워두면 조직 계정만 허용되는 엔드포인트가 사용됩니다.
6. 확인을 클릭하고 브라우저 로그인 흐름을 완료합니다.

연결이 성공하면 SAS 키를 로컬에 저장하지 않고도 네임스페이스를 탐색할 수 있습니다.

저장된 연결 문자열 형식

Entra ID 기반 연결은 다음 형식으로 저장됩니다:

Endpoint=sb://.servicebus.windows.net/;AuthMode=AAD;TenantId=;TransportType=Amqp;EntityPath=

최소한의 예시는 다음과 같습니다:

Endpoint=sb://.servicebus.windows.net/;AuthMode=AAD

지원 환경 및 시스템 요구사항

이 도구는 Windows 10 이상에서 실행되며, .NET Framework 4.6.2가 필요합니다. Visual Studio 2022 17.8.0 이상이 설치되어 있어야 소스 코드를 빌드할 수 있습니다.

제한 사항 및 확인 사항

Microsoft Entra ID 인증을 사용할 때는 다음 사항에 유의해야 합니다:

• 대화형 브라우저 로그인만 지원됩니다.
• Azure Active Directory 모드에서는 Service Bus 큐, 토픽 및 구독만 로드되며, 이벤트 허브, 알림 허브 및 릴레이는 로드되지 않습니다.
• 로컬 지속성은 메타데이터만 저장하며, 비밀번호나 SAS 키는 저장하지 않습니다.
• 관리 ID, Azure CLI 인증 및 서비스 주체 인증은 이 기능에 포함되지 않습니다.
• 개인용 Microsoft 계정은 해당 네임스페이스에 초대된 경우를 제외하고는 Service Bus 인증을 지원하지 않습니다.

최신 버전 및 업데이트

현재 버전은 6.2.0이며, 최신 업데이트 정보는 GitHub 저장소의 릴리스 페이지에서 확인할 수 있습니다.