Mapear telemetria na entrada para o IoT Central

O mapeamento de dados permite-lhe transformar a telemetria complexa do dispositivo em dados estruturados no IoT Central. Para cada um dos seus dispositivos, pode mapear um caminho JSON específico na mensagem de telemetria do dispositivo para um alias. Um alias é um nome amigável para o destino para o qual está a mapear. O IoT Central utiliza os mapeamentos para transformar a telemetria no caminho para o IoT Central. Pode utilizar a telemetria mapeada para:

• Crie modelos de dispositivos e experiências de gestão de dispositivos no IoT Central.
• Normalize a telemetria de diferentes dispositivos ao mapear caminhos JSON em vários dispositivos para um alias comum.
• Exportar para destinos fora do IoT Central.

O vídeo seguinte explica-lhe o processo de mapeamento de dados:

Mapear telemetria para o seu dispositivo

Um mapeamento utiliza uma expressão JSONPath para identificar o valor numa mensagem de telemetria recebida para mapear para um alias.

Uma expressão JSONPath começa com o $ caráter, que se refere ao elemento raiz da mensagem. Segue-se $ uma sequência de elementos subordinados separados por parênteses retos. Por exemplo:

$["messages"]["tmp"]

$["opcua"]["payload"][0]["value"]

$["Messages"]["Payload"]["nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt1"]["Value"]

O IoT Central utiliza um subconjunto da sintaxe da expressão JSONPath:

• Cada segmento só pode ser um número não negativo ou uma cadeia entre aspas duplas.
• Um segmento não pode conter barra invertida, parêntese reto ou aspas duplas.
• Um caminho JSON não pode exceder 1000 carateres.

Para criar um mapeamento na sua aplicação do IoT Central, escolha uma das seguintes opções para navegar para o painel Mapear dados :

• Em qualquer página do dispositivo, selecione Gerir dados de mapa do dispositivo>:

  

• Na vista Dados não processados do seu dispositivo, expanda qualquer mensagem de telemetria, paire o cursor do rato sobre um caminho e selecione Adicionar alias. O painel Mapear dados é aberto com a expressão JSONPath copiada para o campo de caminho JSON :

  

O lado esquerdo do painel de dados Mapa mostra a mensagem mais recente do seu dispositivo. Paire o cursor sobre qualquer parte dos dados e selecione Adicionar Alias. A expressão JSONPath é copiada para o caminho JSON. Adicione um nome de Alias sem mais de 64 carateres. Não pode utilizar o alias para fazer referência a um campo num objeto complexo definido no modelo de dispositivo.

Adicione o número de mapeamentos necessários e, em seguida, selecione Guardar:

Para um determinado dispositivo:

• Nenhum dos dois mapeamentos pode ter o mesmo caminho JSON.
• Não é possível ter dois mapeamentos com o mesmo alias.

Dica

Poderá ter de aguardar vários minutos para que o seu dispositivo envie uma mensagem de telemetria para ser apresentada no painel esquerdo. Se ainda não existirem dados no painel esquerdo, pode introduzir manualmente uma expressão JSONPath no campo de caminho JSON .

Para verificar se o IoT Central está a mapear a telemetria, navegue para a vista dados não processados do seu dispositivo e verifique a _mappeddata secção:

Se não vir os seus dados mapeados depois de atualizar os dados não processados várias vezes, verifique se a expressão JSONPath que está a utilizar corresponde à estrutura da mensagem de telemetria.

Para IoT Edge dispositivos, o mapeamento de dados aplica-se à telemetria de todos os módulos e hubs IoT Edge. Não pode aplicar mapeamentos a um módulo específico do Azure IoT Edge.

Para dispositivos atribuídos a um modelo de dispositivo, não pode mapear dados para componentes ou interfaces herdadas. No entanto, pode mapear quaisquer dados do seu dispositivo antes de os atribuir a um modelo de dispositivo.

Gerir mapeamentos

Para ver, editar ou eliminar mapeamentos, navegue para a página Aliases mapeados . Selecione um mapeamento para editá-lo ou eliminá-lo. Pode selecionar vários mapeamentos e eliminá-los ao mesmo tempo:

Por predefinição, as exportações de dados do IoT Central incluem dados mapeados. Para excluir dados mapeados, utilize uma transformação de dados na exportação de dados.

Mapear telemetria não moderna

Pode mapear telemetria não moderna, incluindo telemetria de componentes não modernos. Por exemplo, dada a workingSet telemetria definida no componente raiz e a temperature telemetria definida num componente termóstato apresentado no exemplo seguinte:

{
  "_unmodeleddata": {
    "workingSet": 74
  },
  "_eventtype": "Telemetry",
  "_timestamp": "2022-07-18T09:22:40.257Z"
}

{
  "_unmodeleddata": {
    "thermostat2": {
      "__t": "c",
      "temperature": 44
    }
  },
  "_eventtype": "Telemetry",
  "_timestamp": "2022-07-18T09:21:48.69Z"
}

Pode mapear esta telemetria com as seguintes definições de mapeamento:

• $["workingSet"] ws
• $["temperature"] temp

Nota

Não inclua o nome do componente na definição de mapeamento.

Os resultados destas regras de mapeamento são semelhantes aos seguintes exemplos:

{
  "telemetries": {
    "workingSet": 84,
    "_mappeddata": {
      "ws": 84
    }
  }
}

{
  "_unmodeleddata": {
    "thermostat2": {
      "__t": "c",
      "temperature": 12
    },
    "_mappeddata": {
      "thermostat2": {
        "__t": "c",
        "temp": 12
      }
    }
  },
  "_eventtype": "Telemetry",
  "_timestamp": "2022-07-18T09:31:21.088Z"
}

Agora, pode utilizar os aliases mapeados para apresentar telemetria num gráfico ou dashboard. Também pode utilizar os aliases mapeados quando exporta telemetria.

Passos seguintes

Agora que aprendeu a mapear dados para o seu dispositivo, um passo seguinte sugerido é saber como utilizar o explorador de dados para analisar dados do dispositivo.