Problemas e ações corretivas

Esta página informa as causas de problemas comuns no LUC Analytics (LUCA) e as ações que os corrigem.

Cada tabela tem três colunas. "Problema" informa a mensagem que o aplicativo ou o Docker mostra, ou o que você vê. O texto entre "aspas duplas" é a mensagem exata. Um controle ou um rótulo do aplicativo está em negrito. Uma parte como {{code}} é um valor que o aplicativo escreve na mensagem.

O Docker e o contêiner

Para os procedimentos completos, consulte 01-install-and-start.md.

Problema	Causa	Ação
docker run falha com uma mensagem de que não conseguiu vincular a porta do host 127.0.0.1:8000. No Linux, a mensagem é address already in use.	Outro programa usa a porta 8000 no seu laptop. O Docker criou o contêiner, mas não o iniciou.	1. Digite docker rm luc-analytics. 2. Digite o comando docker run novamente com uma porta do host diferente, por exemplo -p 127.0.0.1:8080:8000. 3. No link do log, altere 8000 para 8080.
"The container name "/luc-analytics" is already in use" (o nome de contêiner "/luc-analytics" já está em uso)	Existe um contêiner de um comando docker run anterior.	Inicie esse contêiner com docker start luc-analytics. Ou remova-o com docker rm -f luc-analytics e digite o comando docker run novamente. O volume e os seus dados continuam.
O Docker Desktop fica em "Engine starting" (mecanismo iniciando), ou mostra um tempo esgotado do WSL.	O mecanismo do Docker ou a máquina virtual WSL 2 dele não inicia corretamente.	1. Clique com o botão direito no ícone do Docker na área de notificação da barra de tarefas. 2. Selecione Quit Docker Desktop (sair do Docker Desktop). 3. Inicie o Docker Desktop novamente. 4. Se o problema continuar, saia do Docker Desktop novamente. 5. Digite wsl --shutdown no PowerShell. 6. Inicie o Docker Desktop novamente.
docker version não mostra a parte Server (servidor).	O mecanismo do Docker não está iniciado.	Inicie o Docker Desktop. Aguarde até que ele mostre Engine running (mecanismo em execução).
O contêiner para imediatamente. O log, ou a saída de docker run, contém exec format error.	A compilação da imagem (amd64 ou arm64) não corresponde ao processador do seu laptop.	1. Digite $env:PROCESSOR_ARCHITECTURE no PowerShell. Em um Mac, digite uname -m no Terminal. 2. Digite docker image inspect luc-analytics --format "{{.Architecture}}". 3. Compare os dois valores. AMD64 corresponde a amd64. ARM64 corresponde a arm64. Em um Mac, x86_64 corresponde a amd64 e arm64 corresponde a arm64. 4. Se os valores não corresponderem, obtenha o arquivo de imagem da compilação correta (luc-analytics-beta-...-amd64.tar.gz ou luc-analytics-beta-...-arm64.tar.gz). 5. Digite docker rm luc-analytics. 6. Faça as etapas de "Carregar a imagem" em 01-install-and-start.md com o arquivo correto. 7. Inicie o contêiner novamente com o comando docker run.
Configurações > Memória mostra "Não detectado neste host — informe o limite de memória desta máquina ou VM."	O aplicativo não consegue encontrar o limite de memória dentro do Docker Desktop. Além disso, o Docker possivelmente tem pouca memória: por padrão, ele pode usar aproximadamente metade da memória do laptop.	1. Dê ao Docker 5 GB de memória ou mais no arquivo .wslconfig. 2. Digite wsl --shutdown e inicie o Docker Desktop novamente. 3. Em Configurações > Memória, digite a memória do Docker em Limite de memória do host / VM (GB). 4. Feche outros programas grandes.
O aplicativo não responde no navegador.	O contêiner está parado, ou o aplicativo tem um problema.	1. Digite docker ps -a para ver se o contêiner está em execução. 2. Digite docker logs luc-analytics para ler as mensagens do aplicativo. 3. Se o contêiner estiver parado, digite docker start luc-analytics.
O aplicativo não responde depois que você reinicia o Windows.	O contêiner não inicia automaticamente.	Inicie o Docker Desktop. Depois, digite docker start luc-analytics.

Chave de acesso

AVISO: Não dê o link com a chave de acesso a outras pessoas. Uma pessoa com o link pode usar o aplicativo e a sua credencial da AWS.

Problema	Causa	Ação
O navegador mostra "Chave de acesso necessária".	O navegador não tem a chave de acesso.	1. Digite docker exec luc-analytics cat /data/state/access-key. 2. Abra http://localhost:8000/?access_key=<key>. Use a chave da etapa 1.
O navegador mostra "Chave de acesso indisponível". A página diz que o servidor "não consegue mais lê-la (o arquivo da chave pode ter sido excluído)".	O arquivo da chave no volume não está lá, ou o servidor não consegue lê-lo.	Reinicie o contêiner com docker restart luc-analytics. O aplicativo cria uma nova chave e escreve um novo link no log. Abra o novo link.

Credencial AWS (Verificar credenciais)

Você encontra estas mensagens em Configurações > Credenciais, depois de pressionar Verificar credenciais. Esta verificação é gratuita. Para as configurações, consulte 06-settings.md.

Problema	Causa	Ação
"A AWS rejeitou esta credencial ({{code}}): o ID da chave de acesso ou o segredo está errado, ou a chave não está ativa. Próximo passo: informe os dois novamente e verifique as credenciais outra vez."	O ID da chave de acesso AWS ou a chave de acesso secreta AWS está errado, ou a chave da AWS não está ativa.	Digite os dois valores novamente. Pressione Verificar credenciais.
"Nenhuma credencial da AWS foi informada ou salva. Próximo passo: informe o ID da chave de acesso e o segredo e verifique as credenciais."	Não há credencial da AWS.	Digite o ID da chave de acesso AWS e a chave de acesso secreta AWS. Pressione Verificar credenciais.
"Existe uma credencial salva, mas ela não pôde ser lida com a chave ativa do cofre de segredos. Próximo passo: informe novamente o ID da chave de acesso e o segredo e salve."	A chave do armazenamento criptografado mudou, ou o armazenamento está danificado.	Digite novamente o ID da chave de acesso AWS e a chave de acesso secreta AWS. Pressione Salvar.
"Não foi possível alcançar o AWS STS (rede ou endpoint). Isso não diz nada sobre a credencial. Próximo passo: tente novamente."	Não há conexão de rede, ou a AWS não responde.	Verifique se o laptop tem conexão com a internet. Pressione Verificar credenciais novamente.
"O AWS STS não respondeu a tempo. Isso não diz nada sobre a credencial. Próximo passo: tente novamente."	A AWS não respondeu dentro do tempo permitido.	Pressione Verificar credenciais novamente.
"Informe o ID da chave de acesso e a chave de acesso secreta, ou nenhum dos dois."	Você digitou somente um dos dois valores.	Digite os dois valores, ou limpe os dois campos.
"Verifique as credenciais primeiro. Um par de chaves que falhou na verificação nunca é salvo."	Você pressionou Salvar antes de uma verificação com sucesso.	Pressione Verificar credenciais. Quando a verificação tiver sucesso, pressione Salvar.

Conexão com um conjunto de dados (Testar conexão)

Você encontra estas mensagens para uma fonte de dados depois de pressionar Testar conexão.

AVISO: Testar conexão faz uma solicitação ao bucket do WRI. A AWS envia a cobrança desta solicitação para a sua conta da AWS.

Problema	Causa	Ação
"Sua credencial está correta. A configuração de "Solicitante paga" deste conjunto de dados está desativada, portanto o aplicativo está se recusando a fazer uma solicitação cobrada. Ative "Solicitante paga" acima."	Solicitante paga está desativado. Sem ele, o aplicativo não faz uma solicitação que custa dinheiro.	Ative Solicitante paga. Pressione Testar conexão novamente.
"A AWS rejeitou esta credencial para este conjunto de dados. A chave pode ter sido revogada, pode estar errada ou pode não ter permissão. "Solicitante paga" já está ativado, então este é o problema da credencial."	A credencial da AWS não está correta, ou não tem permissão.	Pressione Verificar credenciais. Se a verificação falhar, corrija a credencial da AWS.
"A AWS rejeitou esta credencial ({{code}}) — é a credencial, não o local. Próximo passo: pressione Verificar credenciais."	A AWS recusou a credencial.	Pressione Verificar credenciais.
"Nenhuma credencial da AWS está resolvida para este conjunto de dados. Adicione um ID de chave de acesso e uma chave secreta acima, depois salve e teste novamente."	Não há credencial da AWS.	Digite e salve a credencial da AWS. Pressione Testar conexão novamente.
"Existe uma credencial salva, mas ela não pôde ser lida com a chave ativa do cofre de segredos. Informe novamente o ID da chave de acesso e o segredo acima e salve."	O aplicativo não consegue descriptografar a credencial salva.	Digite a credencial da AWS novamente e salve-a.
"AccessDenied ({{code}}): a chave é válida, mas não tem permissão para ler este bucket, ou o bucket recusou a solicitação de pagamento pelo solicitante. Próximo passo: verifique as credenciais e depois a verificação por CLI abaixo."	A chave da AWS está correta, mas não tem permissão para ler o bucket.	1. Pressione Verificar credenciais. 2. Faça a verificação em Verifique você mesmo no seu próprio terminal. 3. Dê à chave da AWS a permissão para ler o bucket.
"Não foi possível alcançar o conjunto de dados (falha de rede ou endpoint). Isso não está relacionado à sua credencial nem à configuração de "Solicitante paga"."	Não há conexão de rede, ou o endpoint não responde.	Verifique se o laptop tem conexão com a internet. Pressione Testar conexão novamente.
"O teste de conexão expirou. O conjunto de dados não respondeu dentro do tempo permitido — provavelmente é um endpoint lento ou inacessível, não sua credencial nem a configuração de "Solicitante paga"."	O endpoint não respondeu dentro do tempo permitido.	Pressione Testar conexão novamente mais tarde.
"A AWS respondeu {{code}} para {{uri}}: não há nada nesse local. Próximo passo: pressione Usar caminho do manifesto ($, uma solicitação cobrada)."	O caminho S3 do conjunto de dados está errado ou é antigo.	Pressione Usar caminho do manifesto. Isso faz uma solicitação que custa dinheiro.
"Não existem objetos em {{uri}}: o bucket respondeu, mas nada está armazenado nesse prefixo. Próximo passo: pressione Usar caminho do manifesto ($, uma solicitação cobrada)."	Não há arquivos nesse caminho S3.	Pressione Usar caminho do manifesto. Isso faz uma solicitação que custa dinheiro.
"O local está acessível e autorizado, mas não contém um armazenamento Zarr legível."	O caminho S3 não contém o conjunto de dados.	Corrija o caminho S3 do conjunto de dados.
"O bucket responde a partir de {{bucketRegion}}, não de {{region}} — o bucket do WRI está em us-east-1. Próximo passo: corrija datasets.upstream.region (ou regions) no config.yaml."	A região AWS na configuração está errada.	1. Altere datasets.upstream.region em /data/config.yaml para us-east-1. 2. Reinicie o contêiner.

Credenciais dos provedores de mapa base

Você encontra estas mensagens nos cartões de Planet, Google Maps e Copernicus (CDSE) em Configurações > Credenciais, depois de pressionar Testar conexão. A mensagem começa com "Falha na conexão:".

Problema	Causa	Ação
"O provedor rejeitou esta credencial. Verifique o valor, ou se ela ainda tem permissão."	A credencial está errada, ou não tem permissão.	Digite o valor correto. Pressione Testar conexão novamente.
"Não foi possível alcançar o provedor (falha de rede ou de endpoint). Isso não está relacionado à sua credencial."	Não há conexão de rede, ou o provedor não responde.	Verifique se o laptop tem conexão com a internet. Pressione Testar conexão novamente.
"O provedor não respondeu dentro do tempo permitido. Provavelmente é um endpoint lento ou inacessível, não a sua credencial."	O provedor não respondeu dentro do tempo permitido.	Pressione Testar conexão novamente mais tarde.
"O provedor está mal configurado no servidor, por isso a credencial não pôde ser testada."	A configuração do servidor para este provedor não está correta.	Fale com a pessoa que instalou o aplicativo.
"Teste a conexão primeiro. Uma conexão com falha nunca é salva."	Você pressionou Salvar antes de um teste com sucesso.	Pressione Testar conexão. Quando o teste tiver sucesso, pressione Salvar.

Enviar uma lista

Para mais dados sobre listas, consulte 02-lists.md.

Problema	Causa	Ação
"Os envios estão desativados"	ingest.upload_enabled não é true na configuração. Uma instalação que você atualizou mantém o arquivo de configuração antigo.	1. Verifique se a chave de acesso protege o aplicativo. 2. Defina ingest.upload_enabled: true em /data/config.yaml. 3. Reinicie o contêiner.
"Tipo de arquivo não compatível"	O aplicativo não consegue ler este tipo de arquivo. O aplicativo não aceita arquivos KMZ (.kmz).	Use um arquivo CSV, Excel (.xlsx), GeoJSON, KML (.kml) ou shapefile compactado (.zip). Para usar um arquivo KMZ, extraia o arquivo KML dele.
"Arquivo muito grande" ou "Locais demais"	O arquivo é maior que o limite.	Divida o arquivo em arquivos menores. Envie cada arquivo como uma lista.
"Planilha larga demais"	Uma linha da planilha tem colunas demais.	Remova as colunas de que você não precisa. Envie novamente.
"Nenhum local encontrado"	O arquivo não tem linhas.	Verifique se o arquivo tem linhas.
"Não encontramos as colunas dos locais"	O aplicativo não consegue encontrar as colunas com as coordenadas.	Use Alterar o mapeamento de campos para selecionar as colunas.
"Essa coluna não está no seu arquivo"	As relações das colunas usam uma coluna que não está no arquivo.	Corrija as relações das colunas.
"Nenhum local válido"	As coordenadas não estão corretas.	Corrija as coordenadas.
"Não foi possível abrir o arquivo compactado" ou "Não foi possível ler o KML/KMZ"	O arquivo está danificado.	Exporte o arquivo novamente do programa dele. Envie-o novamente.
"Os locais precisam de um tamanho"	O arquivo tem pontos sem tamanho.	Informe um tamanho (uma área ou um raio) para os pontos.
"Escolha uma unidade"	O tamanho não tem unidade.	Selecione Área ou Raio.
"Qual projeção cartográfica?" ou "Projeção não reconhecida"	As coordenadas não estão em latitude e longitude WGS 84.	Selecione a projeção do arquivo.
"Conjuntos de dados indisponíveis"	Os conjuntos de dados não estão disponíveis neste momento.	Tente novamente mais tarde.
"Envio interrompido", "Envio expirado" ou "Falha ao confirmar"	O envio não terminou.	Envie o arquivo novamente.
"Não foi possível acessar o servidor"	O navegador não consegue se conectar ao aplicativo.	Verifique se o contêiner está em execução (docker ps -a).

Exportações

Para mais dados sobre exportações, consulte 05-exports.md.

Problema	Causa	Ação
Você não consegue pressionar Exportar ou ⬇ Baixar CSV. A dica mostra "A exportação CSV ficará disponível quando a análise desta lista for concluída."	A análise da lista não está concluída.	Aguarde até que a análise da lista esteja concluída. Uma lista com o rótulo Incompleta depois de Parar e confirmar não fica concluída. Para uma lista assim, exporte cada local concluído.
"A exportação CSV ficará disponível quando a análise desta lista for concluída."	O servidor recusou uma exportação da lista, porque a análise da lista não está concluída.	Aguarde até que a análise da lista esteja concluída. Para uma lista com o rótulo Incompleta, exporte cada local concluído.
"Exportação indisponível — nenhum local desta lista foi analisado ainda, então não há nada para exportar."	Nenhum local da lista está concluído.	Aguarde até que a análise esteja concluída.
"Exportação indisponível — a análise deste local ainda não foi concluída. A exportação ficará disponível quando todas as análises dele estiverem concluídas."	Uma análise deste local não está concluída.	Aguarde até que cada análise do local esteja concluída.
"O CSV foi baixado, mas o arquivo complementar "Dados usados" (as datas dos conjuntos de dados de origem) não pôde ser baixado."	O segundo arquivo não foi baixado.	Pressione o botão novamente.
"Exportação de PDF indisponível — nenhum local foi analisado para esta lista ainda."	Nenhum local da lista está concluído.	Aguarde até que a análise esteja concluída.
"Exportação de PDF indisponível — o mapa e as camadas de análise ainda não estão prontos para captura. Aguarde e tente novamente."	O mapa não está totalmente desenhado.	Aguarde até que o mapa esteja totalmente desenhado. Pressione Baixar PDF novamente.
"Exportação de PDF indisponível — ainda aguardando: {{items}}. Aguarde e tente novamente."	O mapa aguarda os itens da mensagem, por exemplo os blocos do mapa base.	Aguarde. Pressione Baixar PDF novamente. Se os blocos não carregarem, consulte "Mapas" abaixo.
"Falha na exportação do PDF — a visualização do mapa não pôde ser capturada. Tente novamente quando o mapa terminar de desenhar."	O aplicativo não criou uma imagem do mapa.	Aguarde até que o mapa esteja totalmente desenhado. Pressione Baixar PDF novamente.
"Falha na exportação do PDF — o relatório não pôde ser montado." ou "Falha na exportação do PDF — a solicitação de exportação não foi concluída. Tente novamente."	O aplicativo não criou o arquivo PDF.	Pressione Baixar PDF novamente. Se o problema continuar, leia a linha que começa com "Causa:".
"Não foi possível carregar as fontes de dados. Consulte DATA-ATTRIBUTION.md no repositório do projeto."	O aplicativo não obteve o texto de atribuição.	Leia o arquivo DATA-ATTRIBUTION.md. Abra Fontes de dados e licenças novamente mais tarde.

Mapas

Para mais dados sobre mapas, consulte 04-maps.md.

Problema	Causa	Ação
"Não foi possível exibir o mapa"	Ocorreu um erro no mapa. As outras partes da página continuam a funcionar.	Tente novamente, ou carregue a página novamente.
"Falha ao carregar os dados da grade do mapa."	O aplicativo não obteve as camadas de análise para o mapa.	Carregue a página novamente.
"Foram encontrados locais, mas os limites do mapa são inválidos e não podem ser exibidos."	Os limites dos locais não estão corretos.	Examine as coordenadas dos locais.
"A comparação não está disponível: este mapa base não tem datas para escolher."	O mapa base não tem datas.	Selecione outro mapa base.
"As células nativas são menores que um pixel de tela neste zoom. Aproxime o zoom para a resolução máxima."	Você afastou demais o zoom para a resolução máxima.	Aproxime o zoom.
"Este arquivo não é JSON válido." ou "Este não é um arquivo de modelo da legenda do mapa."	Você selecionou um arquivo que não é um modelo da legenda do mapa.	Selecione um arquivo .mpky que você salvou a partir da legenda do mapa.

Listas e resultados

Problema	Causa	Ação
"Não foi possível carregar as listas" ou "Não foi possível carregar os resultados"	O aplicativo não consegue ler o banco de dados de resultados.	Carregue a página novamente. Se o problema continuar, leia a saída de docker logs luc-analytics.
"Lista não encontrada"	A lista não existe. Possivelmente, alguém a excluiu.	Vá para a página de listas e selecione uma lista que existe.
"Esta execução não terminou: {{message}}"	Uma nova execução da lista parou.	Leia a mensagem. Corrija a causa. Depois, pressione Executar novamente com dados atuais.
"Esta atualização não terminou: {{message}}. Os resultados anteriores são mantidos."	Uma atualização da lista parou. O aplicativo mantém os resultados anteriores.	Leia a mensagem. Inicie a atualização novamente.
"Algo deu errado"	A página teve um erro.	Tente novamente, ou carregue a página novamente.