Guia de solução de problemas para Atualização do Dispositivo no Hub IoT

Este documento lista algumas perguntas e problemas comuns relatados pelos usuários da Atualização de Dispositivo. Se você encontrar um problema que não apareça neste guia de solução de problemas, consulte a seção Contatando o Suporte da Microsoft para documentar sua situação.

Importando atualizações

P: Importei uma atualização com êxito, mas ela não está sendo exibida como disponível para implantar em dispositivos com os quais ela deve ser compatível

Verifique se o manifesto de importação .json arquivo não tem erros acidentais, especialmente nos valores do objeto de compatibilidade . As propriedades de compatibilidade no manifesto de importação devem corresponder exatamente às propriedades relatadas por seus dispositivos, o que garante que as atualizações certas sejam sempre enviadas apenas para os dispositivos certos. Por exemplo, pode haver um erro tipográfico no manifesto de importação que faz com que uma propriedade de compatibilidade tenha um caractere ausente, transposto ou extra em comparação com o que um dispositivo relata. Nesse caso, o serviço Atualização de Dispositivo para Hub IoT não pode corresponder à atualização a esse dispositivo. Se você já importou uma atualização, poderá verificar rapidamente se há problemas com as propriedades de compatibilidade clicando no link "Detalhes" para essa atualização e clicando em "Detalhes adicionais" no menu de submenu à direita. A partir daí, você pode exibir o conteúdo JSON do manifesto de importação para essa atualização e identificar possíveis erros.

P: Estou tendo problemas para conectar minha instância de Atualização de Dispositivo à minha instância do Hub IoT

Verifique se as rotas de mensagem do Hub IoT estão configuradas corretamente, de acordo com a documentação de recursos da Atualização de Dispositivo .

P: Estou encontrando um erro relacionado à função (mensagem de erro no portal do Azure ou um erro de API 403)

Talvez você não tenha permissões de acesso configuradas corretamente. Verifique se as permissões de acesso estão configuradas corretamente de acordo com a documentação de controle de acesso do Device Update .

P: Estou encontrando um erro de 500 tipos ao importar conteúdo para o serviço de Atualização de Dispositivo

Um código de erro no intervalo 500 pode indicar um problema com o serviço de Atualização de Dispositivo. Aguarde 5 minutos e tente novamente. Se o mesmo erro persistir, siga as instruções na seção Contatando o Suporte da Microsoft para registrar uma solicitação de suporte com a Microsoft.

P: Quero manter as mesmas propriedades de compatibilidade (direcionar minha atualização para o mesmo tipo de dispositivo), mas alterar o Provedor ou o Nome no manifesto de importação. Mas recebo um erro "Falha: erro ao importar atualização devido ao limite excedido" quando faço isso

O mesmo conjunto exato de propriedades de compatibilidade não pode ser usado com mais de uma combinação de Provedor de Atualizações e Nome. Essa política permite que o serviço de Atualização de Dispositivo determine com certeza quais atualizações devem estar disponíveis para implantação em um determinado dispositivo. Se você precisar atualizar vários componentes ou partições em um único dispositivo, o recurso de atualizações de proxy fornecerá essa funcionalidade.

P: Estou encontrando uma mensagem de erro ao importar conteúdo e gostaria de entender mais sobre ele

Consulte a documentação de Códigos de Erro de Atualização do Dispositivo para obter informações mais detalhadas sobre mensagens de erro relacionadas à importação.

Falhas no dispositivo

P: Como posso garantir que meu dispositivo esteja conectado à Atualização de Dispositivo para o Hub IoT?

Você pode verificar se o dispositivo está conectado à Atualização do Dispositivo verificando se ele aparece na seção de dispositivos "Desagrupados" na exibição de conformidade do portal do Azure.

P: Um ou mais dos meus dispositivos estão falhando ao atualizar

Há muitas causas raiz possíveis para uma falha de atualização do dispositivo. Valide se o dispositivo está: 1) conectado à instância do Hub IoT, 2) conectado à instância de Atualização de Dispositivo e 3) o serviço do do (Otimização de Entrega) está em execução. Se todos os três forem verdadeiros para seu dispositivo, siga as instruções na seção Contatando o Suporte da Microsoft para registrar uma solicitação de suporte com a Microsoft.

P: Meu agente de Atualização de Dispositivo está falhando ao iniciar

Um dos motivos mais comuns para uma falha na inicialização do agente de Atualização de Dispositivo é um arquivo de configuração malformado (du-config.json). Consulte a documentação do arquivo de configuração e verifique se o agente está configurado corretamente. Todos os valores no arquivo de configuração devem usar aspas duplas.

Implantando uma atualização

P: Eu implantei uma atualização no meu dispositivo, mas o status de conformidade diz que ela não está na atualização mais recente. O que devo fazer?

O status de conformidade do dispositivo pode levar até 5 minutos para ser atualizado.

P: O status de implantação do meu dispositivo indica que é incompatível, o que devo fazer?

As propriedades do fabricante e do modelo de um dispositivo de destino podem ter sido alteradas depois de conectar o dispositivo ao Hub IoT, fazendo com que o dispositivo agora seja considerado incompatível com o conteúdo de atualização da implantação atual.

Verifique a Interface do ADU Core para ver qual fabricante e modelo seu dispositivo está relatando ao serviço de Atualização de Dispositivo. Verifique se ele corresponde ao fabricante e ao modelo especificados no manifesto de importação do conteúdo de atualização que você está implantando. Você pode alterar essas propriedades para um determinado dispositivo usando o arquivo de configuração de Atualização de Dispositivo.

P: Vejo que minha implantação está no estágio "Ativo", mas nenhum dos meus dispositivos está "Em progresso" com a atualização. O que devo fazer?

Certifique-se de que a data de início da implantação não esteja definida no futuro. Quando você cria uma nova implantação, a data de início da implantação é padronizada para o dia seguinte como uma proteção, a menos que você a altere explicitamente. Você pode aguardar a chegada da data de início da implantação ou cancelar a implantação em andamento e criar uma nova implantação com a data de início desejada.

P: Estou tentando agrupar meus dispositivos, mas não vejo a marca na lista suspensa ao criar um grupo

Verifique se as rotas de mensagem no Hub IoT estão configuradas corretamente de acordo com a documentação de recursos de Atualização de Dispositivo . Você precisará marcar seu dispositivo novamente depois de configurar a rota.

Outra causa raiz pode ser que você aplicou a etiqueta antes de conectar seu dispositivo ao Device Update para o IoT Hub. Verifique se o dispositivo já está conectado à Atualização de Dispositivo. Você pode verificar se o seu dispositivo está conectado à Atualização de Dispositivo para IoT Hub verificando se ele aparece em "Dispositivos Desagrupados" na visão de conformidade. Adicione temporariamente uma marca de um valor diferente e adicione sua marca pretendida novamente quando o dispositivo estiver conectado.

Se você estiver usando o DPS (Serviço de Provisionamento de Dispositivos), certifique-se de marcar seus dispositivos depois que eles forem provisionados e não durante o processo de criação do dispositivo. Se você já tiver marcado seu dispositivo durante a etapa de criação do dispositivo, precisará marcar temporariamente seu dispositivo com um valor diferente depois que ele for provisionado e, em seguida, adicionar sua marca pretendida novamente.

P: Minha implantação foi concluída com êxito, mas alguns dispositivos falharam ao atualizar

Essa condição pode ser causada por um erro do lado do cliente nos dispositivos com falha. Consulte a seção Falhas do Dispositivo deste guia de solução de problemas.

P: Encontrei um erro no UX ao tentar iniciar uma implantação

Essa condição pode ser causada por um bug de serviço/UX ou por um problema de permissões de API. Siga as instruções na seção Contatando o Suporte da Microsoft para registrar uma solicitação de suporte com a Microsoft.

P: Iniciei uma implantação, mas ela não está atingindo um estado final

Essa condição pode ser causada por um problema de desempenho de serviço, um bug de serviço ou um bug do cliente. Repita a implantação após 10 minutos. Se você encontrar o mesmo problema, extraia os logs do dispositivo e consulte a seção Falhas do Dispositivo deste guia de solução de problemas. Se o mesmo problema persistir, siga as instruções na seção Contatando o Suporte da Microsoft para registrar uma solicitação de suporte com a Microsoft.

P: Eu migrei de um agente no nível do dispositivo para adicionar o agente como uma identidade de módulo no dispositivo. Agora, minha atualização é mostrada como "em andamento", mesmo que seja aplicada ao dispositivo

Essa condição pode acontecer se um agente mais antigo que estava se comunicando pelo Dispositivo Gêmeo não tiver sido removido. Quando você provisiona o agente de Atualização de Dispositivo como um Módulo (veja como fazer), todas as comunicações entre o dispositivo e o serviço de Atualização de Dispositivo ocorrem por meio do Módulo Gêmeo. Lembre-se de marcar o Módulo Gêmeo do dispositivo ao criar grupos e todas as comunicações devem acontecer no módulo gêmeo.

Baixando atualizações em dispositivos

P: Como retome um download quando um dispositivo se reconecta após um período de desconexão?

O download será retomado automaticamente quando a conectividade for restaurada dentro de um período de 24 horas. Após 24 horas, o usuário precisará reiniciar o download.

Usando o MCC (Cache Conectado da Microsoft)

P: Estou encontrando um problema ao tentar implantar o módulo MCC no meu dispositivo IoT Edge

Consulte a documentação do IoT Edge para implantar módulos do Edge em dispositivos do IoT Edge. Você pode verificar se o módulo MCC está sendo executado com êxito em seu dispositivo IoT Edge navegando até http://localhost:5100/Summary.

P: Um dos meus dispositivos IoT está tentando baixar uma atualização por meio do MCC, mas está falhando

Há vários problemas que podem estar fazendo com que um dispositivo IoT falhe ao se conectar ao MCC. Para diagnosticar o problema, colete os logs do cliente DO e do Nginx do dispositivo com falha (consulte a seção Contacting Microsoft Support para obter instruções sobre como coletar logs de cliente).

Seu dispositivo pode não estar conseguindo extrair conteúdo da Internet para passar para o módulo MCC porque a URL que ele está usando não é permitida. Confirme isso verificando as variáveis de ambiente do IoT Edge no portal do Azure.

Solução de problemas de uma instância ausente no portal do Azure

P: Não vejo uma instância da Atualização de Dispositivo para Hub IoT quando seleciono o ícone "engrenagem"

Há algumas causas possíveis para esse problema. Veja abaixo as etapas de solução de problemas.

Uma instância de Atualização de Dispositivo precisa ser associada a um hub IoT do Azure no mesmo grupo de recursos e assinatura. Se você mover sua instância de Atualização de Dispositivo ou seu hub para um grupo de recursos ou assinatura diferente, talvez não veja sua instância no portal do Azure. Nesse caso, siga uma das seguintes etapas para continuar usando a Atualização de Dispositivo para o Hub IoT:

• Retorne os itens movidos para a configuração original.

• Se você moveu apenas o hub IoT de um grupo de recursos para outro, modifique sua instância de Atualização de Dispositivo com o novo resourceId do Hub IoT.

• Se você moveu itens de uma assinatura para outra, verifique se a conta de Atualização de Dispositivo e o Hub IoT estão na mesma assinatura e modifique sua instância de Atualização de Dispositivo com a nova resourceId do Hub IoT.

Pelo menos as permissões de nível de leitura são necessárias para o hub IoT e sua conta de Atualização de Dispositivo para Hub IoT para acessar a funcionalidade de Atualização de Dispositivo por meio da experiência do hub IoT no portal do Azure.

• Para gerenciar permissões para o Hub IoT:
  • Selecione seu hub no portal do Azure
  • Selecione "Controle de acesso (IAM) na barra de navegação à esquerda.
  • Selecione "Adicionar atribuição de função".
  • Selecione uma função com pelo menos acesso de leitura e selecione Avançar.
  • Ao lado de "Membros", selecione "+Selecionar membros".
  • Adicione sua conta no submenu à direita e selecione o botão "Selecionar".
  • Selecione “Revisar + atribuir“.
• Para gerenciar permissões para sua conta do Device Update para Hub IoT, peça ao proprietário da conta para executar estas etapas:
  • Selecione sua conta de Atualização de Dispositivo no portal do Azure.
  • Selecione "Controle de acesso (IAM) na barra de navegação à esquerda.
  • Selecione "Adicionar atribuição de função".
  • Selecione a função Leitor (ou uma com permissões equivalentes).
  • Ao lado de "Membros", selecione "+Selecionar membros".
  • Adicione sua conta no submenu à direita e selecione o botão "Selecionar".
  • Selecione “Revisar + atribuir“.

Saiba mais sobre o controle de acesso baseado em função para o serviço de Atualização de Dispositivo.

Entrando em contato com o Suporte da Microsoft

Se você encontrar problemas que não podem ser resolvidos usando o conteúdo nesta página, você poderá arquivar uma solicitação de suporte com o Suporte da Microsoft por meio da interface do portal do Azure. Dependendo da categoria à qual você indica que seu problema pertence, você pode ser solicitado a coletar e compartilhar mais dados para ajudar o Suporte da Microsoft a investigar seu problema.

Consulte o texto restante nesta seção para obter instruções sobre como coletar cada tipo de dados.

Você pode usar getDevice para verificar se há informações adicionais na resposta de conteúdo da API.

Inclua também as seguintes informações, se possível, pois elas podem ser úteis para restringir a causa raiz do problema:

• Que tipo de dispositivo você está tentando atualizar (Gateway do IoT Edge, outros)
• Qual tipo de cliente de Atualização de Dispositivo você está usando (baseado em imagem, baseado em pacote, simulador)
• Qual sistema operacional seu dispositivo está em execução
• Detalhes sobre a arquitetura do dispositivo
• Se você usou com êxito a Atualização de Dispositivo para atualizar um dispositivo antes

Coletando logs de clientes

• No Dispositivo Raspberry Pi, há dois conjuntos de logs encontrados aqui:

/adu/logs

/var/cache/do-client-lite/log

• Para o cliente empacotado, os logs são encontrados aqui:

/var/log/adu

/var/cache/do-client-lite/log

• Para o Simulador, os logs são encontrados aqui:

/tmp/aduc-logs

Códigos de erro

Você pode ser solicitado a fornecer códigos de erro ao relatar um problema relacionado à importação de uma atualização, a uma falha do dispositivo ou à implantação de uma atualização.

Códigos de erro podem ser obtidos examinando a interface ADUCoreInterface . Consulte a documentação de códigos de erro de Atualização de Dispositivo para obter informações sobre como analisar códigos de erro para autodiagnóstico e solução de problemas.

ID de rastreamento

Você pode ser solicitado a fornecer uma ID de rastreamento ao relatar um problema relacionado à importação ou implantação de uma atualização.

A ID de rastreamento de uma determinada ação do usuário pode ser encontrada na resposta à API ou na seção Importar Histórico da interface do usuário do portal do Azure.

Atualmente, as IDs de rastreamento para ações de implantação só são acessíveis por meio da resposta à API.

ID da implementação

Você pode ser solicitado a fornecer uma ID de implantação ao relatar um problema relacionado à implantação de uma atualização.

A ID de implantação é criada pelo usuário ao chamar a API para iniciar uma implantação.

Atualmente, as IDs de implantação para implantações iniciadas a partir da interface do usuário do portal do Azure são geradas automaticamente e não são exibidas para o usuário.

Nome da instância do Hub IoT

Você pode ser solicitado a fornecer o nome da instância do Hub IoT ao relatar um problema relacionado a falhas de dispositivo ou implantar uma atualização.

O nome do Hub IoT é escolhido pelo usuário quando provisionado pela primeira vez.

Nome da conta de Atualização do Dispositivo

Você pode ser solicitado a fornecer o nome da sua conta de Atualização de Dispositivo ao relatar um problema relacionado à importação de uma atualização, falhas de dispositivo ou implantação de uma atualização.

O nome da conta de Atualização do Dispositivo é escolhido pelo usuário ao se inscrever pela primeira vez no serviço. Mais informações podem ser encontradas na documentação dos recursos de Atualização de Dispositivo.

Nome da instância de Atualização do Dispositivo

Você pode ser solicitado a fornecer o nome da instância de Atualização de Dispositivo ao relatar um problema relacionado à importação de uma atualização, falhas de dispositivo ou implantação de uma atualização.

O nome da instância de Atualização de Dispositivo é escolhido pelo usuário quando provisionado pela primeira vez. Mais informações podem ser encontradas na documentação dos recursos de Atualização de Dispositivo.

ID do dispositivo

Você pode ser solicitado a fornecer uma ID do dispositivo ao relatar um problema relacionado a falhas de dispositivo ou implantar uma atualização.

A ID do dispositivo é definida pelo cliente quando o dispositivo é provisionado pela primeira vez. Ele também pode ser recuperado do Gêmeo Digital do dispositivo.

ID da atualização

Você pode ser solicitado a fornecer uma ID de atualização ao relatar um problema relacionado à implantação de uma atualização.

A ID de atualização é definida pelo cliente ao iniciar uma implantação.

Logs do Nginx

Você pode ser solicitado a fornecer logs Nginx ao relatar um problema relacionado ao Cache Conectado da Microsoft.

ADU-conf.txt

Você pode ser solicitado a fornecer o arquivo de configuração de Atualização de Dispositivo ("adu-conf.txt") ao relatar um problema relacionado à implantação de uma atualização.

O arquivo de configuração é opcional e criado pelo usuário seguindo as instruções na documentação de configuração da Atualização de Dispositivo .

Manifesto de importação

Você pode ser solicitado a fornecer seu arquivo de manifesto de importação ao relatar um problema relacionado à importação ou implantação de uma atualização.

O manifesto de importação é um arquivo criado pelo cliente ao importar conteúdo de atualização para o serviço de Atualização de Dispositivo.

Próximas etapas

Saiba mais sobre códigos de erro de Atualização de Dispositivo