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 da pesquisa de texto completo do Neptune
<a name="streams-consumer-troubleshooting"></a>

**nota**  
Se você ativou o [controle de acesso refinado](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/fgac.html) em seu OpenSearch cluster, também precisará [habilitar a autenticação do IAM](iam-auth-enable.md) em seu banco de dados Neptune.

Para diagnosticar problemas com a replicação de Neptune para OpenSearch, consulte os registros CloudWatch da função Lambda do seu poller. Esses registros fornecem detalhes sobre o número de registros lidos do stream e o número de registros replicados com sucesso. OpenSearch

Também é possível alterar o nível de LOGGING para a função do Lambda ao alterar a variável de ambiente `LoggingLevel`.

**nota**  
Com `LoggingLevel` definido como`DEBUG`, você pode visualizar detalhes adicionais, como registros de stream eliminados e o motivo pelo qual cada um foi descartado, enquanto replica dados StreamPoller de Netuno para. OpenSearch Isso poderá ser útil se você descobrir que faltam registros.

O aplicativo para consumidores do Neptune Streams publica duas métricas que também podem ajudar você a CloudWatch diagnosticar problemas:
+ `StreamRecordsProcessed`: o número de registros processados pela aplicação por unidade de tempo. Útil no monitoramento da taxa de execução do aplicativo.
+ `StreamLagTime`: a diferença de tempo em milissegundos entre a hora atual e a hora de confirmação de um registro de fluxo que está sendo processado. Esta métrica mostra o atraso do aplicativo de consumidor.

Além disso, todas as métricas relacionadas ao processo de replicação são expostas em um painel CloudWatch com o mesmo nome `ApplicationName` fornecido quando você instanciou o aplicativo usando o modelo. CloudWatch 

Você também pode optar por criar um CloudWatch alarme que é acionado sempre que a pesquisa falhar mais de duas vezes seguidas. Faça isso ao definir o campo `CreateCloudWatchAlarm` como `true` ao instanciar o aplicativo. Depois especifique os endereços de e-mail que deseja notificar quando o alarme for acionado.

## Solução de problemas de um processo que falha ao ler registros do fluxo
<a name="streams-consumer-troubleshooting-reads"></a>

Se um processo falhar ao ler registros do fluxo, certifique-se de que:
+ O fluxo esteja habilitado no cluster.
+ O endpoint do fluxo do Neptune esteja no formato correto:
  + Para Gremlin ou openCypher: `https://your cluster endpoint:your cluster port/propertygraph/stream` ou o alias, `https://your cluster endpoint:your cluster port/pg/stream`.
  + Para o SPARQL: `https://your cluster endpoint:your cluster port/sparql/stream`.

  
+ O endpoint do DynamoDB esteja configurado para a VPC.
+ O monitoramento do endpoint está configurado para as sub-redes da VPC.

## Solução de problemas de um processo que falha ao gravar dados em OpenSearch
<a name="streams-consumer-troubleshooting-writes"></a>

Se um processo falhar ao gravar registros em OpenSearch, verifique se você tem o seguinte:
+ Sua versão do Elasticsearch seja 7.1 ou posterior, ou Opensearch 2.3 e posterior.
+ OpenSearch pode ser acessado a partir da função poller Lambda em sua VPC.
+ A política de segurança anexada OpenSearch permite HTTP/HTTPS solicitações de entrada.

## Corrigindo out-of-sync problemas entre o Neptune OpenSearch e em uma configuração de replicação existente
<a name="streams-consumer-troubleshooting-sync-issues"></a>

Você pode usar as etapas abaixo para sincronizar o banco de dados OpenSearch e o domínio do Neptune com os dados mais recentes em caso out-of-sync de problemas entre eles resultantes de `ExpiredStreamException` uma corrupção de dados.

Observe que essa abordagem exclui todos os dados no OpenSearch domínio e os sincroniza novamente do estado atual do banco de dados Neptune, portanto, nenhum dado precisa ser recarregado no banco de dados Neptune.

1. Desabilite o processo de replicação conforme descrito em [Disabling (pausing) the stream poller process](full-text-search-pause-poller.md).

1. Exclua o índice Neptune no domínio usando OpenSearch o seguinte comando:

   ```
   curl -X DELETE "(your OpenSearch endpoint)/amazon_neptune"
   ```

1. Criar um clone do banco de dados (consulte [Database Cloning in Neptune](manage-console-cloning.md)).

1. Obtenha o `eventID` mais recente dos fluxos no banco de dados clonado executando um comando desse tipo no endpoint da API de fluxos (consulte [Calling the Neptune Streams REST API](streams-using-api-call.md) para obter mais informações):

   ```
   curl "https://(your neptune endpoint):(port)/(propertygraph or sparql)/stream?iteratorType=LATEST"
   ```

   Anote os valores nos campos `commitNum` e `opNum` no objeto `lastEventId` na resposta.

1. Use a [export-neptune-to-elasticsearch](https://github.com/awslabs/amazon-neptune-tools/tree/master/export-neptune-to-elasticsearch)ferramenta no github para realizar uma sincronização única do banco de dados clonado para o domínio. OpenSearch

1. Acesse a tabela do DynamoDB para ver a pilha de replicação. O nome da tabela será o **nome do aplicativo** que você especificou no CloudFormation modelo (o padrão é`NeptuneStream`) com um `-LeaseTable` sufixo. Em outras palavras, o nome padrão da tabela é `NeptuneStream-LeaseTable`.

   É possível examinar as linhas da tabela com a verificação porque só deve haver uma linha na tabela. Faça as seguintes alterações usando os valores `commitNum` e `opNum` que você registrou acima:
   + Altere o valor do campo `checkpoint` na tabela para o valor que você anotou para `commitNum`.
   + Altere o valor do campo `checkpointSubSequenceNumber` na tabela para o valor que você anotou para `opNum`.

1. Reabilite o processo de replicação conforme descrito em [Re-enabling the stream poller process](full-text-search-re-enable-poller.md).

1. Exclua o banco de dados clonado e a CloudFormation pilha criada para a `export-neptune-to-elasticsearch` ferramenta.