Solução de problemas de um gateway SiteWise Edge - AWS IoT SiteWise

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 na Amazon CloudWatch e no sistema de arquivos local do seu gateway SiteWise Edge. Em seguida, você pode visualizar os arquivos de log para solucionar problemas no gateway do 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 Monitoramento AWS IoT SiteWise com CloudWatch métricas da Amazon.

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.

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.

  • 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, a configuração do Publisher e a fonte de dados do gateway SiteWise Edge podem estar fora de sincronia. Se estiverem fora de sincronia, a atualização do nome da fonte de dados pode acelerar a sincronização da nuvem para a borda, corrigindo o erro Fora de sincronização.

Para atualizar o nome de uma fonte de dados
  1. Navegue até o console do AWS IoT SiteWise.

  2. No painel de navegação, escolha Edge gateways.

  3. Selecione o gateway SiteWise Edge conectado ao painel.

  4. Em Fontes de dados, selecione Editar.

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

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

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

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.