Tutorial: Receber mensagens de dispositivo através do Hub IoT do Azure

Artigo
11/16/2023

O serviço MedTech pode receber mensagens de dispositivos que você cria e gerencia por meio de um hub IoT no Hub IoT do Azure. Este tutorial usa um modelo do Azure Resource Manager (modelo ARM) e um botão Implantar no Azure para implantar um serviço MedTech. O modelo também implanta um hub IoT para criar e gerenciar dispositivos e encaminha mensagens de dispositivo para um hub de eventos para o serviço MedTech ler e processar. Após o processamento de dados do dispositivo, os recursos FHIR são mantidos no serviço FHIR®, que também está incluído no modelo.

Gorjeta

Para saber como o serviço MedTech transforma e persiste os dados do dispositivo no serviço FHIR como recursos FHIR, consulte Visão geral dos estágios de processamento de dados do dispositivo do serviço MedTech.

Neste tutorial, saiba como:

Abra um modelo ARM no portal do Azure.
Configure o modelo para sua implantação.
Crie um dispositivo.
Envie uma mensagem de teste.
Revise as métricas da mensagem de teste.

Gorjeta

Para saber mais sobre modelos ARM, consulte O que são modelos ARM?

Pré-requisitos

Para iniciar sua implantação e concluir o tutorial, você deve ter os seguintes pré-requisitos:

Uma conta de assinatura ativa do Azure. Se você não tiver uma assinatura do Azure, consulte o guia de decisão de assinatura.
Atribuições de função de Proprietário ou Colaborador e Administrador de Acesso de Usuário na assinatura do Azure. Para obter mais informações, consulte O que é o controle de acesso baseado em função do Azure (Azure RBAC)?
Provedores de recursos Microsoft.HealthcareApis, Microsoft.EventHub e Microsoft.Devices registrados com sua assinatura do Azure. Para saber mais, consulte Tipos e provedores de recursos do Azure.
Ter o Visual Studio Code instalado localmente.
Ferramentas IoT do Azure instaladas no Visual Studio Code. As Ferramentas IoT do Azure são uma coleção de extensões que facilitam a conexão com hubs IoT, a criação de dispositivos e o envio de mensagens. Neste tutorial, você usa a extensão do Hub IoT do Azure no Visual Studio Code para se conectar ao hub IoT implantado, criar um dispositivo e enviar uma mensagem de teste do dispositivo para o hub IoT.

Quando tiver esses pré-requisitos, você estará pronto para configurar o modelo ARM usando o botão Implantar no Azure .

Rever o modelo ARM

O modelo ARM usado para implantar os recursos neste tutorial está disponível em Modelos de Início Rápido do Azure usando o arquivo azuredeploy.json no GitHub.

Use o botão Implantar no Azure

Para iniciar a implantação no portal do Azure, selecione o botão Implantar no Azure :

Configurar a implementação

No portal do Azure, na guia Noções básicas do Modelo de Início Rápido do Azure, selecione ou insira as seguintes informações para sua implantação:
- Assinatura: a assinatura do Azure a ser usada para a implantação.
- Grupo de recursos: um grupo de recursos existente ou você pode criar um novo grupo de recursos.
- Região: a região do Azure do grupo de recursos usado para a implantação. A região é preenchida automaticamente usando a região do grupo de recursos.
- Basename: um valor anexado ao nome dos recursos e serviços do Azure que são implantados. Os exemplos neste tutorial usam o nome base azuredocsdemo. Você pode escolher seu próprio valor basename.
- Local: uma região do Azure com suporte para os Serviços de Dados de Saúde do Azure (o valor pode ser igual ou diferente da região em que seu grupo de recursos está). Para obter uma lista das regiões do Azure onde os Serviços de Dados de Integridade estão disponíveis, consulte Produtos disponíveis por regiões.
- Fhir Contributor Principal Id (opcional): Um ID de objeto de usuário do Microsoft Entra para fornecer permissões de leitura/gravação do serviço FHIR.
  
  Você pode usar essa conta para dar acesso ao serviço FHIR para exibir as Observações FHIR geradas neste tutorial. Recomendamos que você use sua própria ID de objeto de usuário do Microsoft Entra para que possa acessar as mensagens no serviço FHIR. Se você optar por não usar a opção ID Principal do Colaborador Fhir, desmarque a caixa de texto.
  
  Para saber como obter uma ID de objeto de usuário do Microsoft Entra, consulte Localizar a ID de objeto de usuário. O ID do objeto de usuário usado neste tutorial é apenas um exemplo. Se você usar essa opção, use seu próprio ID de objeto de usuário ou o ID de objeto de outra pessoa que você deseja poder acessar o serviço FHIR.
- Mapeamento de dispositivos: deixe os valores padrão para este tutorial.
- Mapeamento de destino: deixe os valores padrão para este tutorial.
Para validar sua configuração, selecione Revisar + criar.
Em Rever + criar, verifique o estado de validação do modelo. Se a validação for bem-sucedida, o modelo exibirá Validação aprovada. Se a validação falhar, corrija o problema indicado na mensagem de erro e selecione Revisar + criar novamente.
Após uma validação bem-sucedida, para iniciar a implantação, selecione Criar.
Em poucos minutos, o portal do Azure exibe a mensagem de que sua implantação foi concluída.
Importante

Se você vai permitir o acesso de vários serviços ao hub de eventos, é necessário que cada serviço tenha seu próprio grupo de consumidores do hub de eventos.

Os grupos de consumidores permitem que vários aplicativos consumidores tenham uma visão separada do fluxo de eventos e leiam o fluxo de forma independente, em seu próprio ritmo e com seus próprios deslocamentos. Para obter mais informações, consulte Grupos de consumidores.

Exemplos:
- Dois serviços MedTech acessando o mesmo hub de eventos.
- Um serviço MedTech e um aplicativo de gravador de armazenamento acessando o mesmo hub de eventos.

Revisar recursos implantados e permissões de acesso

Quando a implantação for concluída, os seguintes recursos e funções de acesso serão criados:

Espaço de nomes e hub de eventos dos Hubs de Eventos. Nesta implantação, o hub de eventos é chamado devicedata.
- Grupo de consumidores do hub de eventos. Nesta implantação, o grupo de consumidores é chamado $Default.
- Função de remetente de dados dos Hubs de Eventos do Azure. Nesta implantação, a função de remetente é denominada devicedatasender e pode ser usada para fornecer acesso ao hub de eventos usando uma assinatura de acesso compartilhado (SAS). Para saber mais sobre como autorizar o acesso usando uma SAS, consulte Autorizando acesso a recursos de Hubs de Eventos usando Assinaturas de Acesso Compartilhado. A função Remetente de Dados dos Hubs de Eventos do Azure não é usada neste tutorial.
Hub IoT com roteamento de mensagens configurado para rotear mensagens de dispositivo para o hub de eventos.
Identidade gerenciada atribuída pelo usuário, que fornece acesso de envio do hub IoT para o hub de eventos. A identidade gerenciada tem a função de Remetente de Dados dos Hubs de Eventos do Azure na seção Controle de acesso (IAM) do hub de eventos.
Espaço de trabalho Serviços de Dados de Integridade.
Serviço FHIR de Serviços de Dados de Saúde.
Serviço MedTech dos Serviços de Dados de Saúde com a identidade gerenciada atribuída pelo sistema habilitada e com as seguintes funções de acesso:
- Para o hub de eventos, a função de acesso do Recetor de Dados dos Hubs de Eventos do Azure é atribuída na seção Controle de acesso (IAM) do hub de eventos.
- Para o serviço FHIR, a função de acesso FHIR Data Writer é atribuída na seção Controle de acesso (IAM) do serviço FHIR.
Dispositivos de serviço MedTech conformes e válidos e mapeamentos de destino FHIR. O tipo de resolução está definido como Criar.

Importante

Neste tutorial, o modelo ARM configura o serviço MedTech para operar no modo Criar . Um recurso Paciente e um recurso Dispositivo são criados para cada dispositivo que envia dados para o serviço FHIR.

Para saber mais sobre os tipos de resolução de serviço MedTech Criar e Pesquisar, consulte Configurar a guia Destino.

Criar um dispositivo e enviar uma mensagem de teste

Com seus recursos implantados com sucesso, você se conecta ao hub IoT, cria um dispositivo e envia uma mensagem de teste para o hub IoT. Depois de concluir estes passos, o seu serviço MedTech pode:

Leia a mensagem de teste roteada pelo hub IoT do hub de eventos.
Transforme a mensagem de teste em cinco observações FHIR.
Persista as Observações FHIR no seu serviço FHIR.

Conclua as etapas usando o Visual Studio Code com a extensão do Hub IoT do Azure:

Abra o Visual Studio Code com as Ferramentas IoT do Azure instaladas.
No Explorer, em Hub IoT do Azure, selecione ... e escolha Selecionar Hub IoT.
Selecione a assinatura do Azure onde seu hub IoT foi provisionado.
Selecione seu hub IoT. O nome do seu hub IoT é o nome base que você forneceu quando provisionou os recursos prefixados com ih-. Um nome de hub de exemplo é ih-azuredocsdemo.
No Explorer, no Hub IoT do Azure, selecione ... e escolha Criar dispositivo. Um nome de dispositivo de exemplo é iot-001.
Para enviar uma mensagem de teste do dispositivo para o hub IoT, clique com o botão direito do mouse no dispositivo e selecione Enviar mensagem D2C para o hub IoT.

Nota

Neste exemplo de dispositivo para nuvem (D2C), nuvem é o hub IoT no Hub IoT do Azure que recebe a mensagem do dispositivo. O Hub IoT do Azure dá suporte a comunicações bidirecionais. Para configurar um cenário de nuvem para dispositivo (C2D), selecione Enviar mensagem C2D para a nuvem do dispositivo.
Em Enviar mensagens D2C, selecione ou insira os seguintes valores:
- Dispositivo(s) a partir do(s) qual(is) enviar mensagens: O nome do dispositivo que criou.
- Mensagem(ões) por dispositivo: 1.
- Intervalo entre duas mensagens: 1 segundo(s).
- Mensagem: Texto simples.
- Editar: limpe qualquer texto existente e, em seguida, copie/cole a seguinte mensagem de teste JSON.
  
  Gorjeta
  
  Você pode usar a opção Copiar no canto direito da mensagem de teste abaixo e, em seguida, colá-la na janela Editar.
```
{
    "PatientId": "patient1",
    "HeartRate": 78,
    "RespiratoryRate": 12,
    "HeartRateVariability": 30,
    "BodyTemperature": 98.6,
    "BloodPressure": {
       "Systolic": 120,
       "Diastolic": 80
    }
}  
```
Para iniciar o processo de envio de uma mensagem de teste para seu hub IoT, selecione Enviar.

Depois de selecionar Enviar, pode levar até cinco minutos para que os recursos FHIR estejam disponíveis no serviço FHIR.

Importante

Para evitar falsificação de dispositivo em mensagens de dispositivo para nuvem (D2C), o Hub IoT do Azure enriquece todas as mensagens do dispositivo com propriedades adicionais antes de roteá-las para o hub de eventos. Por exemplo: SystemProperties: e Properties: iothub-creation-time-utciothub-connection-device-id . Para obter mais informações, consulte Propriedades antifalsificação e Como usar modelos IotJsonPathContent com o mapeamento de dispositivo de serviço MedTech.

Você não deseja enviar esta mensagem de dispositivo de exemplo para seu hub IoT, pois os enriquecimentos serão duplicados pelo hub IoT e causarão um erro com seu serviço MedTech. Este é apenas um exemplo de como as mensagens do seu dispositivo são enriquecidas pelo hub IoT.

Exemplo:

patientIdExpressionsó é necessário para serviços MedTech no modo Criar, no entanto, se a Pesquisa estiver a ser utilizada, deve existir um recurso de Dispositivo com um Identificador de Dispositivo correspondente no serviço FHIR. Este exemplo pressupõe que seu serviço MedTech esteja em um modo Criar . O tipo de resolução para este tutorial definido como Criar. Para obter mais informações sobre as propriedades de destino: criar e pesquisar, consulte Configurar a guia Destino.

Revisar métricas da mensagem de teste

Depois de enviar com sucesso uma mensagem de teste para seu hub IoT, agora você pode revisar suas métricas de serviço MedTech. Revise as métricas para verificar se seu serviço MedTech recebeu, agrupou, transformou e persistiu a mensagem de teste em seu serviço FHIR. Para saber mais, consulte Como usar as guias de monitoramento e verificações de integridade do serviço MedTech.

Para suas métricas de serviço MedTech, você pode ver que seu serviço MedTech concluiu as seguintes etapas para a mensagem de teste:

Número de mensagens recebidas: recebeu a mensagem de teste de entrada do hub de eventos.
Número de mensagens normalizadas: Criou cinco mensagens normalizadas.
Número de medições: Criou cinco medições.
Número de recursos FHIR: Criados cinco recursos FHIR que são persistentes em seu serviço FHIR.

Exibir dados de teste no serviço FHIR

Se você forneceu sua própria ID de objeto de usuário do Microsoft Entra como o valor opcional para a opção ID Principal do Colaborador Fhir no modelo de implantação, poderá consultar recursos FHIR em seu serviço FHIR. Você pode esperar ver os seguintes recursos de observação FHIR no serviço FHIR com base na mensagem de teste que foi enviada para o hub IoT e processada pelo serviço MedTech:

Frequência cardíaca
Frequência Respiratória
Frequência CardíacaVariabilidade
Temperatura Corporal
Pressão Arterial

Para saber como obter um token de acesso do Microsoft Entra e exibir recursos FHIR em seu serviço FHIR, consulte Access usando o Postman. Você precisa usar os seguintes valores em sua solicitação do Postman GET para exibir os recursos de observação FHIR criados pela mensagem de teste: {{fhirurl}}/Observation