중요합니다
이 문서에서는 공유 액세스 서명을 사용하여 서비스에 연결하는 단계를 설명합니다. 이 인증 방법은 테스트와 평가에 편리하지만, Microsoft Entra ID나 관리 ID를 사용하여 서비스를 인증하는 것이 더 안전한 방식입니다. 자세한 내용은 IoT 솔루션을 위한 보안 모범 사례 > 클라우드 보안을 참조하세요.
Azure IoT 탐색기는 IoT Hub에 연결된 디바이스와 상호 작용하기 위한 그래픽 도구입니다. 이 문서에서는 도구를 사용하여 IoT 플러그 앤 플레이 디바이스를 테스트하는 데 중점을 둡니다. 로컬 컴퓨터에 도구를 설치한 후에는 이 도구를 사용하여 허브에 연결할 수 있습니다. 이 도구를 사용하여 디바이스가 보내는 원격 분석을 보고, 디바이스 속성을 사용하고, 명령을 호출할 수 있습니다.
이 문서에서는 다음 방법을 보여줍니다.
- Azure IoT 탐색기 도구를 설치하고 구성합니다.
- 도구를 사용하여 IoT 플러그 앤 플레이 디바이스와 상호 작용하고 테스트합니다.
도구 사용에 대한 자세한 내용은 GitHub 추가 정보를 참조하세요.
Azure IoT 탐색기 도구를 사용하려면 다음이 필요합니다.
- Azure IoT Hub - Azure CLI를 사용하여 IoT Hub 만들기와 같이 Azure 구독 에 IoT Hub를 추가하는 방법에는 여러 가지가 있습니다. Azure IoT 탐색기 도구를 실행하려면 IoT Hub 연결 문자열이 필요합니다. Azure 구독이 없는 경우, 시작하기 전에 무료 계정을 만드십시오.
- IoT Hub에 등록된 디바이스. IoT Explorer를 사용하여 IoT Hub에서 디바이스 등록을 만들고 관리할 수 있습니다.
Azure IoT 탐색기 설치
Azure IoT 탐색기 릴리스로 이동하여 최신 릴리스의 자산 목록을 확장하세요. 최신 버전의 애플리케이션을 다운로드하여 설치합니다. 설치 패키지는 플랫폼에서 애플리케이션을 시작하는 방법을 구성합니다. 예를 들어 Windows에서는 시작 메뉴에서 애플리케이션을 시작할 수 있습니다.
중요합니다
https://github.com/Azure/iot-plugandplay-models에 기반한 리포지토리에서 모델을 확인하려면 버전 0.13.x 이상으로 업데이트합니다.
Azure IoT 탐색기 사용
디바이스의 경우 사용자 고유의 디바이스를 연결하거나 샘플 시뮬레이션된 디바이스 중 하나를 사용할 수 있습니다.
허브에 연결
Azure IoT 탐색기를 처음 실행할 때 IoT Hub의 연결 문자열을 묻는 메시지가 표시됩니다. 연결 문자열을 추가한 후 연결을 선택합니다. 도구의 설정을 사용하여 연결 문자열을 업데이트하여 다른 IoT Hub로 전환할 수 있습니다.
IoT 플러그 앤 플레이 디바이스에 대한 모델 정의는 공용 리포지토리, 연결된 디바이스 또는 로컬 폴더에 저장됩니다. 기본적으로 이 도구는 퍼블릭 리포지토리 및 연결된 디바이스에서 모델 정의를 찾습니다. 원본을 추가 및 제거하거나 설정에서 원본의 우선 순위를 구성할 수 있습니다.
원본을 추가하려면 다음을 수행합니다.
- 홈/IoT 플러그 앤 플레이 설정으로 이동
- 리포지토리 또는 로컬 폴더에서 추가 를 선택하고 원본을 선택합니다.
원본을 제거하려면 다음을 수행합니다.
- 홈/IoT 플러그 앤 플레이 설정으로 이동
- 제거할 원본을 찾습니다.
- X를 선택하여 제거합니다.
원본 우선 순위를 변경합니다.
모델 정의 원본 중 하나를 목록의 다른 순위로 끌어서 놓을 수 있습니다.
디바이스 보기
도구가 IoT Hub에 연결되면 IoT Hub에 등록된 디바이스 ID를 나열하는 디바이스 목록 페이지가 표시됩니다. 목록에서 항목을 선택하여 자세한 정보를 볼 수 있습니다.
디바이스 목록 페이지에서 다음을 수행할 수 있습니다.
- 새로 만들기를 선택하여 허브에 새 디바이스를 등록합니다. 그런 다음 디바이스 ID를 입력합니다. 기본 설정을 사용하여 인증 키를 자동으로 생성하고 허브에 대한 연결을 사용하도록 설정합니다.
- 디바이스를 선택한 다음 삭제 를 선택하여 디바이스 ID를 삭제합니다. 이 작업을 완료하기 전에 디바이스 세부 정보를 검토하여 올바른 디바이스 ID를 삭제하고 있는지 확인합니다.
디바이스와 상호 작용
디바이스 목록 페이지에서 디바이스 ID 열의 값을 선택하여 등록된 디바이스의 세부 정보 페이지를 봅니다. 각 디바이스에는 디바이스와디지털 트윈의 두 섹션이 있습니다.
디바이스
이 섹션에는 디바이스 ID, 디바이스 쌍, 원격 분석, 직접 메서드, 클라우드-디바이스 메시지, 모듈 ID 탭이 포함되어 있습니다.
- 디바이스 ID 탭에서 디바이스 ID 정보를 보고 업데이트할 수 있습니다.
- 디바이스 쌍 탭에서 디바이스 쌍 정보에 액세스할 수 있습니다.
- 디바이스가 연결되어 있고 데이터를 적극적으로 전송하는 경우 원격 분석 탭에서 원격 분석을 볼 수 있습니다.
- 직접 메서드 탭에서 디바이스에서 직접 메서드를 호출할 수 있습니다.
- 클라우드-디바이스 메시지 탭에서 클라우드-디바이스 메시지를 보낼 수 있습니다.
- 모듈 트윈 정보에 액세스할 수 있습니다.
IoT 플러그 앤 플레이 구성 요소
디바이스가 모델 ID를 사용하여 허브에 연결된 경우 이 도구는 모델 ID를 볼 수 있는 IoT 플러그 앤 플레이 구성 요소 탭을 표시합니다.
구성된 원본 중 하나인 공용 리포지토리 또는 로컬 폴더에서 모델 ID 를 사용할 수 있는 경우 구성 요소 목록이 표시됩니다. 구성 요소를 선택하면 사용 가능한 속성, 명령 및 원격 분석이 표시됩니다.
구성 요소 페이지에서 읽기 전용 속성을 보고, 쓰기 가능한 속성을 업데이트하고, 명령을 호출하고, 이 구성 요소에서 생성된 원격 분석 메시지를 볼 수 있습니다.
속성
속성(읽기 전용) 탭의 인터페이스에 정의된 읽기 전용 속성을 볼 수 있습니다. 속성(쓰기 가능) 탭의 인터페이스에 정의된 쓰기 가능 속성을 업데이트할 수 있습니다 .
- 속성(쓰기 가능) 탭으로 이동합니다.
- 업데이트하려는 속성을 선택합니다.
- 속성의 새 값을 입력합니다.
- 디바이스로 보낼 페이로드를 미리 봅니다.
- 변경 내용을 제출합니다.
변경 내용을 제출한 후 동기화, 성공 또는 오류와 같은 업데이트 상태를 추적할 수 있습니다. 동기화가 완료되면 Reported Value 열에 속성의 새 값이 표시됩니다. 동기화가 완료되기 전에 다른 페이지로 이동하더라도, 도구는 업데이트가 완료되면 사용자에게 알림을 받게 합니다. 도구의 알림 센터를 사용하여 알림 기록을 볼 수도 있습니다.
명령어
디바이스에 명령을 보내려면 명령 탭으로 이동합니다.
- 명령 목록에서 트리거할 명령을 확장합니다.
- 명령에 필요한 값을 입력합니다.
- 디바이스로 보낼 페이로드를 미리 봅니다.
- 명령을 제출합니다.
테레메트리
선택한 인터페이스에 대한 원격 분석을 보려면 해당 원격 분석 탭으로 이동합니다. 시작을 선택하여 원격 분석 수신을 시작합니다.
알려진 문제
최신 버전의 도구에서 지원하는 IoT 기능 목록은 기능 목록을 참조하세요.