Monitorizar implementações do IoT Edge
Aplica-se a: 
IoT Edge 1.5 IoT Edge 1.4
Importante
IoT Edge 1.5 LTS e IoT Edge 1.4 LTS são versões suportadas. O IoT Edge 1.4 LTS termina a vida útil em 12 de novembro de 2024. Se tiver uma versão anterior, consulte Atualizar IoT Edge.
O Azure IoT Edge fornece relatórios que permitem monitorar informações em tempo real sobre os módulos implantados em seus dispositivos IoT Edge. O serviço Hub IoT recupera o status dos dispositivos e os disponibiliza para o operador. O monitoramento também é importante para implantações feitas em escala que incluem implantações automáticas e implantações em camadas.
Ambos os dispositivos e módulos têm dados semelhantes, como conectividade, portanto, os valores são obtidos de acordo com o ID do dispositivo ou o ID do módulo.
O serviço Hub IoT coleta dados relatados por gêmeos de dispositivo e módulo e fornece contagens dos vários estados que os dispositivos podem ter. O serviço Hub IoT organiza esses dados em quatro grupos de métricas:
| Tipo | Description |
|---|---|
| Visadas | Mostra os dispositivos IoT Edge que correspondem à condição de direcionamento de implantação. |
| Aplicado | Mostra os dispositivos IoT Edge de destino que não são direcionados por outra implantação de prioridade mais alta. |
| Relatando o sucesso | Mostra os dispositivos IoT Edge que relataram que os módulos foram implantados com êxito. |
| Relatar falha | Mostra os dispositivos IoT Edge que relataram que um ou mais módulos não foram implantados com êxito. Para investigar melhor o erro, conecte-se remotamente a esses dispositivos e visualize os arquivos de log. |
O serviço Hub IoT disponibiliza esses dados para você monitorar no portal do Azure e na CLI do Azure.
Monitorar uma implantação no portal do Azure
Para exibir os detalhes de uma implantação e monitorar os dispositivos que a executam, use as seguintes etapas:
Entre no portal do Azure e navegue até seu Hub IoT.
Selecione Configurações + Implantações no menu Gerenciamento de dispositivos.
Inspecione a lista de implantação. Para cada implantação, você pode exibir os seguintes detalhes:
Column Description ID O nome da implantação. Type O tipo de implantação, seja Implantação ou Implantação em camadas. Condição de Destino A tag usada para definir dispositivos de destino. Prioridade O número de prioridade atribuído à implantação. Métricas do sistema O número de gêmeos de dispositivo no Hub IoT que correspondem à condição de segmentação. Applied especifica o número de dispositivos que tiveram o conteúdo de implantação aplicado aos seus gêmeos de módulo no Hub IoT. Métricas do dispositivo O número de dispositivos IoT Edge relatando sucesso ou erros do tempo de execução do cliente IoT Edge. Métricas Personalizadas O número de dispositivos IoT Edge que relatam dados para quaisquer métricas que você definiu para a implantação. Criado O carimbo de data/hora de quando a implantação foi criada. Esse carimbo de data/hora é usado para quebrar laços quando duas implantações têm a mesma prioridade. Selecione a implantação que você deseja monitorar.
Na página Detalhes da Implantação, role para baixo até a seção inferior e selecione a guia Condição de Destino. Selecione Exibir para listar os dispositivos que correspondem à condição de destino. Você pode alterar a condição e também a prioridade. Selecione Salvar se tiver feito alterações.
Selecione a guia Métricas . Se você escolher uma métrica na lista suspensa Selecionar métrica , um botão Exibir será exibido para que você exiba os resultados. Você também pode selecionar Editar métricas para ajustar os critérios de quaisquer métricas personalizadas que você definiu. Selecione Salvar se tiver feito alterações.
Para fazer alterações em sua implantação, consulte Modificar uma implantação.
Monitorar uma implantação com a CLI do Azure
Use o comando az iot edge deployment show para exibir os detalhes de uma única implantação:
az iot edge deployment show --deployment-id [deployment id] --hub-name [hub name]
O comando deployment show usa os seguintes parâmetros:
- --deployment-id - O nome da implantação que existe no hub IoT. Parâmetro necessário.
- --hub-name - Nome do hub IoT no qual a implantação existe. O hub deve estar na assinatura atual. Mude para a subscrição pretendida com o comando
az account set -s [subscription name]
Inspecione a implantação na janela de comando. A propriedade metrics lista uma contagem para cada métrica avaliada por cada hub:
- targetedCount - Uma métrica do sistema que especifica o número de gêmeos de dispositivo no Hub IoT que correspondem à condição de segmentação.
- appliedCount - Uma métrica do sistema especifica o número de dispositivos que tiveram o conteúdo de implantação aplicado aos seus gêmeos de módulo no Hub IoT.
- reportedSuccessfulCount - Uma métrica de dispositivo que especifica o número de dispositivos IoT Edge na implantação relatando o sucesso do tempo de execução do cliente IoT Edge.
- reportedFailedCount - Uma métrica de dispositivo que especifica o número de dispositivos IoT Edge na implantação relatando falha do tempo de execução do cliente IoT Edge.
Você pode mostrar uma lista de IDs de dispositivo ou objetos para cada uma das métricas com o comando az iot edge deployment show-metric :
az iot edge deployment show-metric --deployment-id [deployment id] --metric-id [metric id] --hub-name [hub name]
O comando deployment show-metric usa os seguintes parâmetros:
- --deployment-id - O nome da implantação que existe no hub IoT.
- --metric-id - O nome da métrica para a qual você deseja ver a lista de IDs de dispositivo, por exemplo
reportedFailedCount. - --hub-name - Nome do hub IoT no qual a implantação existe. O hub deve estar na assinatura atual. Mude para a subscrição pretendida com o comando
az account set -s [subscription name].
Para fazer alterações em sua implantação, consulte Modificar uma implantação.
Próximos passos
Saiba como monitorar gêmeos de módulos, principalmente os módulos de tempo de execução do IoT Edge Agent e do IoT Edge Hub, quanto à conectividade e à integridade de suas implantações do IoT Edge.