Monitorar a conectividade do dispositivo usando a CLI do Azure

Use a extensão IoT da CLI do Azure para:

• Veja as mensagens que seus dispositivos estão enviando para o IoT Central.
• Observe as alterações no dispositivo gêmeo.
• Diagnosticar problemas em que as mensagens do dispositivo não chegam à nuvem.
• Diagnosticar problemas em que os dispositivos não respondem a alterações gêmeas.

Visite a referência de extensões de CLI do Azure para obter mais detalhes

Pré-requisitos

Uma conta corporativa ou de estudante no Azure, adicionada como um usuário em um aplicativo IoT Central.

Preparar o ambiente para a CLI do Azure

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar extensões com a CLI do Azure.

  • Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

Instalar a extensão do IoT Central

Para instalar, execute o comando a seguir na linha de comando:

az extension add --name azure-iot

Verifique a versão da extensão executando:

az --version

Você deve ver a extensão azure-iot é 0.14.1 ou superior. Se não estiver, execute:

az extension update --name azure-iot

Usar a extensão

As seções a seguir descrevem comandos e opções comuns que você pode usar ao executar o az iot central. Para exibir o conjunto completo de comandos e opções, passe --help para az iot central ou qualquer um dos subcomandos.

Entrar

Comece entrando na CLI do Azure:

az login

Obter a ID do Aplicativo do seu aplicativo IoT Central

No Gerenciamento > Aplicativos, copie a ID do Aplicativo. Você usa esse valor em etapas posteriores.

Monitorar mensagens

Monitore as mensagens que estão sendo enviadas para seu aplicativo IoT Central dos seus dispositivos. A saída inclui todos os cabeçalhos e anotações.

az iot central diagnostics monitor-events --app-id <app-id> --properties all

Exibir propriedades do dispositivo

Exibir as propriedades do dispositivo atual de leitura e leitura/gravação para um determinado dispositivo.

az iot central device twin show --app-id <app-id> --device-id <device-id>

Próximas etapas

Uma próxima etapa sugerida é aprender Solucionar problemas por que os dados de seus dispositivos não estão aparecendo no Azure IoT Central.