Explorar visualizações selecionadas no Azure IoT Edge

Aplica-se a:Marca de verificação do IoT Edge 1.6 IoT Edge 1.6

Importante

IoT Edge 1.6 LTS é a versão suportada. O suporte ao IoT Edge 1.5 LTS termina em 10 de novembro de 2026; IoT Edge 1.4 LTS atingiu o fim de vida útil em 12 de novembro de 2024. Se você estiver usando uma versão anterior, consulte Update IoT Edge.

Você pode explorar visualmente as métricas coletadas de dispositivos IoT Edge usando Azure Monitor pastas de trabalho. As pastas de trabalho de monitoramento selecionadas para dispositivos IoT Edge estão disponíveis como modelos públicos:

  • Para dispositivos conectados ao Hub IoT, na página Hub IoT no portal do Azure, acesse a página Workbooks na seção Monitoring.
  • Para dispositivos conectados ao IoT Central, na página IoT Central no portal do Azure, acesse a página Workbooks na seção Monitoring.

As pastas de trabalho coletadas usam métricas internas do runtime do IoT Edge. Você deve primeiro ingestar métricas no workspace do Log Analytics. Essas exibições não exigem instrumentação de métricas por meio dos módulos de carga de trabalho.

As pastas de trabalho podem ler dados herdados em InsightsMetrics, uma nova tabela personalizada (o padrão é IoTEdgeMetrics_CL) ou os dois históricos durante uma substituição. Para configuração do coletor, use Monitorar dispositivos do IoT Edge.

Acessar pastas de trabalho coletadas

Azure Monitor pastas de trabalho para IoT são modelos que você usa para visualizar as métricas do dispositivo. Você pode personalizá-los para ajustar sua solução.

Siga estas etapas para acessar as pastas de trabalho selecionadas:

  1. Entre no Azure portal e acesse seu aplicativo Hub IoT ou IoT Central.

  2. Selecione Pastas de Trabalho na seção Monitoramento do menu.

  3. Escolha uma pasta de trabalho para explorar na lista de modelos públicos:

    • Exibição da Frota: monitore sua frota de dispositivos em múltiplos hubs IoT ou aplicativos centrais, e analise em mais detalhes dispositivos específicos para obter um instantâneo de integridade.

    • Device Details: Visualize os detalhes do dispositivo relacionados a componentes de mensagens, módulos e componentes do host em um dispositivo IoT Edge.

    • Alertas: exibir alertas acionados para dispositivos em múltiplos recursos de IoT.

Para obter uma visualização dos dados e visualizações que cada pasta de trabalho oferece, consulte as seções a seguir.

Selecione a fonte das métricas

  1. Selecione seu espaço de trabalho Metrics Log Analytics.

  2. Selecione o aplicativo Hub IoT ou IoT Central que você deseja monitorar.

  3. Selecione um intervalo de tempo que inclua envios de métricas.

  4. Escolha a fonte das métricas:

    Seleção Dados
    Somente herdado InsightsMetrics apenas. As cópias salvas existentes mantêm a configuração salva.
    Somente Novo (padrão em modelos de galeria atualizados) Apenas a tabela personalizada selecionada. Não é necessário tempo de transição.
    Combine o histórico legado e o novo Dados legados antes da transição e novos dados na transição ou após ela.
  5. Defina MetricsTableName para o nome da sua tabela personalizada, ou mantenha o padrão IoTEdgeMetrics_CL.

    A tabela deve usar o esquema coletor. Um valor omitido ou limpo usa IoTEdgeMetrics_CL. Um nome inválido exibe um erro e também usa esse padrão até que você o corrija. Somente herdado sempre lê InsightsMetrics.

  6. Para Combinar histórico antigo e novo, insira Horário de transição (UTC) no formato YYYY-MM-DDTHH:mm:ssZ.

O controle de substituição aparece apenas no modo Combinar. Use o limite real de tempo de evento para seus dispositivos selecionados, não o tempo atual.

Os cadernos de exercícios consultam o espaço de trabalho selecionado e filtram os IDs dos recursos sem considerar o caso. Os usuários precisam de acesso por consulta para esse espaço de trabalho. Esses cadernos de exercícios usam o esquema pass-through e não dependem da associação de recursos por tempo de ingestão.

O modo Combine usa uma fronteira para a seleção. Para dispositivos com diferentes tempos de transição, use seleções separadas ou personalize as consultas. Para o procedimento completo, veja Preservar histórico em consultas personalizadas.

Pasta de trabalho Exibição da Frota

A animação a seguir foca na lista de dispositivos. Não exibe o espaço de trabalho nem os controles de fonte de métricas descritos em Selecionar a fonte de métricas.

Animação da seção de dispositivos do livro de exercícios de visualização da frota.

Esta visualização mostra a saúde dos dispositivos para os recursos de IoT selecionados. Selecione vários recursos para visualizar seus dispositivos juntos.

O estado de saúde depende da atualidade da métrica e dos valores limite configurados. Um dispositivo com amostras antigas pode ter status Desconhecido mesmo quando gráficos históricos contêm dados.

Use a aba Configurações para ajustar os limites e categorizar dispositivos como saudáveis ou não saudáveis.

Selecione o botão Detalhes para exibir a lista de dispositivos com um instantâneo de métricas primárias agregadas. Selecione o link na coluna Status para exibir tendências nas métricas de integridade de um dispositivo individual ou selecione o nome do dispositivo para exibir suas métricas detalhadas.

Pasta de trabalho de detalhes do dispositivo

A pasta de trabalho de detalhes do dispositivo tem três exibições que você pode usar:

  • A visualização de mensagens exibe as rotas de mensagens para o dispositivo e relata o estado geral do sistema de mensagens.
  • A exibição Módulos mostra como os módulos individuais em um dispositivo estão sendo executados.
  • A exibição Host mostra informações sobre o dispositivo host, incluindo informações de versão para componentes de host e uso de recursos.

Alterne entre exibições selecionando as guias na parte superior da pasta de trabalho.

A planilha de detalhes do dispositivo IoT também se integra à experiência de solução de problemas baseada em portal IoT Edge. Você pode extrair logs em tempo real do seu dispositivo usando esse recurso. Para acessar essa experiência, selecione o botão Solucionar problemas em <nome do dispositivo> ao vivo acima da pasta de trabalho.

A seção de mensagens da pasta de trabalho de detalhes do dispositivo.

A visualização de Mensagens inclui três subseções: detalhes de roteamento, um grafo de roteamento e a integridade das mensagens. Arraste qualquer gráfico de tempo e solte-o para ajustar o intervalo de tempo global ao intervalo selecionado.

A seção Roteamento mostra o fluxo de mensagens entre o envio de módulos e o recebimento de módulos. Ele apresenta informações como contagem de mensagens, taxa e número de clientes conectados. Selecione um remetente ou receptor para obter mais detalhes. Selecionar um remetente mostra o gráfico de tendências de latência experimentado pelo remetente e o número de mensagens enviadas. Selecionar um receptor mostra a tendência de comprimento da fila para o receptor e o número de mensagens recebidas.

A seção Graph mostra uma representação visual do fluxo de mensagens entre módulos. Arraste e aplique zoom para ajustar o grafo.

A seção Integridade mostra várias métricas relacionadas à integridade geral do subsistema de mensagens. Analise os detalhes se algum erro for observado.

Pasta de trabalho de alertas

Veja os alertas gerados por regras de alerta predefinidas na pasta de trabalho Alertas. Essa visualização permite que você veja alertas de múltiplos Hubs de IoT. Regras de alerta são recursos separados do Azure: atualizar um livro de exercícios não atualiza suas consultas, escopos, dimensões ou grupos de ações.

Captura de tela da seção de alertas na pasta de trabalho da visão de frota.

A visualização de Alertas lê registros de alertas, não linhas métricas. Seu espaço de trabalho, a origem das métricas e os controles MetricsTableName fornecem contexto para os links de Detalhes do dispositivo.

Selecione uma linha de severidade para exibir os detalhes do alerta. O link Regra de Alerta abre o contexto de alerta e o link Dispositivo abre a pasta de trabalho de métricas detalhadas. Quando aberta por meio dessa exibição, a pasta de trabalho de detalhes do dispositivo é ajustada automaticamente ao intervalo de tempo em relação ao acionamento do alerta.

Personalizar as pastas de trabalho

Você pode personalizar Azure Monitor pastas de trabalho. Os templates utilizam a Linguagem de Consulta Kusto para normalizar a fonte selecionada das métricas antes dos cálculos do gráfico.

Para personalizar uma pasta de trabalho, insira o modo de edição. Selecione o botão Editar na barra de menus da pasta de trabalho. As pastas de trabalho coletadas usam grupos de pastas de trabalho de maneira extensiva. Talvez seja necessário selecionar Editar em vários grupos aninhados para exibir uma consulta de visualização.

Salve suas alterações como uma nova pasta de trabalho. Você pode compartilhar a pasta de trabalho salva com sua equipe ou implantá-la programaticamente como parte das implantações de recursos da sua organização.

Importante

Atualizar um template público não atualiza os livros de exercícios que você salvou ou personalizou anteriormente. Faça o inventário dessas cópias e migre-as separadamente. Mantenha um backup inalterado até que a cópia migrada seja revisada e testada.

Para cópias já salvas, use Atualizar pastas de trabalho e alertas salvos. Só substituir o nome da tabela não é suficiente.

Preserve suas métricas personalizadas, dimensões, limites e lógica de contra-reset. Atualize todas as consultas de métrica, consultas de seleção de dispositivos, verificações de ausência de dados e links de detalhamento.

Verifique se a navegação preserva o espaço de trabalho, o recurso, o dispositivo, o intervalo de tempo, a origem das métricas, o nome da tabela e o horário de transição. Verifique os modos Legacy, New e Combine antes de substituir sua cópia salva.

Próximas etapas

Personalize sua solução de monitoramento com regras de alerta e métricas de módulos personalizados.