Tutorial: Criar uma regra e configurar notificações no aplicativo Azure IoT Central

Neste tutorial, você aprenderá a usar a Azure IoT Central para monitorar remotamente os dispositivos conectados. As regras do Azure IoT Central permitem monitorar os dispositivos quase em tempo real e invocar ações automaticamente, como enviar um email. Este artigo explica como criar regras para monitorar a telemetria enviada pelos seus dispositivos.

Os dispositivos usam a telemetria para enviar dados numéricos do dispositivo. Uma regra é disparada quando a telemetria selecionada ultrapassa um limite especificado.

Neste tutorial, você aprenderá a:

• Crie uma regra que seja disparada quando a temperatura do dispositivo atingir 70° F.
• Adicione uma ação de email para que você seja notificado quando a regra for disparada.

Pré-requisitos

Para concluir as etapas deste tutorial, você precisará do seguinte:

• Uma assinatura ativa do Azure. Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

• Um aplicativo do IoT Central criado usando o modelo de Aplicativo personalizado. Para saber mais, confira Criar um aplicativo do IoT Central e Sobre o aplicativo.

Adicionar e personalizar um modelo de dispositivo

Adicionar um modelo de dispositivo do catálogo de dispositivos. Este tutorial usa o modelo de dispositivo Sensor de temperatura Onset Hobo MX-100:

1. Para adicionar um novo modelo de dispositivo, selecione + Novo na página Modelos de dispositivo.

2. Na página Selecionar tipo, role a página para baixo até encontrar o bloco do Sensor de temperatura Onset Hobo MX-100 na seção Modelos de dispositivo em destaque.

3. Escolha o bloco do Sensor de temperatura Onset Hobo MX-100 e selecione Avançar: Revisar.

4. Na página Examinar, selecione Criar.

O nome do modelo criado é Hobo MX-100. O modelo inclui componentes, como Hobo MX-100 e IotDevice. Os componentes definem as funcionalidades de um dispositivo ESP32. Os recursos podem incluir a telemetria, as propriedades e os comandos.

Adicionar um dispositivo simulado

Para testar a regra criada na próxima seção, adicione um dispositivo simulado ao seu aplicativo:

1. Selecione Dispositivos no painel de navegação esquerdo. Em seguida, selecione Hobo MX-100.

2. Selecione + Novo. No painel Criar um novo dispositivo, deixe os valores padrão de nome do dispositivo e ID do dispositivo. Alterne Simular este dispositivo? para Sim.

3. Selecione Criar.

Criar uma regra

Para criar uma regra de telemetria, o modelo do dispositivo deve incluir pelo menos um valor de telemetria. Este tutorial usa um dispositivo Hobo MX-100 simulado que envia a telemetria de temperatura. A regra monitora a temperatura relatada pelo dispositivo e envia um email quando ultrapassa os 70 graus.

Observação

Há um limite de 50 regras por aplicativo.

1. No painel esquerdo, selecione Regras.

2. Selecione + Novo para adicionar uma nova regra.

3. Insira o nome Monitor de temperatura para identificar a regra e pressione Enter.

4. Selecione o modelo de dispositivo Hobo MX-100. Por padrão, a regra aplica-se automaticamente a todos os dispositivos atribuídos ao modelo de dispositivo:

   

   Para filtrar um subconjunto dos dispositivos, selecione + Filtro e use as propriedades do dispositivo para identificar os dispositivos. Para desabilitar a regra, alterne o botão Habilitado/Desabilitado.

Configurar as condições de regra

As condições definem os critérios monitorados pela regra. Neste tutorial, você vai configurar a regra a ser disparada quando a temperatura exceder 70° F.

1. Selecione Temperatura no menu suspenso Telemetria.

2. Em seguida, escolha É maior que como o Operador e insira 70 como o Valor:

   

   Opcionalmente, você pode definir uma Agregação de tempo. Ao selecionar uma agregação de tempo, você deve selecionar também um tipo de agregação, como média ou soma do menu suspenso de agregação.

   • Sem agregação, a regra é disparada para cada ponto de dados de telemetria que atenda à condição. Por exemplo, se você configurar a regra para disparar quando temperatura estiver acima de 70, então ela será disparada quase instantaneamente quando a temperatura do dispositivo exceder esse valor.
   • Com a agregação, a regra será disparada se o valor de agregação dos pontos de dados de telemetria na janela de tempo atender à condição. Por exemplo, se você configurar a regra para disparar quando a temperatura estiver acima de 70 e com uma agregação de tempo média de 10 minutos, então a regra será disparada quando o dispositivo relatar uma temperatura média maior que 70, calculada durante um intervalo de 10 minutos.

Você pode adicionar várias condições a uma regra selecionando + Condição. Quando várias condições são adicionadas, você pode especificar se todas as condições precisam ser atendidas ou se uma das condições precisa ser atendida para que a regra seja disparada. Se você estiver usando a agregação de tempo com várias condições, todos os valores de telemetria deverão ser agregados.

Configurar ações

Após definir a condição, configure as ações a serem executadas quando a regra for acionada. As ações são invocadas quando todas as condições especificadas na regra são avaliadas como true.

1. Selecione + Email na seção Ações.

2. Insira Aviso de temperatura como o nome de exibição da ação, seu endereço de email no campo Para e Você deve verificar o dispositivo! como uma observação que deve aparecer no corpo do email.

   Observação

   Os emails serão enviados apenas aos usuários que foram adicionados ao aplicativo e fizeram logon pelo menos uma vez. Saiba mais sobre o gerenciamento de usuários no Azure IoT Central.

   

3. Para salvar a ação, escolha Concluído. Você pode adicionar várias ações a uma regra.

4. Para salvar a regra, escolha Salvar. A regra entra em ação em poucos minutos e começa a monitorar a telemetria enviada ao aplicativo. Quando a condição especificada na regra é atendida, a regra aciona a ação de e-mail configurada.

Após alguns instantes, você receberá uma mensagem de email quando a regra for acionada:

Excluir uma regra

Se você não precisar mais de uma regra, exclua-a, abrindo a regra e escolhendo Excluir.

Habilitar ou desabilitar uma regra

Escolha a regra que você deseja habilitar ou desabilitar. Alterne o botão Habilitado/Desabilitado na regra para habilitá-la ou desabilitá-la em todos os dispositivos no escopo.

Habilitar ou desabilitar uma regra para dispositivos específicos

Escolha a regra que você deseja personalizar. Use um ou mais filtros na seção Dispositivos de destino para restringir o escopo da regra aos dispositivos que você deseja monitorar.

Limpar os recursos

Se você não pretende concluir outros guias de início rápido nem tutoriais do IoT Central, pode excluir seu aplicativo do IoT Central:

1. No aplicativo IoT Central, navegue até Aplicativo > Gerenciamento.
2. Selecione Excluir e confirme a sua ação.

Próxima etapa

Agora que você definiu uma regra baseada em limite, a próxima etapa sugerida é aprender a:

Configurar regras