Monitorizar implementações do IoT Edge

Aplica-se a: IoT Edge 1.5

O Azure IoT Edge fornece informações em tempo real sobre os módulos implantados em seus dispositivos IoT Edge. O serviço Hub IoT obtém o status dos dispositivos e o mostra para você. O monitoramento também é importante para implantações feitas em escala que incluem implantações automáticas e implantações em camadas.

Os dispositivos e módulos têm dados semelhantes, como conectividade, para que você obtenha valores com base no ID do dispositivo ou no ID do módulo.

O serviço Hub IoT coleta dados relatados por gêmeos de dispositivo e módulo e fornece contagens dos diferentes estados que os dispositivos podem ter. O serviço Hub IoT organiza esses dados em quatro grupos de métricas:

Você pode monitorar esses dados no portal do Azure ou usar a CLI do Azure.

Monitorar uma implantação no portal do Azure

Para exibir os detalhes da implantação e monitorar os dispositivos que a executam, siga estas etapas:

1. Inicie sessão no portal do Azure e, em seguida, aceda ao seu Hub IoT.

2. Selecione Configurações + Implantações em Gerenciamento de dispositivos.

3. Analise a lista de implantação. Para cada implantação, você verá os seguintes detalhes:

   Coluna	Descrição
   Nº de Identificação	O nome da implantação.
   Tipo	O tipo de implantação, seja Implantação ou Implantação em camadas.
   Condição de Destino	A tag que define os 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. Aplicado mostra o número de dispositivos que têm 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 reportam dados para quaisquer métricas que definir para a implantação.
   Criado	A marca temporal da criação da implementação. Esse carimbo de data/hora é usado para quebrar laços quando duas implantações têm a mesma prioridade.

4. Selecione a implantação que você deseja monitorar.

5. Na página Detalhes da Implantação , vá para a guia Condição de Destino . Selecione Exibir para listar os dispositivos que correspondem à condição de destino. Altere a condição ou Prioridade conforme necessário e selecione Salvar.

   

6. Selecione a guia Métricas . Quando você escolhe uma métrica na lista suspensa Selecionar métrica , o botão Exibir é exibido para que você possa exibir os resultados. Selecione Editar métricas para ajustar os critérios de qualquer métrica personalizada que você definir. Selecione Salvar se fizer alterações.

   

Para alterar 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 mostrar os detalhes de uma única implantação:

az iot edge deployment show --deployment-id [deployment id] --hub-name [hub name]

O deployment show comando usa estes parâmetros:

• --deployment-id - O nome da implantação no hub IoT. Parâmetro necessário.
• --hub-name - O nome do hub IoT onde a implantação existe. O hub deve estar na assinatura atual. Mude para a subscrição com az account set -s [subscription name]

Verifique a implantação na janela de comando. A metrics propriedade lista uma contagem para cada métrica avaliada por cada hub:

• targetedCount - O número de gêmeos de dispositivo no Hub IoT que correspondem à condição de segmentação.
• appliedCount - O número de dispositivos que têm o conteúdo de implantação aplicado aos seus gêmeos de módulo no Hub IoT.
• reportedSuccessfulCount - O número de dispositivos IoT Edge na implantação que relatam sucesso a partir do tempo de execução do cliente IoT Edge.
• reportedFailedCount - O número de dispositivos IoT Edge na implementação que relatam falhas provenientes do tempo de execução do cliente IoT Edge.

Mostrar uma lista de IDs de dispositivos ou objetos relacionados a cada métrica utilizando 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 deployment show-metric comando usa estes parâmetros:

• --deployment-id - O nome da implantação no hub IoT.
• --metric-id - O nome da métrica para mostrar a lista de IDs de dispositivo, por exemplo reportedFailedCount.
• --hub-name - O nome do hub IoT onde a implantação existe. O hub deve estar na assinatura atual. Mude para a subscrição com az account set -s [subscription name]. Para fazer alterações em sua implantação, consulte Modificar uma implantação.

Próximos passos

Saiba como monitorizar gémeos de módulos, principalmente os módulos em execução do IoT Edge Agent e do IoT Edge Hub, para verificar a conectividade e a integridade das suas implementações do IoT Edge.