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.