Gerenciar dispositivos em massa em seu aplicativo do Azure IoT Central
Você pode usar o Azure IoT Central para gerenciar seus dispositivos conectados em escala por meio de trabalhos. Os trabalhos permitem que você faça atualizações em massa nas propriedades do dispositivo e da nuvem e execute comandos. Este artigo mostra como usar trabalhos em seu próprio aplicativo e como usar os recursos de importação e exportação.
Para saber como gerenciar trabalhos usando a API REST do IoT Central, consulte Como usar a API REST do IoT Central para gerenciar dispositivos.
Gorjeta
Quando criar um trabalho recorrente, inicie sessão na sua aplicação utilizando uma conta Microsoft ou uma conta Microsoft Entra. Se você entrar usando um grupo do Microsoft Entra, é possível que o token do Microsoft Entra associado ao grupo expire em algum momento no futuro e faça com que o trabalho falhe.
Criar e executar um trabalho
O exemplo a seguir mostra como criar e executar um trabalho para definir o limite de luz para um grupo de dispositivos. Use o assistente de trabalho para criar e executar trabalhos. Você pode salvar um trabalho para executar mais tarde:
No painel esquerdo, selecione Trabalhos.
Selecione + Novo.
Na página Configurar seu trabalho, insira um nome e uma descrição para identificar o trabalho que você está criando.
Se seu aplicativo usa organizações, selecione a organização à qual associar o trabalho. Somente os usuários na organização podem exibir ou modificar o trabalho. A função do usuário determina as permissões que o usuário tem.
Selecione o grupo de dispositivos de destino ao qual você deseja que seu trabalho se candidate. Se seu aplicativo usa organizações, a organização selecionada determina os grupos de dispositivos disponíveis. Você pode ver a quantos dispositivos sua configuração de trabalho se aplica abaixo da seleção do grupo de dispositivos.
Escolha Propriedade de nuvem, Propriedade, Comando, Alterar modelo de dispositivo ou Alterar manifesto de implantação de borda como o tipo de trabalho. Para configurar um:
- Trabalho de propriedade, selecione uma propriedade e defina seu novo valor. Um trabalho de propriedade pode definir várias propriedades.
- Trabalho de comando, escolha o comando a ser executado.
- Alterar o trabalho de modelo de dispositivo, selecione o modelo de dispositivo a ser atribuído aos dispositivos no grupo de dispositivos.
- Alterar trabalho de manifesto de implantação de borda, selecione o manifesto de implantação do IoT Edge para atribuir aos dispositivos IoT Edge no grupo de dispositivos.
Selecione Salvar e sair para adicionar o trabalho à lista de trabalhos salvos na página Trabalhos . Mais tarde, você pode retornar a um trabalho na lista de trabalhos salvos.
Selecione Avançar para ir para a página Opções de entrega. A página Opções de Entrega permite definir as opções de entrega do limite de Lotes e Cancelamento para este trabalho:
Os lotes permitem escalonar trabalhos para um grande número de dispositivos. O trabalho é dividido em vários lotes e cada lote contém um subconjunto dos dispositivos. Os lotes são enfileirados e executados em sequência.
O limite de cancelamento permite cancelar automaticamente um trabalho se o número de erros exceder o limite definido. O limite pode ser aplicado a todos os dispositivos no trabalho ou a lotes individuais.
Selecione Avançar para ir para a página Agendar . A página Agenda permite habilitar uma agenda para executar o trabalho no futuro.
Escolha uma opção de recorrência para a agenda. Você pode configurar um trabalho para executar:
- Único
- Diárias
- Semanais
Defina uma data e hora de início para um trabalho agendado. A data e a hora são específicas do seu fuso horário e não da hora local do dispositivo.
Para encerrar uma agenda recorrente, escolha:
- Neste dia para definir uma data final para o cronograma.
- Depois de definir o número de vezes para executar o trabalho.
Os trabalhos agendados são sempre executados nos dispositivos de um grupo de dispositivos, mesmo que a associação ao grupo de dispositivos mude ao longo do tempo.
Selecione Avançarpara ir para a página Revisão. A página Revisão mostra os detalhes da configuração do trabalho. Selecione Agendar para agendar o trabalho:
A página de detalhes do trabalho mostra informações sobre trabalhos agendados. Quando o trabalho agendado é executado, você vê uma lista das instâncias do trabalho. A execução de trabalho agendada também faz parte da lista de trabalhos dos últimos 30 dias .
Nesta página, você pode Desagendar o trabalho ou Editar o trabalho agendado. Você pode retornar a um trabalho agendado na lista de trabalhos agendados.
No assistente de trabalho, você pode optar por não agendar um trabalho e executá-lo imediatamente.
Um trabalho passa por fases pendentes, em execução e concluídas . Os detalhes de execução do trabalho contêm métricas de resultados, detalhes de duração e uma grade de lista de dispositivos.
Quando o trabalho estiver concluído, você poderá selecionar Registro de resultados para baixar um arquivo CSV com os detalhes do trabalho, incluindo os dispositivos e seus valores de status. Essas informações podem ser úteis para solucionar problemas:
O trabalho agora aparece na lista Últimos 30 dias na página Trabalhos . Esta página mostra os trabalhos atualmente em execução e o histórico de todos os trabalhos executados ou salvos anteriormente.
Nota
Você pode visualizar 30 dias de histórico para seus trabalhos executados anteriormente.
Gerir tarefas
Para interromper um trabalho em execução, abra-o e selecione Parar. O status do trabalho é alterado para refletir que o trabalho foi interrompido. A seção Resumo mostra quais dispositivos foram concluídos, falharam ou ainda estão pendentes.
Quando um trabalho está em um estado interrompido, você pode selecionar Continuar para retomar a execução do trabalho. O status do trabalho muda para refletir que o trabalho está sendo executado novamente. A secção Resumo continua a ser atualizada com os progressos mais recentes.
Copiar um trabalho
Para copiar um trabalho existente, selecione um trabalho executado. Selecione Copiar na página de resultados do trabalho ou na página de detalhes do trabalho. Uma cópia da configuração do trabalho é aberta para você editar e Copy é anexado ao nome do trabalho.
Ver o estado de tarefa
Depois que um trabalho é criado, a coluna Status é atualizada com a mensagem de status do trabalho mais recente. A tabela a seguir lista os possíveis valores de status do trabalho:
| Mensagem de estado | Significado do status |
|---|---|
| Concluída | Este trabalho foi executado em todos os dispositivos. |
| Com Falha | Este trabalho falhou e não foi totalmente executado em dispositivos. |
| Pendente | Este trabalho ainda não começou a ser executado em dispositivos. |
| Em Execução | Este trabalho está atualmente em execução em dispositivos. |
| Parado | Um usuário interrompeu manualmente esse trabalho. |
| Cancelada | Este trabalho foi cancelado porque o limite definido na página Opções de entrega foi excedido. |
A mensagem de status é seguida por uma visão geral dos dispositivos no trabalho. A tabela a seguir lista os possíveis valores de status do dispositivo:
| Mensagem de estado | Significado do status |
|---|---|
| Com êxito | O número de dispositivos em que o trabalho foi executado com êxito. |
| Com Falha | O número de dispositivos em que o trabalho não pôde ser executado. |
Para exibir o status do trabalho e todos os dispositivos afetados, abra-o. Ao lado do nome de cada dispositivo, você verá uma das seguintes mensagens de status:
| Mensagem de estado | Significado do status |
|---|---|
| Concluída | O trabalho foi executado neste dispositivo. |
| Com Falha | O trabalho falhou ao ser executado neste dispositivo. A mensagem de erro mostra mais informações. |
| Pendente | O trabalho ainda não foi executado neste dispositivo. |
Para baixar um arquivo CSV que inclua os detalhes do trabalho e a lista de dispositivos e seus valores de status, selecione Registro de resultados.
Filtrar a lista de dispositivos
Você pode filtrar a lista de dispositivos na página Detalhes do trabalho selecionando o ícone de filtro. Você pode filtrar no campo ID do dispositivo ou status:
Personalizar colunas na lista de dispositivos
Você pode adicionar colunas à lista de dispositivos selecionando o ícone de opções de coluna:
Use a caixa de diálogo Opções de coluna para escolher as colunas da lista de dispositivos. Selecione as colunas que pretende apresentar, selecione a seta para a direita e, em seguida, selecione OK. Para selecionar todas as colunas disponíveis, escolha Selecionar todas. As colunas selecionadas aparecem na lista de dispositivos.
As colunas selecionadas persistem em uma sessão de usuário ou em sessões de usuário que têm acesso ao aplicativo.
Executar trabalhos novamente
Você pode executar novamente um trabalho que tenha dispositivos com falha. Selecione Falha ao executar novamente.
Insira um nome e uma descrição do trabalho e selecione Executar trabalho novamente. Um novo trabalho é enviado para repetir a ação em dispositivos com falha.
Nota
Não é possível executar mais de cinco trabalhos ao mesmo tempo a partir de um aplicativo do Azure IoT Central.
Quando um trabalho é concluído e você exclui um dispositivo que está na lista de dispositivos do trabalho, a entrada do dispositivo aparece como excluída no nome do dispositivo. O link de detalhes não está disponível para o dispositivo excluído.
Importar dispositivos
Para registrar um grande número de dispositivos em seu aplicativo, você pode importar dispositivos em massa de um arquivo CSV. Você pode encontrar um arquivo CSV de exemplo no repositório de Exemplos do Azure. O arquivo CSV deve incluir os seguintes cabeçalhos de coluna:
| Column | Descrição |
|---|---|
| IOTC_DEVICEID | O ID do dispositivo é um identificador exclusivo que este dispositivo usará para se conectar. O ID do dispositivo pode conter letras, números e o - caractere sem espaços. O comprimento máximo é de 128 caracteres. |
| IOTC_DEVICENAME | Opcional. O nome do dispositivo é um nome amigável que será exibido em todo o aplicativo. Se não for especificado, o nome do dispositivo será o mesmo que o ID do dispositivo. O comprimento máximo é de 148 caracteres. |
Para registrar dispositivos em massa em seu aplicativo:
Escolha Dispositivos no painel esquerdo.
No painel esquerdo, escolha o modelo de dispositivo para o qual você deseja criar os dispositivos em massa.
Nota
Se ainda não tiver um modelo de dispositivo, pode importar dispositivos em Todos os dispositivos e registá-los sem um modelo. Depois que os dispositivos tiverem sido importados, você poderá migrá-los para um modelo.
Selecione Importar.
Selecione uma organização à qual atribuir os dispositivos. Todos os dispositivos que você está importando são atribuídos à mesma organização. Para atribuir dispositivos a organizações diferentes, crie vários arquivos de importação, um para cada organização. Como alternativa, carregue-os todos para a organização raiz e, em seguida, na interface do usuário, reatribua-os às organizações corretas.
Selecione o arquivo CSV que contém a lista de IDs de dispositivo a serem importados.
A importação do dispositivo é iniciada assim que o arquivo é carregado. Você pode acompanhar o status da importação no painel Operações do dispositivo. Este painel aparece automaticamente após o início da importação ou você pode acessá-lo através do ícone de sino no canto superior direito.
Quando a importação for concluída, uma mensagem de êxito será mostrada no painel Operações do dispositivo.
Se a operação de importação de dispositivo falhar, você verá uma mensagem de erro no painel Operações de dispositivo. Um arquivo de log capturando todos os erros é gerado que você pode baixar.
Se seus dispositivos usam tokens SAS para autenticação, exporte um arquivo CSV do seu aplicativo IoT Central. O arquivo CSV exportado inclui os IDs do dispositivo e as chaves SAS.
Se seus dispositivos usam certificados X.509 para autenticar, gere certificados folha X.509 para seus dispositivos usando o certificado raiz ou intermediário em seu grupo de registro X.509. Use as IDs de dispositivo importadas como o CNAME valor nos certificados folha.
Exportar dispositivos
Para conectar um dispositivo real ao IoT Central, você precisa de sua cadeia de conexão. Você pode exportar detalhes do dispositivo em massa para obter as informações necessárias para criar cadeias de conexão de dispositivo. O processo de exportação cria um arquivo CSV com a identidade do dispositivo, o nome do dispositivo e as chaves para todos os dispositivos selecionados.
Para exportar dispositivos em massa do seu aplicativo:
Escolha Dispositivos no painel esquerdo.
No painel esquerdo, escolha o modelo de dispositivo do qual deseja exportar os dispositivos.
Selecione os dispositivos que pretende exportar e, em seguida, selecione a ação Exportar .
O processo de exportação é iniciado. Você pode acompanhar o status usando o painel Operações do dispositivo.
Quando a exportação for concluída, uma mensagem de êxito será mostrada junto com um link para baixar o arquivo gerado.
Selecione o link Baixar arquivo para baixar o arquivo para uma pasta local no disco.
O arquivo CSV exportado contém as seguintes colunas: ID do dispositivo, nome do dispositivo, chaves do dispositivo e impressões digitais do certificado X509:
- IOTC_DEVICEID
- IOTC_DEVICENAME
- IOTC_SASKEY_PRIMARY
- IOTC_SASKEY_SECONDARY
- IOTC_X509THUMBPRINT_PRIMARY
- IOTC_X509THUMBPRINT_SECONDARY
Para obter mais informações sobre como conectar dispositivos reais ao seu aplicativo IoT Central, consulte Como os dispositivos se conectam.
Próximos passos
Agora que você aprendeu como gerenciar dispositivos em massa em seu aplicativo do Azure IoT Central, uma próxima etapa sugerida é aprender a editar um modelo de dispositivo.