Introdução a soluções pré-configuradas

As soluções pré-configuradas do Azure IoT Suite combinam vários serviços de IoT do Azure para fornecer soluções de ponta a ponta que implementam cenários comuns de negócios de IoT. A solução pré-configurada de monitoramento remoto conecta-se seus dispositivos e os monitora. Você pode usar a solução para analisar o fluxo de dados de dispositivos e melhorar os resultados de negócios fazendo com que os processos respondam automaticamente a esse fluxo de dados.

Este tutorial mostra como provisionar a solução pré-configurada de monitoramento remoto. Ele também explica os recursos básicos da solução pré-configurada. Você pode acessar muitos desses recursos no painel de solução que é implantado como parte da solução pré-configurada:

Para concluir este tutorial, você precisa de uma assinatura ativa do Azure.

Observação

Se você não tiver uma conta, poderá criar uma conta de avaliação gratuita em apenas alguns minutos. Para obter detalhes, consulte Avaliação gratuita do Azure.

Provisionar a solução

Se você já não tiver provisionado a solução pré-configurada de monitoramento remoto em sua conta:

1. Entre em azureiotsuite.com usando suas credenciais de conta do Azure e clique + para criar uma solução.
2. Clique em Selecionar no bloco Monitoramento remoto.
3. Digite um Nome de solução para a solução pré-configurada de monitoramento remoto.
4. Selecione a Região e a Assinatura que você deseja usar para provisionar a solução.
5. Clique em Criar Solução para iniciar o processo de provisionamento. Este processo normalmente leva vários minutos para ser executado.

Aguarde o processo de provisionamento ser concluído

1. Clique no bloco da sua solução com o status Provisionamento .
2. Observe os estados de Provisionamento à medida que os serviços do Azure são implantados em sua assinatura do Azure.
3. Após o provisionamento ser concluído, o status será alterado para Pronto.
4. Clique no bloco para ver os detalhes da solução no painel à direita.

Observação

Se estiver tendo problemas para implantar a solução pré-configurada, dê uma olhada em Permissões no site azureiotsuite.com e nas Perguntas frequentes. Se os problemas persistirem, crie um tíquete de serviço no portal.

Há detalhes que você esperaria ver e que não estão listados para sua solução? Envie sugestões de recursos no User Voice.

Visão geral do cenário

Quando você implanta a solução pré-configurada de monitoramento remoto, ela é preenchida com recursos que permitem que você percorra um cenário comum de monitoramento remoto. Nesse cenário, vários dispositivos conectados à solução estão relatando os valores de temperatura inesperados. As seções a seguir mostram como:

• Identificar os dispositivos enviando valores de temperatura inesperados.
• Configurar esses dispositivos para enviar telemetria mais detalhada.
• Corrigir o problema atualizando o firmware nesses dispositivos.
• Verificar se o problema foi resolvido por sua ação.

Um recurso-chave desse cenário é que você pode executar todas essas ações remotamente no painel da solução. Não é necessário acesso físico aos dispositivos.

Exibir o painel de solução

O painel de solução permite que você gerencie a solução implantada. Por exemplo, você pode exibir telemetria, adicionar dispositivos e configurar regras.

1. Quando o provisionamento for concluído e o bloco da solução pré-configurada indicar Pronto, escolha Iniciar para abrir o portal de solução de monitoramento remoto em uma nova guia.

   

2. Por padrão, o portal de solução mostra o painel. Você pode navegar para outras áreas do portal de solução usando o menu ao lado esquerdo da página.

   

O painel exibe as seguintes informações:

• Um mapa que exibe o local de cada dispositivo conectado à solução. Quando você executa a solução, há 25 dispositivos simulados. Os dispositivos simulados são implementados como Azure WebJobs e a solução usa a API do Bing Mapas para criar gráficos de informações no mapa. Confira as Perguntas frequentes para aprender a fazer o mapa dinâmico.
• Um painel Histórico de Telemetria que cria gráficos de telemetria de umidade e temperatura de um dispositivo selecionado em tempo quase real e exibe dados de agregação, como umidade média, mínima e máxima.
• Um painel Histórico de Alarme que mostra eventos recentes de alarme quando um valor de telemetria excedeu um limite. Você pode definir seus próprios alarmes além dos exemplos criados pela solução pré-configurada.
• Um painel Trabalhos que exibe informações sobre os trabalhos agendados. Você pode agendar seus próprios trabalhos na página Trabalhos de gerenciamento.

Exibir alarmes

O painel do histórico de alarme mostra que cinco dispositivos estão relatando valores de telemetria maiores que o esperado.

Observação

Esses alarmes são gerados por uma regra que está incluída na solução pré-configurada. Essa regra gera um alerta quando o valor de temperatura enviado por um dispositivo excede 60. Você pode definir suas próprias regras e ações escolhendo Regras e Ações no menu esquerdo.

Exibir dispositivos

A lista de dispositivos mostra todos os dispositivos registrados na solução. Na lista de dispositivos, você pode exibir e editar os metadados do dispositivo, adicionar ou remover os dispositivos e chamar métodos nos dispositivos. Você pode filtrar e classificar a lista de dispositivos na lista de dispositivos. Você também pode personalizar as colunas mostradas na lista de dispositivos.

1. Escolha Dispositivos para mostrar a lista de dispositivos para esta solução.

   

2. A lista de dispositivos mostra inicialmente 25 dispositivos simulados criados pelo processo de provisionamento. Você pode adicionar dispositivos simulados e físicos extras à solução.

3. Clique em um dispositivo na lista de dispositivos para exibir os respectivos detalhes.

   

O painel Detalhes do Dispositivo contém seis seções:

• Uma coleção de links que permite personalizar o ícone do dispositivo, desabilitar o dispositivo, adicionar uma regra, chamar um método ou enviar um comando. Para ter uma comparação de comandos (mensagens do dispositivo para nuvem) e métodos (métodos diretos), consulte Orientação para comunicações entre o dispositivo e a nuvem.
• A seção Dispositivo Gêmeo - Marcações permite editar os valores da marcação para o dispositivo. Você pode exibir os valores da marcação na lista de dispositivos e usar tais valores para filtrar a lista de dispositivos.
• A seção Dispositivo Gêmeo - Propriedades Desejadas permite definir os valores da propriedade a ser enviados para o dispositivo.
• A seção Dispositivo Gêmeo - Propriedades Relatadas mostra os valores da propriedade enviados do dispositivo.
• A seção Propriedades do Dispositivo mostra as informações do registro de identidade, como a ID do dispositivo e as chaves de autenticação.
• A seção Trabalhos Recentes mostra as informações sobre qualquer trabalho destinado recentemente a esse dispositivo.

Filtrar a lista de dispositivos

Você pode usar um filtro para exibir apenas os dispositivos que estão enviando valores de temperatura inesperados. A solução pré-configurada de monitoramento remoto inclui o filtro Dispositivos sem integridade para mostrar os dispositivos com um valor de temperatura médio maior que 60. Você também pode criar seus próprios filtros.

1. Escolha Abrir filtro salvo para exibir uma lista de filtros disponíveis. Escolha Dispositivos sem integridade para aplicar o filtro:

   

2. A lista de dispositivos agora mostra somente os dispositivos com um valor de temperatura média maior que 60.

   

Atualizar as propriedades desejadas

Você identificou agora um conjunto de dispositivos que precisam de correção. No entanto, você decide se a frequência de dados de 15 segundos não é suficiente para um diagnóstico claro do problema. Alterando a frequência de telemetria para 5 segundos para fornecer a você mais pontos de dados para diagnosticar melhor o problema. Você pode enviar essa alteração de configuração para seus dispositivos remotos no portal de solução. Você pode fazer a alteração uma vez, avaliar o impacto e, em seguida, agir nos resultados.

Siga estas etapas para executar um trabalho que altera a propriedade desejada TelemetryInterval para os dispositivos afetados. Quando os dispositivos recebem o novo valor de propriedade TelemetryInterval, eles alteram suas configurações para enviar telemetria a cada 5 segundos, em vez de a cada 15 segundos:

1. Enquanto você está mostrando a lista de dispositivos não íntegros na lista de dispositivos, escolha Agendador de trabalhos e, em seguida, Editar dispositivo Gêmeo.

2. Chame o trabalho Alterar intervalo de telemetria.

3. Altere o valor do nome da Propriedade desejadadesired.Config.TelemetryInterval para cinco segundos.

4. Escolha Agenda.

   

5. Monitore o progresso do trabalho na página Trabalhos de Gerenciamento no portal.

Observação

Se você quiser alterar um valor de propriedade desejada para um dispositivo individual, use a seção Propriedades Desejadas no painel Detalhes do Dispositivo em vez de executar um trabalho.

Esse trabalho define o valor da propriedade desejada TelemetryInterval no dispositivo gêmeo para todos os dispositivos selecionados pelo filtro. Os dispositivos recuperam esse valor do dispositivo gêmeo e atualizam seu comportamento. Quando um dispositivo recupera e processa uma propriedade desejada do dispositivo gêmeo, ele define a propriedade de valor relatado correspondente.

Invocar métodos

Enquanto o trabalho é executado, você observará na lista de dispositivos não íntegros que todos esses dispositivos têm versões de firmware antigas (abaixo da versão 1.6).

Essa versão de firmware pode ser a causa raiz dos valores de temperatura inesperados porque você sabe que outros dispositivos íntegros foram atualizados recentemente para a versão 2.0. Use o filtro interno Dispositivos antigos do firmware para identificar todos os dispositivos com versões antigas do firmware. No portal, você poderá atualizar remotamente todos os dispositivos ainda executando versões antigas de firmware:

1. Escolha Abrir filtro salvo para exibir uma lista de filtros disponíveis. Escolha Dispositivos com firmware antigo para aplicar o filtro:

   

2. A lista de dispositivos agora mostra somente os dispositivos com versões antigas de firmware. Essa lista inclui 5 dispositivos identificados pelo filtro Dispositivos não íntegros e 3 dispositivos adicionais:

   

3. Escolha Agendador de Trabalho e, em seguida, Chamar o Método.

4. Defina Nome do Trabalho para Atualização do firmware para a versão 2.0.

5. Escolha InitiateFirmwareUpdate como o Método.

6. Defina o parâmetro FwPackageUri como https://iotrmassets.blob.core.windows.net/firmwares/FW20.bin.

7. Escolha Agenda. O padrão é para que o trabalho seja executado agora.

   

Observação

Se você deseja invocar um método em um dispositivo individual, escolha Métodos no painel Detalhes do Dispositivo em vez de executar um trabalho.

Esse trabalho invoca o método direto InitiateFirmwareUpdate em todos os dispositivos selecionados pelo filtro. Os dispositivos respondem imediatamente ao Hub IoT e, em seguida, iniciam o processo de atualização de firmware assincronamente. Os dispositivos fornecem informações de status sobre o processo de atualização de firmware através de valores de propriedade relatados, conforme mostrado nas capturas de tela a seguir. Escolha o ícone Atualizar para atualizar as informações nas listas de dispositivo e de trabalho:

Observação

Em um ambiente de produção, você pode agendar trabalhos para execução durante uma janela de manutenção designada.

Análise do cenário

Nesse cenário, você identificou um problema potencial com alguns de seus dispositivos remotos usando o histórico de alarme no painel e um filtro. Você então usou o filtro e um trabalho para configurar remotamente os dispositivos para fornecer mais informações para ajudar a diagnosticar o problema. Finalmente, você usou um filtro e um trabalho para agendar a manutenção nos dispositivos afetados. Se você retornar para o painel, poderá verificar que não há alarmes provenientes de dispositivos em sua solução. Você pode usar um filtro para verificar se o firmware está atualizado em todos os dispositivos da sua solução e que não há mais dispositivos não íntegros:

Outros recursos

As seções a seguir descrevem alguns recursos adicionais de solução pré-configurada de monitoramento remoto que não são descritos como parte do cenário anterior.

Personalizar colunas

É possível personalizar as informações exibidas na lista de dispositivos clicando no Editor de colunas. Você pode adicionar e remover as colunas que exibem os valores de propriedade e marcação relatados. Também pode reorganizar e renomear as colunas:

Personalizar o ícone do dispositivo

Você pode personalizar o ícone do dispositivo exibido na lista de dispositivos no painel Detalhes do Dispositivo como a seguir:

1. Escolha o ícone de lápis para abrir o painel Editar imagem de um dispositivo:

   

2. Carregue uma nova imagem ou use uma das imagens existentes e, em seguida, escolha Salvar:

   

3. A imagem selecionada agora é exibida na coluna Ícone do dispositivo.

Observação

A imagem é colocada no armazenamento de blobs. Uma marcação no dispositivo gêmeo contém um link para a imagem no armazenamento de blobs.

Adicionar um dispositivo

Ao implantar a solução pré-configurada, você provisiona automaticamente os 25 dispositivos de exemplo exibidos na lista de dispositivos. Esses dispositivos são dispositivos simulados em execução em um Trabalho Web do Azure. Com os dispositivos simulados, você pode experimentar mais facilmente a solução pré-configurada sem a necessidade de implantar dispositivos físicos reais. Se você quiser conectar um dispositivo real à solução, confira o tutorial Conectar o dispositivo à solução pré-configurada de monitoramento remoto.

As etapas a seguir mostram como adicionar um dispositivo simulado à solução:

1. Navegue de volta para a lista de dispositivos.

2. Para adicionar um dispositivo, escolha + Adicionar um Dispositivo no canto inferior esquerdo.

   

3. Escolha Adicionar Novo no bloco Dispositivo Simulado.

   

   Além de criar um novo dispositivo simulado, você também poderá adicionar um dispositivo físico se optar por criar um Dispositivo Personalizado. Para saber mais sobre como conectar dispositivos físicos à solução, confira Conectar o dispositivo à solução pré-configurada de monitoramento remoto do IoT Suite.

4. Selecione Deixe-me definir minha própria ID de dispositivo e adicione um nome de ID de dispositivo exclusivo, como mydevice_01.

5. Escolha Criar.

   

6. Na etapa 3 de Adicionar um dispositivo simulado, escolha Concluído para retornar à lista de dispositivos.

7. Você pode exibir o dispositivo Executando na lista de dispositivos.

   

8. Você também pode exibir a telemetria simulada do novo dispositivo no painel:

   

Desabilitar e excluir um dispositivo

Você pode desabilitar um dispositivo e depois que ele for desabilitado, poderá removê-lo:

Adicionar uma regra

Não existem regras para o novo dispositivo recém-adicionado. Nesta seção, você adiciona uma regra que dispara um alarme quando a temperatura relatada pelo novo dispositivo excede 47 graus. Antes de começar, observe que o histórico de telemetria para o novo dispositivo no painel mostra que a temperatura do dispositivo nunca excede 45 graus.

1. Navegue de volta para a lista de dispositivos.

2. Para adicionar uma regra do dispositivo, selecione o novo dispositivo na Lista de Dispositivos e escolha Adicionar regra.

3. Crie uma regra que usa Temperature como o campo de dados e AlarmTemp como a saída quando a temperatura excede 47 graus:

   

4. Para salvar suas alterações, escolha Salvar e Exibir Regras.

5. Clique em Comandos no painel de detalhes do novo dispositivo.

   

6. Selecione ChangeSetPointTemp na lista de comandos e defina SetPointTemp como 45. Escolha Enviar Comando:

   

7. Navegue até o painel. Após um curto período, você verá uma nova entrada no painel Histórico de Alarme quando a temperatura relatada pelo seu novo dispositivo exceder o limite de 47 graus:

   

8. Você pode revisar e editar todas as regras na página Regras do painel:

   

9. Você pode revisar e editar todas as ações que podem ser realizadas em resposta a uma regra na página Ações do painel:

   

Observação

É possível definir ações que podem enviar uma mensagem de email ou SMS em resposta a uma regra ou se integrar com um sistema de linha de negócios por meio de um Aplicativo Lógico. Para obter mais informações, confira Conectar o Aplicativo Lógico à solução pré-configurada de monitoramento remoto do Azure IoT Suite.

Gerenciar filtros

Na lista de dispositivos, você pode criar, salvar e recarregar os filtros para exibir uma lista personalizada de dispositivos conectados ao hub. Para criar um filtro:

1. Escolha o ícone para editar o filtro acima da lista de dispositivos:

   

2. No Editor de filtro, adicione os campos, operadores e valores para filtrar a lista de dispositivos. Você pode adicionar várias cláusulas para refinar seu filtro. Escolha Filtrar para aplicar o filtro:

   

3. Neste exemplo, a lista é filtrada pelo fabricante e número do modelo:

   

4. Para salvar seu filtro com um nome personalizado, escolha o ícone Salvar como:

   

5. Para reaplicar um filtro salvo anteriormente, escolha o ícone Abrir filtro salvo:

   

Você pode criar filtros com base na id do dispositivo, estado do dispositivo, propriedades desejadas, propriedades relatadas e marcações. Adicione rótulos personalizados para um dispositivo na seção Rótulos do painel Detalhes do Dispositivo ou execute um trabalho para atualizar os rótulos em vários dispositivos.

Observação

No Editor de filtro, você pode usar a Exibição avançada para editar o texto da consulta diretamente.

Comandos

No painel Detalhes do Dispositivo, você pode enviar comandos ao dispositivo. Quando um dispositivo é iniciado, ele envia informações sobre os comandos a que ele dá suporte para a solução. Para obter uma discussão sobre as diferenças entre os métodos e comandos, confira Opções de nuvem para dispositivo do Hub IoT do Azure.

1. Escolha Comandos no painel Detalhes do Dispositivo do dispositivo selecionado:

   

2. Selecione PingDevice na lista de comandos.

3. Escolha Enviar Comando.

4. Você pode ver o status do comando no histórico de comandos.

   

A solução rastreia o status de cada comando enviado. Inicialmente, o resultado é Pendente. Quando o dispositivo relata que executou o comando, o resultado é definido como Sucesso.

Nos bastidores

Ao implantar uma solução pré-configurada, o processo de implantação criará vários recursos na assinatura do Azure que você selecionou. Você pode exibir esses recursos no portal do Azure. O processo de implantação cria um grupo de recursos com um nome baseado no nome escolhido para sua solução pré-configurada:

Você pode exibir as configurações de cada recurso selecionando-o na lista de recursos no grupo de recursos.

Você também pode exibir o código-fonte para a solução pré-configurada. O código-fonte da solução pré-configurada de monitoramento remoto está no repositório do GitHub azure-iot-remote-monitoring:

• A pasta DeviceAdministration contém o código-fonte para o painel.
• A pasta Simulator contém o código-fonte do dispositivo simulado.
• A pasta EventProcessor contém o código-fonte para o processo de back-end que manipula a telemetria de entrada.

Quando você terminar, poderá excluir a solução pré-configurada de sua assinatura do Azure no site azureiotsuite.com. Esse site permite que você exclua facilmente todos os recursos que foram provisionados quando criou a solução pré-configurada.

Observação

Para garantir que você excluirá tudo relacionado à solução pré-configurada, exclua-a no site azureiotsuite.com e não simplesmente exclua o grupo de recursos no portal.

Próximas etapas

Agora que você implantou uma solução de trabalho pré-configurada, poderá continuar a introdução ao Suite IoT lendo os seguintes artigos:

• Passo a passo da solução pré-configurada de monitoramento remoto
• Conexão seu dispositivo para a solução pré-configurada de monitoramento remoto
• Permissões no site azureiotsuite.com