IoT Hub용 디바이스 업데이트를 사용하여 디바이스에서 진단 로그 원격 수집

지원되는 브라우저:

• Microsoft Edge
• 구글 크롬

Azure CLI 환경:

• Bash 환경을 Azure Cloud Shell에서 사용합니다.

  

• 또는 CLI 참조 명령을 로컬로 실행하려는 경우 Azure CLI를 설치합니다.

  • az login 명령을 사용하여 Azure CLI에 로그인합니다.
  • az version을 실행하여 설치된 버전과 관련 종속 라이브러리를 확인합니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.
  • 메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 이 문서의 명령은 azure-iot 확장을 사용합니다. az extension update --name azure-iot를 실행하여 최신 버전의 확장을 사용하고 있는지 확인합니다.

1. Azure PortalIoT Hub용 디바이스 업데이트 계정으로 이동합니다.

2. 탐색 창의 인스턴스 관리 섹션에서 인스턴스 선택합니다.

3. 목록에서 디바이스 업데이트 인스턴스를 선택한 다음 진단 구성을설정합니다.

4. 고객 진단 탭을 선택한 다음, Azure Storage 계정을 선택합니다.

5. 목록에서 원하는 스토리지 계정을 선택하고 저장을 선택합니다.

6. 인스턴스 목록으로 돌아가면 인스턴스의 프로비저닝 상태가 "성공"으로 표시될 때까지 새로 고침 주기적으로 선택합니다. 이 프로세스는 일반적으로 2-3분 정도 걸립니다.

az iot du instance create 명령을 사용하여 디바이스 업데이트 인스턴스에 대한 진단을 구성합니다.

다음 자리 표시자를 사용자 고유의 정보로 바꿉니다.

• <account_name>: 디바이스 업데이트 계정의 이름입니다.
• <instance_name>: 디바이스 업데이트 인스턴스의 이름입니다.
• <storage_id>: 진단 로그가 저장될 스토리지 계정의 리소스 ID입니다. az storage show 명령을 사용하고 ID 값 az storage account show -n <storage_name> --query id쿼리하여 리소스 ID를 검색할 수 있습니다.

az iot du instance update --account <account_name> --instance <instance_name> --set enableDiagnostics=true diagnosticStorageProperties.resourceId=<storage_id>

1. IoT Hub로 이동하여 탐색 창의 디바이스 관리 섹션 아래에서 업데이트 탭을 선택합니다.

2. 사용자 인터페이스에서 진단 탭을 선택합니다. 진단 탭이 표시되지 않으면 최신 버전의 IoT Hub용 디바이스 업데이트 사용자 인터페이스를 사용하고 있는지 확인합니다. "이 디바이스 업데이트 인스턴스에 대해 진단을 사용하도록 설정해야 함"이 표시되는 경우 Azure Blob Storage 계정을 Device Update 인스턴스와 연결했는지 확인합니다.

3. 로그 업로드 작업 추가하여 로그 작업 만들기 페이지로 이동합니다.

4. 새 로그 작업에 대한 이름(ID) 및 설명을 입력한 다음, 디바이스 추가 선택하여 진단 로그를 수집할 IoT 디바이스를 선택합니다.

5. 추가를 선택합니다.

6. 진단 탭으로 돌아가면 작업 테이블에 로그 작업이 표시될 때까지 새로 고침을 반복해서 선택합니다.

7. 작업 상태가 성공 또는 실패하면, 작업 이름을 선택하여 세부 정보를 확인합니다. 모든 대상 디바이스가 로그 업로드를 성공적으로 완료한 경우에만 작업이 "성공"으로 표시됩니다. 일부 대상 디바이스가 성공하고 일부 디바이스가 실패한 경우 로그 작업은 "실패"로 표시됩니다. 로그 작업 세부 정보 페이지를 사용하여 성공한 디바이스와 실패한 디바이스를 확인할 수 있습니다.

8. 로그 작업 세부 정보에서 디바이스별 상태를 보고 로그 위치 경로를 볼 수 있습니다. 이 경로는 진단 로그가 업로드된 Azure Blob Storage 계정 내의 가상 디렉터리 경로에 해당합니다.

az iot du device log collect 명령을 사용하여 진단 로그 수집 작업을 구성합니다.

device log collect 명령은 다음과 같은 인수를 사용합니다.

• --account: 디바이스 업데이트 계정 이름입니다.
• --instance: 디바이스 업데이트 인스턴스 이름입니다.
• --log-collection-id: 로그 수집 작업의 이름입니다.
• --agent-id: 이 로그 수집 작업에 대한 대상 디바이스 업데이트 에이전트를 식별하는 키=값 쌍입니다. 에이전트에 디바이스 ID가 있는 경우 사용합니다 deviceId=<device name> . 에이전트에 모듈 ID가 있는 경우 사용합니다 deviceId=<device name> moduleId=<module name> . 매개 변수를 --agent-id 여러 번 사용하여 여러 디바이스를 대상으로 지정할 수 있습니다.

다음은 그 예입니다.

az iot du device log collect \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --log-collection-id <log collection name} \
    --agent-id deviceId=<device name> \
    --agent-id deviceId=<device name> moduleId=<module name>

az iot du device log show를 사용하여 특정 진단 로그 수집 작업의 세부 정보를 볼 수 있습니다.

az iot du device log show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --log-collection-id <log collection name>