Solução de problemas AWS IoT Greengrass V2

Use as informações e soluções de solução de problemas nesta seção para ajudar a resolver problemas com AWS IoT Greengrass Version 2.

Visualizar AWS IoT Greengrass Registros principais de software e componentes

O software AWS IoT Greengrass Core grava registros no sistema de arquivos local que você pode usar para visualizar informações em tempo real sobre o dispositivo principal. Você também pode configurar os dispositivos principais para gravar registros nos CloudWatch registros, para que você possa solucionar problemas remotamente nos dispositivos principais. Esses logs ajudam você a identificar problemas com os componentes, as implantações e os dispositivos principais. Para obter mais informações, consulte Monitore AWS IoT Greengrass logs.

AWS IoT Greengrass Principais problemas de software

Solucione os AWS IoT Greengrass principais problemas do software.

ThrottlingException da ListDeployments API

ThrottlingException da API ListDeployments: é possível ver isso quando houver um grande número de implantações na conta.

Para resolver isso, execute um dos procedimentos a seguir:

Não é possível configurar o dispositivo principal

Se o instalador do software AWS IoT Greengrass Core falhar e você não conseguir configurar um dispositivo principal, talvez seja necessário desinstalar o software e tentar novamente. Para obter mais informações, consulte Desinstale o AWS IoT Greengrass Software principal.

Não é possível iniciar o AWS IoT Greengrass Software principal como serviço de sistema

Se o software AWS IoT Greengrass Core falhar na inicialização, verifique os registros de serviço do sistema para identificar o problema. Um problema comum é quando o Java não está disponível na variável de ambiente PATH (Linux) ou na variável de sistema PATH (Windows).

Não é possível configurar o núcleo como um serviço do sistema

Você pode ver esse erro quando o instalador do software AWS IoT Greengrass Core não consegue ser configurado AWS IoT Greengrass como um serviço do sistema. Nos dispositivos Linux, esse erro costuma ocorrer se o dispositivo principal não tem o sistema de inicialização systemd. O instalador pode configurar com êxito o software AWS IoT Greengrass Core, mesmo que não consiga configurar o serviço do sistema.

Execute um destes procedimentos:

Não é possível se conectar a AWS IoT Core

Você pode ver esse erro quando o software AWS IoT Greengrass Core não consegue se conectar AWS IoT Core para recuperar trabalhos de implantação, por exemplo. Faça o seguinte:

Erro de falta de memória

Geralmente, esse erro ocorre se o dispositivo não tem memória suficiente para alocar um objeto no heap Java. Em dispositivos com memória limitada, talvez seja necessário especificar um tamanho máximo de heap para controlar a alocação de memória. Para obter mais informações, consulte Controlar a alocação de memória com opções de JVM.

Não é possível instalar a CLI do Greengrass

Você pode ver a seguinte mensagem do console ao usar o --deploy-dev-tools argumento no comando de instalação AWS IoT Greengrass do Core.

Thing group exists, it could have existing deployment and devices, hence NOT creating deployment for Greengrass first party dev tools, please manually create a deployment if you wish to

Isso ocorre quando o componente de CLI do Greengrass não é instalado porque seu dispositivo principal é membro de um grupo de itens que já tem uma implantação. Se essa mensagem for exibida, será possível implantar manualmente o componente de CLI do Greengrass (aws.greengrass.Cli) no dispositivo para instalar a CLI do Greengrass. Para obter mais informações, consulte Instalar a Greengrass CLI.

O usuário root não tem permissão para executar

Você pode ver esse erro quando o usuário que executa o software AWS IoT Greengrass Core (normalmenteroot) não tem permissão para executar sudo com nenhum usuário e grupo. Para o usuário padrão ggc_user do sistema, esse erro é semelhante ao seguinte:

Sorry, user root is not allowed to execute <command> as ggc_user:ggc_group.

Verifique se o arquivo /etc/sudoers dá permissão ao usuário para executar sudo como outros grupos. A permissão para o usuário em /etc/sudoers deve ser semelhante à do exemplo a seguir.

root    ALL=(ALL:ALL) ALL

com.aws.greengrass.lifecyclemanager. GenericExternalService: Não foi possível determinar user/group se deve executar com

Esse erro pode ocorrer quando o dispositivo principal tenta executar um componente, e o Greengrass nucleus não especifica um usuário padrão do sistema a ser usado para executar componentes.

Para corrigir esse problema, configure o Greengrass nucleus para especificar o usuário padrão do sistema que executa componentes. Para obter mais informações, consulte Configurar o usuário que executa os componentes e Configurar o usuário padrão do componente.

Falha ao mapear o segmento do objeto compartilhado: operação não permitida

Você pode ver esse erro quando o software AWS IoT Greengrass Core não consegue iniciar porque a /tmp pasta está montada com noexec permissões. Por padrão, a biblioteca Common Runtime (CRT) da AWS usa a pasta /tmp.

Execute um destes procedimentos:

Falha ao configurar o serviço do Windows

Esse erro pode ser exibido se você instalar o software AWS IoT Greengrass Core em um dispositivo Microsoft Windows 2016. O software AWS IoT Greengrass Core não é suportado no Windows 2016. Para obter uma lista dos sistemas operacionais compatíveis, consultePlataformas compatíveis.

Antes de usar o Windows 2016, você pode fazer o seguinte:

com.aws.greengrass.util.exceptions. TLSAuthException: Falha ao obter o gerenciador de confiança

Você pode ver esse erro ao instalar o software AWS IoT Greengrass Core sem um arquivo de autoridade de certificação (CA) raiz.

2022-06-05T10:00:39.556Z [INFO] (main) com.aws.greengrass.lifecyclemanager.Kernel: service-loaded. {serviceName=DeploymentService}
2022-06-05T10:00:39.943Z [WARN] (main) com.aws.greengrass.componentmanager.ClientConfigurationUtils: configure-greengrass-mutual-auth. Error during configure greengrass client mutual auth. {}
com.aws.greengrass.util.exceptions.TLSAuthException: Failed to get trust manager

Verifique se você especificou um arquivo de CA raiz válido com o parâmetro rootCaPath no arquivo de configuração fornecido ao instalador. Para obter mais informações, consulte Instalar o software do AWS IoT Greengrass Core.

com.aws.greengrass.deployment. IotJobsHelper: Nenhuma conexão disponível durante a assinatura do tópico de descrições do Iot Jobs. Tentarei novamente em algum momento

Você pode ver essa mensagem de aviso quando o dispositivo principal não consegue se conectar AWS IoT Core para assinar as notificações de tarefas de implantação. Faça o seguinte:

software.amazon.awssdk.services.iam.model. IamException: O token de segurança incluído na solicitação é inválido

Você pode ver esse erro ao instalar o software AWS IoT Greengrass Core com provisionamento automático e o instalador usar um token de AWS sessão que não é válido. Faça o seguinte:

Você também pode instalar o software AWS IoT Greengrass Core sem fornecer AWS credenciais. Para acessar mais informações, consulte Instalar AWS IoT Greengrass Software básico com provisionamento manual de recursos ou Instalar AWS IoT Greengrass Software principal com AWS IoT aprovisionamento de frotas.

software.amazon.awssdk.services.iot.model. IotException: Usuário: < o usuário não > está autorizado a executar: iot: GetPolicy

Você pode ver esse erro ao instalar o software AWS IoT Greengrass Core com provisionamento automático e o instalador usar AWS credenciais que não têm as permissões necessárias. Para obter mais informações sobre as permissões necessárias, consulte Política mínima de IAM para o instalador provisionar recursos.

Verifique as permissões para a identidade do IAM das credenciais e conceda à ela todas as permissões necessárias que estejam faltando.

Erro: com.aws.greengrass.shadowmanager.sync.model. FullShadowSyncRequest: Não foi possível executar a solicitação cloud shadow get

Você pode ver esse erro ao usar o componente do gerenciador de sombras para sincronizar sombras do dispositivo com AWS IoT Core. O código de status HTTP 403 indica que esse erro ocorreu porque a AWS IoT política do dispositivo principal não concede permissão para fazer chamadasGetThingShadow.

com.aws.greengrass.shadowmanager.sync.model.FullShadowSyncRequest: Could not execute cloud shadow get request. {thing name=MyGreengrassCore, shadow name=MyShadow}
2021-07-14T21:09:02.456Z [ERROR] (pool-2-thread-109) com.aws.greengrass.shadowmanager.sync.SyncHandler: sync. Skipping sync request. {thing name=MyGreengrassCore, shadow name=MyShadow}
com.aws.greengrass.shadowmanager.exception.SkipSyncRequestException: software.amazon.awssdk.services.iotdataplane.model.IotDataPlaneException: null (Service: IotDataPlane, Status Code: 403, Request ID: f6e713ba-1b01-414c-7b78-5beb3f3ad8f6, Extended Request ID: null)

Para sincronizar sombras locais com AWS IoT Core, a AWS IoT política do dispositivo principal deve conceder as seguintes permissões:

Verifique a AWS IoT política do dispositivo principal e adicione as permissões necessárias que estejam faltando. Para saber mais, consulte:

A operação aws.greengrass# não é suportada pelo < Greengrass >

Esse erro pode ser exibido quando você usa uma operação de comunicação entre processos (IPC) em um componente personalizado do Greengrass e o componente AWS fornecido não está instalado no dispositivo principal.

Para corrigir esse problema, adicione o componente necessário como uma dependência em sua receita de componentes, para que o software AWS IoT Greengrass Core instale o componente necessário ao implantar seu componente.

java.io. FileNotFoundException: < stream-manager-store-root-dir /stream_manager_metadata_store > (permissão negada)

Esse erro pode ocorrer no arquivo de log do Gerenciador de fluxos (aws.greengrass.StreamManager.log) quando você configura o Gerenciador de fluxos para usar uma pasta raiz que não existe ou que não tem as permissões corretas. Para obter mais informações sobre como configurar essa pasta, consulte a configuração do Gerenciador de fluxos.

com.aws.greengrass.security.provider.pkcs11. PKCS11CryptoKeyService: A chave privada ou o certificado com < etiqueta > não existe

Esse erro ocorre quando o componente do provedor PKCS #11 não consegue localizar ou carregar a chave privada ou o certificado que você especifica ao configurar o software AWS IoT Greengrass Core para usar um módulo de segurança de hardware (HSM). Faça o seguinte:

Leia a documentação do HSM para saber como consultar detalhes sobre os tokens de segurança. Se você precisar alterar o slot, o rótulo ou o ID do objeto de um token de segurança, consulte a documentação do HSM para saber como fazer isso.

software.amazon.awssdk.services.secretsmanager.model. SecretsManagerException: Usuário: o < usuário não > está autorizado a executar: secretsmanager: GetSecretValue on resource: arn < >

Esse erro pode ocorrer quando você usa o componente gerenciador de segredos para implantar um AWS Secrets Manager segredo. Se o perfil do IAM de troca de tokens do dispositivo principal não conceder permissão para obter o segredo, haverá falha na implantação e os logs do Greengrass incluirão esse erro.

software.amazon.awssdk.services.secretsmanager.model. SecretsManagerException: O acesso ao KMS não é permitido

Esse erro pode ocorrer quando você usa o componente gerenciador de segredos para implantar um AWS Secrets Manager segredo criptografado por uma AWS Key Management Service chave. Se o perfil do IAM de troca de tokens do dispositivo principal não conceder permissão para descriptografar o segredo, haverá falha na implantação e os logs do Greengrass incluirão esse erro.

Para corrigir o problema, adicione a permissão kms:Decrypt ao perfil de troca de tokens do dispositivo principal. Para saber mais, consulte:

java.lang. NoClassDefFoundError: com/aws/greengrass/security/CryptoKeySpi

Talvez você veja esse erro ao tentar instalar o software AWS IoT Greengrass Core com segurança de hardware e usar uma versão anterior do Greengrass nucleus que não oferece suporte à integração de segurança de hardware. Para usar a integração de segurança de hardware, é necessário ter o Greengrass nucleus versão 2.5.3 ou mais recente.

com.aws.greengrass.security.provider.pkcs11. PKCS11CryptoKeyService: CKR_OPERATION_NOT_INITIALIZED

Você pode ver esse erro ao usar a biblioteca TPM2 ao executar o AWS IoT Greengrass Core como um serviço do sistema.

Esse erro indica que você precisa adicionar uma variável de ambiente que forneça a localização do armazenamento PKCS #11 no arquivo de serviço AWS IoT Greengrass Core systemd.

Para obter mais informações, consulte a seção de requisitos da documentação do componente Fornecedor PKCS#11.

Dispositivo principal do Greengrass preso no núcleo v2.12.3

Se o dispositivo principal do Greengrass não revisar sua implantação da versão 2.12.3 do núcleo, talvez seja necessário fazer download e substituir o arquivo Greengrass.jar pelo Greengrass nucleus versão 2.12.2. Faça o seguinte:

Problema no modelo systemd do Greengrass nucleus v2.14.0

É possível encontrar esse problema se tiver instalado o Greengrass nucleus v2.14.0 em um dispositivo Linux com seu modelo de serviço systemd padrão. Faça o seguinte:

AWS IoT Greengrass problemas de nuvem

Use as informações a seguir para solucionar problemas com o AWS IoT Greengrass console e a API. Cada entrada corresponde a uma mensagem de erro que você pode ver ao executar uma ação.

Ocorreu um erro (AccessDeniedException) ao chamar a CreateComponentVersion operação: User: arn:aws:iam: < :123456789012:user/ username não está autorizado a executar: null >

Talvez você veja esse erro ao criar uma versão do componente a partir do AWS IoT Greengrass console ou com a CreateComponentVersion operação.

Esse erro indica que a fórmula não é um JSON ou YAML válido. Verifique a sintaxe da fórmula, corrija qualquer problema de sintaxe e tente novamente. É possível usar um verificador de sintaxe JSON ou YAML on-line para identificar problemas de sintaxe na fórmula.

Entrada inválida: Foram encontrados os seguintes erros nos artefatos: {<s3 ArtifactUri > = O recurso de artefato especificado não pode ser acessado}

Talvez você veja esse erro ao criar uma versão do componente a partir do AWS IoT Greengrass console ou com a CreateComponentVersion operação. Esse erro indica que um artefato do S3 na fórmula do componente não é válido.

Faça o seguinte:

Status de implantação INATIVO

Você pode obter um status de INACTIVE implantação ao chamar a ListDeployments API sem as AWS IoT políticas dependentes necessárias. É necessário ter as permissões necessárias para obter um status de implantação preciso. Para encontrar as ações dependentes, consulte Ações definidas pelo AWS IoT Greengrass V2 e siga as permissões necessárias para ListDeployments. Sem as AWS IoT permissões dependentes necessárias, você ainda verá o status da implantação, mas poderá ver um status de implantação impreciso doINACTIVE.

CreateDeployment retorna uma resposta de sucesso, mas GetDeployment retorna um erro 404

Você pode ver esse problema ao chamar a CreateDeployment operação para implantar em uma AWS IoT coisa ou grupo de coisas. A CreateDeployment chamada retorna um código de 200 status com um ID de implantação válido. No entanto, ao ligar GetDeployment com esse ID de implantação, você recebe um ResourceNotFoundException erro. O AWS IoT Greengrass console mostra uma página “Implantação não encontrada” para o URL de implantação. A implantação anterior do alvo também pode mostrar um INACTIVE status sem substituição.

Esse problema pode ocorrer quando várias CreateDeployment solicitações têm como alvo a mesma AWS IoT coisa ao mesmo tempo. Uma condição de corrida pode fazer com que a nuvem não registre a implantação. O dispositivo principal ainda recebe e aplica a implantação por meio da sombra do AWS IoT dispositivo, mas o serviço de AWS IoT Greengrass nuvem não tem registro disso. Depois que esse problema ocorrer, ele também poderá afetar implantações subsequentes no mesmo destino.

Faça o seguinte para resolver e evitar esse problema:

Problemas na implantação do dispositivo principal

Solucione problemas na implantação em dispositivos principais do Greengrass. Cada entrada corresponde a uma mensagem de log que você pode ver no dispositivo principal.

Erro: com.aws.greengrass.componentmanager.exceptions. PackageDownloadException: Falha ao baixar o artefato

Você pode ver esse erro quando o software AWS IoT Greengrass Core não consegue baixar um artefato de componente quando o dispositivo principal aplica uma implantação. O resultado desse erro é uma falha na implantação.

Quando você recebe esse erro, o log também inclui um rastreamento de pilha que é possível usar para identificar o problema específico. Cada uma das entradas a seguir corresponde a uma mensagem que você pode ver no rastreamento de pilha da mensagem de erro Failed to download artifact.

software.amazon.awssdk.services.s3.model.S3Exception: null (Serviço: S3, Código de status: 403, ID da solicitação: null,...)

O PackageDownloadException erro pode incluir esse rastreamento de pilha nos seguintes casos:

software.amazon.awssdk.services.s3.model.s3Exceção: acesso negado (serviço: S3, código de status: 403, ID da solicitação: RequestID < >

O PackageDownloadException erro pode incluir esse rastreamento de pilha quando o dispositivo principal não tem permissão para fazer chamadass3:GetBucketLocation. A mensagem de erro também inclui uma das mensagens abaixo.

reason: Failed to determine S3 bucket location

Garanta que o perfil de troca de tokens do dispositivo principal permita s3:GetBucketLocation no bucket do S3 em que o artefato está disponível.

Erro: com.aws.greengrass.componentmanager.exceptions. ArtifactChecksumMismatchException: Falha na verificação de integridade do artefato baixado. Provavelmente devido à corrupção do arquivo.

Você pode ver esse erro quando o software AWS IoT Greengrass Core não consegue baixar um artefato de componente quando o dispositivo principal aplica uma implantação. A implantação falha porque a soma de verificação do arquivo de artefato baixado não corresponde à soma de verificação AWS IoT Greengrass calculada quando você criou o componente.

Faça o seguinte:

Erro: com.aws.greengrass.componentmanager.exceptions. NoAvailableComponentVersionException: Falha ao negociar a > versão < do nome do componente com a nuvem e nenhuma versão local aplicável que atenda aos requisitos < >

Esse erro pode ocorrer quando um dispositivo principal não encontra uma versão do componente que atenda aos requisitos das implantações para esse dispositivo principal. O dispositivo principal verifica o componente no AWS IoT Greengrass serviço e no dispositivo local. A mensagem de erro inclui o destino de cada implantação e os requisitos de versão dessa implantação para o componente. O destino da implantação pode ser um item, um grupo de itens ou LOCAL_DEPLOYMENT, que representa a implantação local no dispositivo principal.

Esse problema pode ocorrer nos seguintes casos:

Para resolver esse problema, revise as implantações para incluir as versões de componente compatíveis ou remover as que são incompatíveis. Para obter mais informações sobre como revisar as implantações na nuvem, consulte Revisões das implantações. Para obter mais informações sobre como revisar as implantações locais, consulte o comando deployment create da CLI do AWS IoT Greengrass.

software.amazon.awssdk.services.greengrassv2data.model. ResourceNotFoundException: A versão mais recente do < Component ComponentName > não afirma compatibilidade com o < núcleo DevicePlatform > da plataforma

Esse erro pode ocorrer quando você implanta um componente em um dispositivo principal e o componente não lista uma plataforma compatível com a do dispositivo principal. Execute um destes procedimentos:

com.aws.greengrass.componentmanager.exceptions. PackagingException: A implantação tenta atualizar o núcleo da versão aws.greengrass.nucleus- para a < versão aws.greengrass.nucleus-, mas > nenhum componente do tipo nucleus foi incluído como componente alvo < >

Esse erro pode ocorrer quando você implanta um componente que depende do Greengrass nucleus e o dispositivo principal executa uma versão do Greengrass nucleus mais antiga do que a versão secundária mais recente disponível. Esse erro ocorre porque o software AWS IoT Greengrass Core tenta atualizar automaticamente os componentes para a versão compatível mais recente. No entanto, o software AWS IoT Greengrass Core impede que o núcleo do Greengrass seja atualizado para uma nova versão secundária, porque vários componentes AWS fornecidos dependem de versões secundárias específicas do núcleo do Greengrass. Para obter mais informações, consulte Comportamento da atualização do núcleo do Greengrass.

É necessário revisar a implantação para especificar a versão do Greengrass nucleus que deseja usar. Execute um destes procedimentos:

Erro: com.aws.greengrass.deployment.exceptions. DeploymentException: Não é possível processar a implantação. O diretório de lançamento do Greengrass não está configurado ou o Greengrass não está configurado como um serviço do sistema

Esse erro pode ocorrer quando você move um dispositivo do Greengrass de um grupo de itens para outro, e depois volta para o grupo original com implantações que exigem a reinicialização do Greengrass.

Para resolver esse problema, recrie o diretório de inicialização do dispositivo. Também é altamente recomendável atualizar para a versão 2.9.6 ou posterior do Greengrass nucleus.

Veja a seguir um script do Linux para recriar o diretório de inicialização. Salve o script em um arquivo chamado fix_directory.sh.

#!/bin/bash

set -e

GG_ROOT=$1
GG_VERSION=$2

CURRENT="$GG_ROOT/alts/current"

if [ ! -L "$CURRENT" ]; then
  mkdir -p $GG_ROOT/alts/directory_fix
  echo "Relinking $GG_ROOT/alts/directory_fix to $CURRENT"
  ln -sf $GG_ROOT/alts/directory_fix $CURRENT
fi

TARGET=$(readlink $CURRENT)

if [[ ! -d "$TARGET" ]]; then
  echo "Creating directory: $TARGET"
  mkdir -p "$TARGET"
fi

DISTRO_LINK="$TARGET/distro"
DISTRO="$GG_ROOT/packages/artifacts-unarchived/aws.greengrass.Nucleus/$GG_VERSION/aws.greengrass.nucleus/"
echo "Relinking Nucleus artifacts to $DISTRO_LINK"
ln -sf $DISTRO $DISTRO_LINK

Para rodar o script, execute o seguinte comando:

[root@ip-172-31-27-165 ~]# ./fix_directory.sh /greengrass/v2 2.9.5
Relinking /greengrass/v2/alts/directory_fix to /greengrass/v2/alts/current
Relinking Nucleus artifacts to /greengrass/v2/alts/directory_fix/distro

Informações: com.aws.greengrass.deployment.exceptions. RetryableDeploymentDocumentDownloadException: O Greengrass Cloud Service retornou um erro ao obter a configuração completa de implantação

Esse erro pode ocorrer quando o dispositivo principal recebe um documento de implantação grande, maior que 7 KB (para implantações que têm itens como destino) ou 31 KB (para implantações que têm grupos de itens como destino). Para recuperar um grande documento de implantação, a AWS IoT política de um dispositivo principal deve permitir a greengrass:GetDeploymentConfiguration permissão. Esse erro pode ocorrer quando o dispositivo principal não tem essa permissão. Quando esse erro ocorre, a implantação faz tentativas indefinidamente, e o status é Em andamento (IN_PROGRESS).

Para resolver esse problema, adicione a greengrass:GetDeploymentConfiguration permissão à AWS IoT política do dispositivo principal. Para obter mais informações, consulte Atualizar a AWS IoT política de um dispositivo principal.

Atenção: com.aws.greengrass.deployment. DeploymentService: Falha ao obter a hierarquia do grupo de coisas

Você pode ver esse aviso quando o dispositivo principal recebe uma implantação e a AWS IoT política do dispositivo principal não permite a greengrass:ListThingGroupsForCoreDevice permissão. Quando você cria uma implantação, o dispositivo principal usa essa permissão para identificar os grupos de itens e remover os componentes de qualquer grupo do qual você removeu o dispositivo principal. Se o dispositivo principal executa o Greengrass nucleus versão 2.5.0, há falha na implantação. Se o dispositivo principal executa o Greengrass nucleus versão 2.5.1 ou mais recente, a implantação prossegue, mas não remove os componentes. Para obter mais informações sobre o comportamento de remoção de grupos de itens, consulte Implemente AWS IoT Greengrass componentes em dispositivos.

Para atualizar o comportamento do dispositivo principal para remover componentes dos grupos de coisas dos quais você remove o dispositivo principal, adicione a greengrass:ListThingGroupsForCoreDevice permissão à AWS IoT política do dispositivo principal. Para obter mais informações, consulte Atualizar a AWS IoT política de um dispositivo principal.

A implantação remove inesperadamente componentes de um dispositivo principal

Uma implantação remove componentes do dispositivo principal que você não pretendia remover, e o dispositivo para de executá-los.

No Greengrass nucleus v2.18.2 e versões anteriores, uma sequência específica de eventos faz com que um dispositivo perca o registro de quais componentes cada grupo de coisas implantou. Após essa perda, uma implantação trata esses componentes como órfãos e os remove. O Greengrass nucleus v2.18.3 corrige esse problema.

A sequência começa quando a primeira implantação em um dispositivo falha e é revertida. Para ver a sequência completa, consulteComo um dispositivo perde esse registro.

Como verificar se um dispositivo perdeu esse registro

Essas etapas verificam a configuração do dispositivo para determinar a causa da remoção. Eles não identificam quais componentes uma implantação removeu. Inspecione /greengrass/v2/config/effectiveConfig.yaml no dispositivo principal.

Se as implantações removem componentes após o dispositivo perder esse registro

Depois que um dispositivo perde esse registro, a perda de componentes depende de qual implantação será executada a seguir.

Uma implantação remove componentes quando é executada enquanto o registro está ausente e não carrega a lista de componentes do grupo ausente:

Uma implantação não remove componentes quando:

Recuperação

Reiniciar o dispositivo não restaura o registro ausente. Você deve criar implantações para recuperar o dispositivo.

Para recuperar um dispositivo que perdeu esse registro, crie uma implantação voltada para cada grupo de coisas ao qual o dispositivo principal pertence. Uma implantação voltada para um grupo de coisas carrega a lista completa de componentes desse grupo. Isso reconstrói o registro local ausente. Uma implantação local não pode recuperar o dispositivo porque ele não carrega as informações dos componentes de outros grupos.

Depois de criar as implantações de recuperação, verifique se cada implantação foi concluída com êxito. Se uma implantação de recuperação falhar e reverter em uma versão do nucleus anterior à 2.18.3, o dispositivo perderá o registro novamente. Você deve repetir a recuperação.

Depois que uma implantação de recuperação for concluída com êxito, o dispositivo não perderá esse registro novamente. Isso é verdade mesmo que o dispositivo ainda execute o Greengrass nucleus v2.18.2 ou anterior. A implantação restaura o estado interno que protege o registro, para que falhas e reversões de implantação posteriores não causem essa perda. Se você reinstalar o software AWS IoT Greengrass Core, o dispositivo poderá perder esse registro novamente.

Prevenção

Atualize o dispositivo principal para o Greengrass nucleus v2.18.3 ou posterior para evitar esse problema.

Como um dispositivo perde esse registro

Um dispositivo perde esse registro quando todas as seguintes condições são verdadeiras:

Um dispositivo cuja primeira implantação foi concluída com êxito não perde esse registro.

Informações: com.aws.greengrass.deployment. DeploymentDocumentDownloader: Chamando a nuvem do Greengrass para obter a configuração completa de implantação

Essa mensagem informativa pode aparecer várias vezes sem um erro, porque o dispositivo principal registra o erro no nível de log DEBUG. Esse problema pode ocorrer quando o dispositivo principal recebe um documento de implantação grande. Quando esse problema ocorre, a implantação faz tentativas indefinidamente, e o status é Em andamento (IN_PROGRESS). Para obter mais informações sobre como resolver esse problema, consulte esta entrada de solução de problemas.

Causado por: software.amazon.awssdk.services.greengrassv2data.model. GreengrassV2DataException: null (Serviço: GreengrassV2Data, Código de status: 403, ID da solicitação: < > some_request_id, ID da solicitação estendida: null)

Esse erro pode ocorrer quando uma API de plano de dados não tem a permissão iot:Connect. Caso você não tenha a política correta, receberá uma exceção GreengrassV2DataException: 403. Para criar uma política de permissão, siga estas instruções: Crie uma AWS IoT política.

Problemas em componente de dispositivos principais

Solucione problemas no componente do Greengrass em dispositivos principais.

Avisar: '<comando>' não é reconhecido como um comando interno ou externo

Você pode ver esse erro nos registros de um componente do Greengrass quando o software AWS IoT Greengrass Core não executa um comando no script do ciclo de vida do componente. O estado do componente passa a ser BROKEN como resultado desse erro. Esse erro poderá ocorrer se o usuário do sistema que executa o componente, por exemplo ggc_user, não encontrar o executável do comando nas pastas em PATH.

Nos dispositivos Windows, verifique se a pasta que contém o executável está em PATH para o usuário do sistema que executa o componente. Se ela não estiver em PATH, faça um dos seguintes procedimentos:

O script Python não registra mensagens em log

Os dispositivos principais do Greengrass coletam logs que você pode usar para identificar problemas com componentes. Se as mensagens stdout e stderr do script Python não constarem nos logs do componente, talvez você tenha que liberar ou desabilitar o buffer para esses fluxos de saída padrão em Python. Faça o seguinte:

Para obter mais informações sobre como verificar se o script Python gera mensagens de log, consulte Monitore AWS IoT Greengrass logs.

A configuração do componente não é atualizada ao alterar a configuração padrão

Quando você altera DefaultConfiguration na fórmula de um componente, a nova configuração padrão não substitui a configuração existente do componente durante a implantação. Para aplicar a nova configuração padrão, é necessário redefinir a configuração do componente ao padrão. Ao implantar o componente, especifique uma única string vazia como a atualização de redefinição.

awsiot.greengrasscoreipc.model. UnauthorizedError

Esse erro pode ocorrer nos logs de um componente do Greengrass quando ele não tem permissão para executar uma operação de IPC em um recurso. Para conceder permissão a um componente para chamar uma operação de IPC, defina uma política de autorização de IPC na configuração do componente. Para obter mais informações, consulte Autorizar componentes a realizar operações de IPC.

com.aws.greengrass.authorization.exceptions. AuthorizationException: ID de política duplicada "<id" para a > "<>ComponentList” principal

Esse erro poderá ocorrer se várias políticas de autorização de IPC, inclusive em todos os componentes do dispositivo principal, usarem o mesmo ID de política.

Verifique as políticas de autorização de IPC dos componentes, corrija as possíveis duplicatas e tente novamente. Para criar IDs de política exclusivos, recomendamos combinar o nome do componente, o nome do serviço de IPC e um contador. Para obter mais informações, consulte Autorizar componentes a realizar operações de IPC.

com.aws.greengrass.tes. CredentialRequestHandler: Erro na recuperação AwsCredentials do TES (HTTP 400)

Você pode ver esse erro quando um dispositivo principal não consegue obter AWS credenciais do serviço de troca de tokens. O código de status HTTP 400 indica que esse erro ocorreu porque a função IAM de troca de tokens do dispositivo principal não existe ou não tem uma relação de confiança que permita que o provedor de AWS IoT credenciais a assuma.

Faça o seguinte:

com.aws.greengrass.tes. CredentialRequestHandler: Erro na recuperação AwsCredentials do TES (HTTP 403)

Você pode ver esse erro quando um dispositivo principal não consegue obter AWS credenciais do serviço de troca de tokens. O código de status HTTP 403 indica que esse erro ocorreu porque as AWS IoT políticas do dispositivo principal não concedem a iot:AssumeRoleWithCertificate permissão para o alias de AWS IoT função do dispositivo principal.

Analise as AWS IoT políticas do dispositivo principal e adicione a iot:AssumeRoleWithCertificate permissão para o alias de AWS IoT função do dispositivo principal. A mensagem de erro inclui o alias da AWS IoT função atual do dispositivo principal. Para obter mais informações sobre essa permissão e como atualizar as AWS IoT políticas do dispositivo principal, consulte AWS IoT Política mínima para dispositivos AWS IoT Greengrass V2 principais Atualizar a AWS IoT política de um dispositivo principal e.

com.aws.greengrass.tes. CredentialsProviderError: Não foi possível carregar credenciais de nenhum provedor

Talvez você veja esse erro quando o componente tenta solicitar AWS credenciais e não consegue se conectar ao serviço de troca de tokens.

Faça o seguinte:

Erro recebido ao tentar recuperar metadados do ECS: Não foi possível conectar-se ao URL do endpoint: "token” < ExchangeServiceEndpoint >

Você pode ver esse erro quando o componente não executa o serviço de troca de tokens e um componente tenta solicitar AWS credenciais.

Faça o seguinte:

CopyFrom: < ConfigurationPath já > é um contêiner, não uma folha

Esse erro pode ocorrer quando você altera um valor de configuração de um tipo de contêiner (lista ou objeto) para um tipo que não seja de contêiner (string, número ou booliano). Faça o seguinte:

Em seguida, você pode definir esse valor de configuração como string, número ou booliano.

com.aws.greengrass.componentmanager.plugins.docker.exceptions. DockerLoginException: Erro ao fazer login no registro usando credenciais - 'O esboço recebeu dados incorretos'.

Esse erro pode ocorrer nos logs do Greengrass nucleus quando o componente Gerenciador de aplicações do Docker tenta fazer download de uma imagem do Docker de um repositório privado no Amazon Elastic Container Registry (Amazon ECR). Esse erro ocorre se você usa o assistente de credenciais do Docker wincred (docker-credential-wincred). Como resultado, o Amazon ECR não pode armazenar as credenciais de login.

Faça uma das seguintes ações:

java.io.IOException: Não é possível executar o programa “cmd”...: [LogonUser] A senha dessa conta expirou.

Esse erro pode ocorrer em um dispositivo principal do Windows quando a senha do usuário do sistema que executa os processos do componente, como ggc_user, expirou. Como resultado, o software AWS IoT Greengrass Core não consegue executar processos de componentes como esse usuário do sistema.

aws.greengrass. StreamManager: Instantâneo excede o instante mínimo ou máximo

Ao atualizar o Gerenciador de fluxos v2.0.7 para uma versão entre v2.0.8 e v2.0.11, você pode ver o seguinte erro nos logs do componente Gerenciador de fluxos quando ele não pode ser iniciado.

2021-07-16T00:54:58.568Z [INFO] (Copier) aws.greengrass.StreamManager: stdout. Caused by: com.fasterxml.jackson.databind.JsonMappingException: Instant exceeds minimum or maximum instant (through reference chain: com.amazonaws.iot.greengrass.streammanager.export.PersistedSuccessExportStatesV1["lastExportTime"]). {scriptName=services.aws.greengrass.StreamManager.lifecycle.startup.script, serviceName=aws.greengrass.StreamManager, currentState=STARTING}
2021-07-16T00:54:58.579Z [INFO] (Copier) aws.greengrass.StreamManager: stdout. Caused by: java.time.DateTimeException: Instant exceeds minimum or maximum instant. {scriptName=services.aws.greengrass.StreamManager.lifecycle.startup.script, serviceName=aws.greengrass.StreamManager, currentState=STARTING}

Se você implantou o Gerenciador de fluxos v2.0.7 e deseja atualizar para uma versão mais recente, atualize-o diretamente para a versão 2.0.12. Para obter mais informações sobre o componente Gerenciador de fluxos, consulte Gerenciador de fluxos.

Problemas com o componente de função do Lambda do dispositivo principal

Solucione problemas com o componente de função do Lambda em dispositivos principais.

Os seguintes subsistemas cgroup não estão montados: dispositivos, memória

Esse erro pode ocorrer quando você executa uma função do Lambda em contêiner nos seguintes casos:

Para habilitar os cgroups v1, inicialize o dispositivo com os parâmetros do kernel Linux abaixo.

cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

ipc_client.py:64, Erro HTTP 400: Solicitação incorreta, B'Não existe assinatura para o rótulo de origem ou-lambda-arn e o rótulo de assunto ou-lambda-arn < > < >

Você pode ver esse erro ao executar uma função Lambda V1, que usa o SDK AWS IoT Greengrass Core, em um dispositivo principal V2 sem especificar uma assinatura no componente antigo do roteador de assinatura. Para corrigir esse problema, implante e configure o roteador legado de assinatura para especificar as assinaturas necessárias. Para obter mais informações, consulte Importar funções do Lambda no V1.

Versão do componente descontinuada

É possível ver uma notificação no Personal Health Dashboard (PHD) quando uma versão do componente em seu dispositivo principal foi descontinuada. A versão do componente envia essa notificação ao PHD em até 60 minutos após ser descontinuada.

Para ver quais implantações você precisa revisar, faça o seguinte usando a AWS Command Line Interface:

Problemas na interface de linha de comando do Greengrass

Solucione problemas com a CLI do Greengrass.

java.lang. RuntimeException: Não é possível criar o cliente ipc

Talvez você veja esse erro ao executar um comando da CLI do Greengrass e especificar uma pasta raiz diferente daquela em que o software AWS IoT Greengrass Core está instalado.

Siga um destes procedimentos para definir o caminho raiz e /greengrass/v2 substitua-o pelo caminho para a instalação AWS IoT Greengrass do software Core:

AWS Command Line Interface problemas

Solucionar AWS CLI problemas para AWS IoT Greengrass V2.

Erro: Escolha inválida: 'greengrassv2'

Você pode ver esse erro ao executar um AWS IoT Greengrass V2 comando com o AWS CLI (por exemplo,aws greengrassv2 list-core-devices).

Esse erro indica que você tem uma versão do AWS CLI que não oferece suporte AWS IoT Greengrass V2. Para usar AWS IoT Greengrass V2 com o AWS CLI, você deve ter uma das seguintes versões ou posterior:

aws --version

Para resolver esse problema, atualize o AWS CLI para uma versão posterior que ofereça suporte AWS IoT Greengrass V2. Para obter mais informações, consulte Como instalar, atualizar e desinstalar a AWS CLI no Guia do usuário da AWS Command Line Interface .