Solução de problemas de um gateway SiteWise Edge - AWS IoT SiteWise
Configurando e acessando os registros do SiteWise Edge GatewaySolução de problemas SiteWise do Edge GatewaySolução de AWS IoT Greengrass problemas

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Solução de problemas de um gateway SiteWise Edge

AWS IoT SiteWise Os gateways Edge executam um conjunto de AWS IoT Greengrass componentes. Você pode configurar seu gateway SiteWise Edge para registrar eventos do conector na Amazon CloudWatch e no sistema de arquivos local do seu gateway SiteWise Edge. Em seguida, você pode visualizar os arquivos de log associados ao conector para solucionar problemas no gateway SiteWise Edge.

Você também pode visualizar CloudWatch as métricas relatadas pelos seus gateways do SiteWise Edge para solucionar problemas de conectividade ou fluxos de dados. Para ter mais informações, consulte AWS IoT Greengrass Version 1 métricas de gateway.

Configurando e acessando os registros do SiteWise Edge Gateway

Antes de poder visualizar os registros do SiteWise Edge Gateway, você deve configurar seu SiteWise Edge Gateway para enviar registros para o Amazon CloudWatch Logs ou armazenar os registros no sistema de arquivos local.

  • Use CloudWatch Registros se quiser usar o AWS Management Console para visualizar os arquivos de log do seu gateway SiteWise Edge. Para ter mais informações, consulte Usando o Amazon CloudWatch Logs.

  • Use registros do sistema de arquivos local se quiser usar a linha de comando ou o software local para visualizar os arquivos de log do gateway SiteWise Edge. Para ter mais informações, consulte Usando registros de serviço.

Solução de problemas SiteWise do Edge Gateway

Use as informações a seguir para solucionar problemas do gateway SiteWise Edge.

Não é possível implantar pacotes nos gateways SiteWise Edge

Se o componente AWS IoT Greengrass nucleus (aws.greengrass.Nucleus) estiver desatualizado, talvez você não consiga implantar pacotes no seu gateway SiteWise Edge. Você pode usar o AWS IoT Greengrass V2 console para atualizar o componente do AWS IoT Greengrass núcleo.

Atualize o componente do AWS IoT Greengrass núcleo (console)

  1. Navegue até o console do AWS IoT Greengrass.

  2. No painel de navegação, em AWS IoT Greengrass, escolha Implantações.

  3. Na lista Deployments, selecione a implantação que você deseja revisar.

  4. Escolha Revisar.

  5. Na página Especificar destino, escolha Próximo.

  6. Na página Selecionar componentes, em Componentes públicos, na caixa de pesquisa, digite aws.greengrass.Nucleus e em seguida escolha aws.greengrass.Nucleus.

  7. Escolha Próximo.

  8. Na página Configurar componentes, escolha Próximo.

  9. Na página Definir configurações de segurança, escolha Próximo.

  10. Na página Review, escolha Deploy.

As fontes Modbus TCP estão fora de sincronia

Sua fonte Modbus TCP pode estar fora de sincronia se o tipo de dados de origem for ASCII, UTF8 ou ISO8859, e você estiver executando uma versão antiga do conector do adaptador de protocolo Modbus-TCP. Para atualizar o conector para a versão mais recente, faça o seguinte:

  1. Faça login no console do AWS IoT Greengrass V1 console.

  2. No painel de navegação, escolha Groups.

  3. Em grupos AWS IoT Greengrass , escolha o grupo-alvo.

  4. No painel de navegação, escolha Conectores.

  5. Na coluna Atualização, escolha Disponível.

  6. Na página Atualizar conector, escolha a versão mais recente e escolha Atualizar.

Para mais informações, consulte Modbus-TCP Protocol Adapter connector no Guia do desenvolvedor do AWS IoT Greengrass Version 1 .

Não é possível se conectar ao gerenciador de fluxo

Você pode ver a seguinte mensagem de registro de swPublisher erros se o gerenciador de stream não estiver habilitado no AWS IoT Greengrass grupo do seu gateway SiteWise Edge.

com.amazonaws.greengrass.streammanager.client.StreamManagerClientImpl: Connect failed

A partir da versão 6, o AWS IoT SiteWise conector requer um gerenciador de fluxo. Para obter mais informações sobre como ativar o gerenciador de fluxo, consulte a etapa 5 do Configurando um grupo AWS IoT Greengrass.

Não foi possível conectar-se a uma fonte OPC-UA

Talvez você veja a seguinte mensagem OPCUACollector de registro de erros se a versão do OpenJDK instalado não for suportada.

java.security.KeyStoreException: Key protection  algorithm not found: java.security.UnrecoverableKeyException: Encrypt Private Key failed: unrecognized algorithm name: PBEWithSHA1AndDESede
          Failed to start OPC-UA Connection for Source 'Server 1': Failed to add key to store

Para fazer o downgrade para a versão compatível do OpenJDK, siga as etapas nesta seção. Essas etapas presumem que você use um dispositivo com Ubuntu. Se você usa uma distribuição Linux diferente, consulte a documentação relevante do seu dispositivo.

Para fazer o downgrade para o suporte Amazon Corretto 8

  1. Para desinstalar o OpenJDK atual, execute um dos comandos a seguir.

    • sudo apt purge -y openjdk-8-jre-headless
    • sudo apt-get purge -y java-1.8.0-amazon-corretto-jdk

  2. Para baixar e instalar o Amazon Corretto 8 compatível, execute o comando a seguir.

    curl -s https://corretto.aws/downloads/resources/8.282.08.1/java-1.8.0-amazon-corretto-jdk_8.282.08-1_amd64.deb --output /tmp/java-1.8.0-amazon-corretto-jdk_8.282.08-1_amd64.deb
sudo apt-get update && sudo apt-get install java-common
sudo dpkg --install /tmp/java-1.8.0-amazon-corretto-jdk_8.282.08-1_amd64.deb

  3. Para reiniciar o software AWS IoT Greengrass V1 Core, execute o comando a seguir.

    sudo /greengrass/ggc/core/greengrassd restart

AWS IoT SiteWise não recebe dados dos servidores OPC-UA

Se seus AWS IoT SiteWise ativos não estiverem recebendo dados enviados por seus servidores OPC-UA, você pode pesquisar os registros do gateway SiteWise Edge para solucionar problemas. Procure registros swPublisher de nível de informações que contenham a mensagem a seguir.

Emitting diagnostic name=PublishError.SomeException

Com base no tipo de SomeExceptionregistro, use os seguintes tipos de exceção e os problemas correspondentes para solucionar problemas com seu gateway SiteWise Edge:

  • ResourceNotFoundException— Seus servidores OPC-UA estão enviando dados que não correspondem ao alias de propriedade de nenhum ativo. Essa exceção pode ocorrer em dois casos:

    • Os aliases de propriedade não correspondem exatamente às variáveis OPC-UA, incluindo qualquer prefixo de origem definido. Verifique se os aliases de propriedade e os prefixos de origem estão corretos.

    • Você não mapeou as variáveis OPC-UA para propriedades de ativos. Para ter mais informações, consulte Mapeamento de fluxos de dados industriais para propriedades de ativos.

      Se você já mapeou todas as variáveis OPC-UA que deseja inserir AWS IoT SiteWise, você pode filtrar quais variáveis OPC-UA o gateway Edge envia. SiteWise Para ter mais informações, consulte Usando filtros de nó OPC-UA.

  • AccessDeniedException— O AWS IoT Greengrass grupo do seu gateway SiteWise Edge não tem permissões suficientes para usar a BatchPutAssetPropertyValueoperação para enviar dados às propriedades do ativo. Para obter mais informações, consulte os requisitos do conector do AWS IoT SiteWise.

  • InvalidRequestException— Seus tipos de dados de variáveis OPC-UA não correspondem aos tipos de dados de propriedades do seu ativo. Por exemplo, se uma variável de OPC-UA tiver um tipo de dados inteiro, sua propriedade de ativo correspondente deverá ser do tipo de dados inteiro. Uma propriedade de ativo de tipo duplo não pode receber valores inteiros OPC-UA. Para corrigir esse problema, defina novas propriedades com os tipos de dados corretos.

  • TimestampOutOfRangeException— Seu gateway SiteWise Edge está enviando dados que estão fora do alcance AWS IoT SiteWise aceito. AWS IoT SiteWise rejeita quaisquer pontos de dados com carimbos de data/hora anteriores a 7 dias no passado ou mais recentes que 5 minutos no futuro. Se seu gateway SiteWise Edge perdeu energia ou conexão com a AWS nuvem, talvez seja necessário limpar o cache do gateway SiteWise Edge.

  • ThrottlingExceptionou LimitExceededException— Sua solicitação excedeu uma cota de AWS IoT SiteWise serviço, como taxa de pontos de dados ingeridos ou taxa de solicitação para operações de API de dados de propriedades de ativos. Verifique se a configuração não excede a AWS IoT SiteWise cotas.

Nenhum dado foi mostrado no painel

Se não houver dados mostrados em seu painel, no console AWS IoT SiteWise, verifique se a configuração do publicador e a fonte de dados estão fora de sincronia. Para resolver esse problema, faça o seguinte:

  1. Faça login no console do AWS IoT SiteWise.

  2. Na seção Borda, abra a seção Gateways.

  3. Em Fontes de dados, selecione Editar.

    SiteWise Captura de tela de edição da fonte de dados do Edge Gateways.

  4. Selecione um novo nome de fonte e selecione Salvar para confirmar sua alteração.

  5. Verifique suas alterações confirmando que o nome da fonte de dados foi atualizado na tabela Fontes de dados.

Alterar o nome da fonte de dados pode acelerar a sincronização da nuvem para a borda, corrigindo o erro de fora de sincronia.

“Não foi possível encontrar ou carregar a classe principal” que aparece no aws.iot. SiteWiseEdgePublisher erro de registros em /greengrass/v2/logs

Se você ver esse erro, talvez seja necessário atualizar a versão java do seu gateway SiteWise Edge.

  • Em um terminal, execute o comando a seguir:

    java -version

    A versão do java com a qual seu gateway SiteWise Edge está sendo executado aparecerá abaixoOpenJDK Runtime Environment. Você verá uma resposta como a seguinte:

    openjdk version "11.0.20" 2023-07-18 LTS
OpenJDK Runtime Environment Corretto011.0.20.8.1 (build 11.0.20+8-LTS
OpenJDK 64-Bit Server VM Corretto-11.0.20.8.1 (build 11.0.20+8-LTS, mixed node)

Se você estiver executando a versão 11.0.20.8.1 do Java, deverá atualizar o pacote do IoT SiteWise Publisher para a versão 2.4.1 ou mais recente. Somente a versão 11.0.20.8.1 do java é afetada. Ambientes com outras versões java podem continuar usando versões mais antigas do componente IoT Publisher. SiteWise Para obter mais informações sobre a atualização de um pacote de componente, consulte Alterando a versão dos pacotes de componentes do SiteWise Edge Gateway.

Solução de AWS IoT Greengrass problemas

Para encontrar soluções para muitos problemas ao configurar ou implantar seu gateway SiteWise Edge AWS IoT Greengrass, consulte Solução de problemas AWS IoT Greengrass no Guia do AWS IoT Greengrass desenvolvedor.