Solucionar problemas do Indexador da Knowledge Base

Última atualização em 08/10/2026

Resolva problemas comuns de URL, autenticação, escopo de rastreamento e performance.

Os logs do aplicativo são a principal superfície de diagnóstico no Knowledge Base Indexer. Use-os com os controles de rastreamento para identificar URLs inválidas, falhas de autenticação, escopo excessivo de rastreamento, longos tempos de processamento e alto uso de recursos.

Revisar os logs

Os logs exibem:

  • URLs sendo rastreadas.
  • Páginas descobertas e processadas.
  • Informações de progresso.
  • Erros e avisos.
  • Status de conclusão.

Revise os logs primeiro quando um rastreamento relatar um erro ou não se comportar como esperado.

Resolver problemas de autenticação em sites protegidos

O conteúdo de site protegido pode exigir uma URL de autenticação.

  1. Confirme se uma URL de autenticação está configurada.
  2. Execute o rastreamento no modo de descoberta.
  3. Revise os logs quanto a erros ou avisos de autenticação.

Sites públicos não exigem uma URL de autenticação.

Resolver problemas de autenticação de sites protegidos

O conteúdo de site protegido pode exigir uma URL de autenticação.

  1. Confirme se uma URL de autenticação está configurada.
  2. Execute o rastreamento no Modo de descoberta.
  3. Revise os logs quanto a erros ou avisos de autenticação.

Sites públicos não exigem uma URL de autenticação.

Resolver erros de URL inválida

O Indexer aceita apenas URLs HTTPS.

Verifique se:

  • Cada URL começa com https://.
  • Cada URL aparece em uma linha separada.
  • A URL não é um endereço de rede local.
  • A URL não é um endereço de loopback.
  • A URL não usa um endereço IP restrito.

Endereços de rede local são bloqueados como medida de segurança. Cada URL inválida gera um erro nos logs.

Corrija a URL e inicie o rastreamento novamente.

Resolver problemas de autenticação da Knowledge Base

O Modo de upload requer autenticação para Knowledge Base no Acrobat.

Se a autenticação falhar:

  1. Confirme se suas credenciais do Knowledge Base são válidas.
  2. Limpe o Modo de descoberta.
  3. Selecione o ícone de atualização ao lado do seletor de coleções.
  4. Conclua o processo de autenticação na janela do navegador.

Se o token de sessão expirar durante uma operação, o Indexador tenta atualizá-lo. Os tokens de autenticação são manipulados com segurança e não são armazenados permanentemente.

Selecione Logout para invalidar o token de sessão atual.

Resolver problemas de autenticação de site protegido

O conteúdo de site protegido pode exigir uma URL de autenticação.

  1. Confirme se uma URL de autenticação está configurada.
  2. Execute o rastreamento no modo de descoberta.
  3. Revise os logs quanto a erros ou avisos de autenticação.

Sites públicos não requerem uma URL de autenticação.

A coleção de destino não está listada

A lista de coleções inclui apenas coleções onde você tem acesso de escrita.

  1. Limpe o Modo de descoberta para ativar o Modo de upload.
  2. Selecione o ícone de atualização ao lado do seletor de coleções.
  3. Conclua a autenticação quando solicitado.
  4. Confirme se você tem acesso de gravação à coleção de destino.
  5. Atualize a lista de coleções quando necessário.

O rastreamento inclui muitas páginas

As configurações de rastreamento profundo podem fazer com que o Indexador siga mais links do que o desejado.

Para reduzir o escopo do rastreamento:

  • Reduzir profundidade de rastreamento.
  • Reduzir limite de páginas.
  • Use um URL inicial para uma seção específica do site em vez de um domínio inteiro.
  • Teste a configuração revisada no Modo de descoberta.

O rastreamento demora muito

Limites de página grandes e profundidades de rastreamento maiores podem aumentar o tempo de processamento.

Tente o seguinte:

  • Reduza o limite de páginas.
  • Reduza a profundidade de rastreamento.
  • Direcione para uma seção menor do site.
  • Revise as informações de progresso nos logs.

O computador usa muitos recursos

Quantidades maiores de workers aumentam o processamento paralelo e o uso de recursos.

  1. Selecione Parar para finalizar a operação atual.
  2. Diminua o número de trabalhadores.
  3. Inicie o rastreamento novamente.

A contagem padrão de trabalhadores é 4. A faixa recomendada para a maioria dos sistemas é 4–8, dependendo do número de núcleos do processador.

Práticas recomendadas

  • Comece com uma profundidade de rastreamento superficial e um limite pequeno de páginas.
  • Teste a configuração no Modo de descoberta antes de fazer upload do conteúdo.
  • Revise avisos e erros nos logs.
  • Reduza a profundidade de rastreamento ou o limite de páginas quando o escopo de rastreamento for muito amplo.
  • Reduza o número de trabalhadores quando o uso de recursos for alto.
  • Evite rastreamento excessivo do mesmo site em um período curto.

Informações importantes

  • Selecione Parar para encerrar a operação atual.
  • URLs inválidas geram erros nos logs.
  • Números mais altos de workers podem melhorar a velocidade de processamento, mas usam mais recursos do sistema.
  • Limites de página altos podem aumentar o tempo de processamento.
  • Profundidades de rastreamento profundas podem incluir mais páginas do que o pretendido.