Guia de solução de problemas para Atualização de Dispositivo para Hub IoT
Este documento lista algumas dúvidas e problemas comuns que os usuários da Atualização de Dispositivo relataram. Este guia de solução de problemas será atualizado periodicamente com novas perguntas e soluções, à medida que a Atualização de Dispositivo avança na Visualização Pública. Caso você encontre um problema que não aparece neste guia de solução de problemas, consulte a seção Entrando em contato com o Suporte da Microsoft para registrar sua situação.
Importando atualizações
P: Estou com problemas para conectar minha instância de Atualização de Dispositivo à minha instância do Hub IoT.
Verifique se as rotas de mensagens do Hub IoT estão configuradas corretamente, de acordo com a documentação de recursos de Atualização de Dispositivo.
P: Estou encontrando um erro relacionado à função (mensagem de erro no portal do Azure ou um erro da API 403).
Talvez você não tenha permissões de acesso configuradas corretamente. Verifique se a configuração está correta de acordo com a documentação de controle de acesso da Atualização de Dispositivo.
P: Estou encontrando um erro 500 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 Contatar o Suporte da Microsoft para arquivar 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. Porém, eu 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ção e Nome. Isso 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 só dispositivo, o recurso atualizações de proxy fornecerá essa funcionalidade.
P: Estou encontrando uma mensagem de erro ao importar conteúdo e gostaria de entender mais sobre ela.
Consulte a documentação sobre Códigos de erro de Atualização de Dispositivo para obter informações mais detalhadas sobre mensagens de erro relacionadas à importação.
Falhas de 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 dispositivos "desagrupados" no modo de exibição de conformidade do portal do Azure.
P: Um ou mais dispositivos meus estão com falha de atualização.
Há muitas causas raiz possíveis para uma falha na atualização de 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 (Otimização de Entrega) está em execução. Se as três opções forem verdadeiras para o seu dispositivo, siga as instruções na seção Contatar o Suporte da Microsoft para arquivar uma solicitação de suporte com a Microsoft.
Implantando uma atualização
P: Implantei uma atualização no(s) meu(s) dispositivo(s), mas de acordo com o status de conformidade, a atualização não está implantada. O que devo fazer?
O status de conformidade do dispositivo pode levar até 5 minutos para ser atualizado. Aguarde e verifique novamente.
P: O status incompatível é mostrado para a implantação do meu dispositivo, o que devo fazer?
As propriedades de fabricante e 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 da atualização da implantação atual.
Verifique a interface do ADU Core para ver qual fabricante e modelo seu dispositivo está relatando para o serviço de Atualização de Dispositivo e verifique se eles correspondem ao fabricante e ao modelo especificados no manifesto de importação do conteúdo de atualização que está sendo implantado. 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 andamento" com a atualização. O que devo fazer?
Verifique se a data de início da implantação não foi definida no futuro. Quando você cria uma nova implantação, a data de início da implantação é padronizada para o dia seguinte como 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 configurou corretamente as rotas de mensagem no seu Hub IoT, de acordo com a documentação de recursos de Atualização de Dispositivo. Você terá que marcar seu dispositivo novamente depois de configurar a rota.
Outra causa raiz pode ser que você tenha aplicado a marca antes de conectar seu dispositivo à Atualização de Dispositivo para Hub IoT. Verifique se o dispositivo já está conectado à Atualização de Dispositivo. Você pode verificar se o dispositivo está conectado à Atualização de Dispositivo para Hub IoT verificando se ele aparece nos dispositivos “Desagrupados” no modo de exibição de conformidade. Adicione temporariamente uma marca de um valor diferente e adicione a 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, será preciso marcar temporariamente seu dispositivo com um valor diferente depois que ele for provisionado e, em seguida, adicionar a marca pretendida novamente.
P: Minha implantação foi concluída com êxito, mas alguns dispositivos não foram atualizados.
Isso pode ter sido causado por um erro do lado do cliente nos dispositivos com falha. Confira a seção Falhas de Dispositivo deste guia de solução de problemas.
P: Encontrei um erro na experiência do usuário ao tentar iniciar uma implantação.
Isso pode ter sido causado por um bug de serviço/UX ou por um problema de permissões de API. Siga as instruções na seção Contatar o Suporte da Microsoft para arquivar uma solicitação de suporte com a Microsoft.
P: Eu iniciei uma implantação, mas ela não está chegando ao estado final.
Isso pode ter sido causado por um problema de desempenho de serviço, um bug de serviço ou um bug do cliente. Repita sua implantação após 10 minutos. Se você encontrar o mesmo problema, faça pull dos logs do dispositivo e consulte a seção Falhas de Dispositivo deste guia de solução de problemas. Se o mesmo problema persistir, siga as instruções na seção Contatar o Suporte da Microsoft para arquivar uma solicitação de suporte com a Microsoft.
P: Migrei de um agente de nível de dispositivo para adicionar o agente como uma identidade de módulo no dispositivo, e minha atualização é mostrada como “em andamento”, mesmo que tenha sido aplicada ao dispositivo.
_Isto pode ter sido causado porque você não removeu o agente mais antigo que estava se comunicando pelo Dispositivo Gêmeo. Ao provisionar 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 no Módulo Gêmeo, portanto, lembre-se de marcar o Módulo Gêmeo do dispositivo ao criar grupos e todas as comunicações devem ocorrer pelo módulo gêmeo.
Baixando atualizações em dispositivos
P: Como retomar um download quando um dispositivo for reconectado 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 download precisará ser reiniciado pelo usuário.
Usando o cache conectado da Microsoft (MCC)
P: Estou com problemas ao tentar implantar o módulo MCC no meu dispositivo de IoT Edge.
Consulte a documentação do IoT Edge para implantar módulos do Edge em dispositivos IoT Edge. Você pode verificar se o módulo MCC está sendo executado com êxito no 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 fazer com que haja falha na conexão de um dispositivo IoT ao MCC. Para diagnosticar o problema, colete os logs do cliente DO e Nginx do dispositivo com falha (consulte a seção Entrando em contato com o Suporte da Microsoft para instruções de como coletar logs do cliente).
Seu dispositivo pode estar falhando ao efetuar pull do conteúdo da Internet para passá-lo para seu módulo do MCC porque a URL usada não é permitida. Para determinar se é o caso, você precisará verificar as variáveis de ambiente do IoT Edge no portal do Azure.
Entrando em contato com o Suporte da Microsoft
Se você tiver problemas que não podem ser resolvidos por meio das perguntas frequentes acima, você pode abir uma solicitação de suporte junto ao Suporte da Microsoft por meio da interface do portal do Azure. Dependendo da categoria que você indicar para o seu problema, talvez você seja solicitado a coletar e compartilhar dados adicionais para ajudar o Suporte da Microsoft a investigar o problema.
Consulte as instruções abaixo sobre como coletar cada tipo de dados. Você pode usar getDevices para verificar se há informações adicionais na resposta de conteúdo da API.
Além disso, as seguintes informações podem ser úteis para restringir a causa raiz do seu problema:
- Que tipo de dispositivo você está tentando atualizar (Azure Percept, IoT Edge Gateway, 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á executando
- Detalhes sobre a arquitetura do seu dispositivo
- Se teve êxito com a Atualização de Dispositivo para atualizar um dispositivo anteriormente
Se você tiver alguma das informações acima disponíveis, inclua-as na descrição do seu problema.
Coletando logs do cliente
No dispositivo Raspberry Pi, há dois conjuntos de logs encontrados aqui:
/adu/logs/var/cache/do-client-lite/logPara o cliente empacotado, os logs são encontrados aqui:
/var/log/adu/var/cache/do-client-lite/logPara o Simulador, os logs são encontrados aqui:
/tmp/aduc-logs
Códigos do Erro
Talvez você precise fornecer os códigos de erro ao relatar um problema relacionado à importação de uma atualização, uma falha de dispositivo ou à implantação de uma atualização.
Os códigos de erro podem ser obtidos na interface ADUCoreInterface. Consulte a documentação de códigos de erro de atualização do dispositivo para informações sobre como analisar códigos de erro para autodiagnóstico e solução de problemas.
ID de rastreamento
Talvez você precise fornecer uma ID de rastreamento ao relatar um problema relacionado à importação ou implantação de uma atualização.
A ID de rastreamento para uma determinada ação de usuário pode ser encontrada na resposta da API ou na seção Histórico de importação da interface do usuário do portal do Azure.
Atualmente, as IDs de rastreamento para ações de implantação só podem ser acessadas por meio da resposta da API.
ID de Implantação
Talvez você precise fornecer uma ID de implantação ao relatar um problema relacionado à importação ou 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 na interface do usuário no portal do Azure são geradas automaticamente e não são apresentadas ao 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
Talvez você precise fornecer o nome da conta de Atualização do Dispositivo ao relatar um problema relacionado à importação de uma atualização, falhas do dispositivo ou à implantação de uma atualização.
O nome da conta de Atualização do Dispositivo é escolhido pelo usuário ao se registrar no serviço pela primeira vez. Mais informações podem ser encontradas na documentação de recursos de Atualização de Dispositivo.
Nome da instância da Atualização de Dispositivo
Talvez você precise fornecer o nome da instância de Atualização do Dispositivo ao relatar um problema relacionado à importação de uma atualização, falhas do dispositivo ou à implantação de uma atualização.
O nome da instância de atualização de dispositivo é escolhido pelo usuário quando é provisionada pela primeira vez. Mais informações podem ser encontradas na documentação de recursos de Atualização de Dispositivo.
ID do Dispositivo
Talvez você precise fornecer a ID do dispositivo ao relatar um problema relacionado a falhas de dispositivo ou ao implantar uma atualização.
A ID do dispositivo é definida pelo cliente quando o dispositivo é provisionado pela primeira vez. Ela também pode ser recuperada do dispositivo gêmeo do dispositivo.
ID de atualização
Talvez você precise fornecer uma ID de atualização ao relatar um problema relacionado à importação ou 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 do 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 deconfiguração da Atualização de Dispositivo.
Importar manifesto
Você pode ser solicitado a fornecer o 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óxima Etapa: saiba mais sobre os códigos de erro de Atualização de Dispositivo