Monitorizar a conectividade do dispositivo com a CLI do Azure

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

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

Visite a referência de extensões da 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 do IoT Central.

Prepare o seu ambiente para o CLI do Azure

  • Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no Azure Cloud Shell.

  • Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.

    • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.

    • Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.

    • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

Instalar a extensão IoT Central

Execute o seguinte comando a partir da sua linha de comando para instalar:

az extension add --name azure-iot

Verifique a versão da extensão executando:

az --version

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

az extension update --name azure-iot

Usando a extensão

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

Iniciar sessão

Comece por iniciar sessão na CLI do Azure:

az login

Obter a ID do aplicativo do seu aplicativo IoT Central

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

Monitorar mensagens

Monitorize as mensagens que estão a ser enviadas para a sua aplicação IoT Central a partir 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

Ver propriedades do dispositivo

Exiba as propriedades atuais do dispositivo de leitura e leitura/gravação de um determinado dispositivo.

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

Próximos passos

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