Diagnóstico de Índice
Diagnóstico de Índice — é uma janela modal de diagnóstico da indexação do sistema. Ela mostra quão completa e correta está a indexação dos dados do projeto nos motores de busca, e ajuda a identificar rapidamente a causa se a busca não retornar todos os registros ou funcionar com atraso.
A janela se abre ao clicar no ícone de índice na barra superior do programa (cabeçalho). Mais detalhes sobre os ícones da barra superior estão na seção elementos principais da interface.
A discrepância entre "Esperado" e "Na busca" é normal durante a reindexação ou logo após a edição dos conjuntos de atributos: a tarefa programada (cron) puxará os dados na próxima indexação. No entanto, se a diferença persistir mesmo após a próxima indexação, isso é um sinal de problema.
Saúde da Tabela
O bloco superior reflete o estado geral da indexação em todas as tabelas do sistema.
- Total: N/N ✓ — quantas tabelas do total estão em estado correto.
- Fila de Indexação de Dados — estado da fila de tarefas de indexação de dados:
- Ativo — tarefas que estão sendo executadas agora.
- Aguardando — tarefas que estão aguardando execução.
- Falhou — tarefas que terminaram com erro.
- Atrasadas — tarefas adiadas.
- Tarefas de Fundo com Falha — contador de tarefas de fundo que falharam. O bloco pode ser expandido para ver os detalhes.
- Tarefas de Fundo Atrasadas — contador de tarefas de fundo atrasadas, que também pode ser expandido para visualizar detalhes.
Abaixo está uma tabela de estado para cada entidade com as seguintes colunas:
- Tabela — nome da tabela (produtos, páginas, blocos, administradores, descontos, etc.).
- Esperado — quantos registros deveriam estar no índice.
- Indexado — quantos registros foram realmente indexados.
- Não no índice — quantos registros est ão ausentes no índice.
- Órfãos — registros "órfãos": presentes no índice, mas ausentes nos dados originais.
- Ignorados — registros que foram pulados durante a indexação (por exemplo,
3 de 4 entidades— pulado para parte das entidades; a linha pode ser expandida). - Última Indexação — quando a tabela foi indexada pela última vez (ou
Nunca Indexada, se não foi indexada). - Status — status final da linha: ✓ significa que a tabela está em ordem.
Consistência de Dados
O bloco Consistência de Dados mostra a consistência do número de registros entre diferentes repositórios para cada entidade. Isso ajuda a ver onde os dados estão divergindo.
Colunas:
- Entidade — entidade (produtos, páginas, blocos).
- Catálogo — número de registros no catálogo principal (fonte de dados).
- Tabela de Visão (views) — número na tabela de visão (visões materializadas).
- Motor de Busca (Elastic) — número de registros no Elasticsearch.
- Busca Inteligente (Vector DB) — número de registros na base de dados vetorial de busca inteligente (traço
—significa que a entidade não participa da busca inteligente).
Se os valores na linha não coincidirem, as discrepâncias são destacadas em cores — isso indica em qual repositório os dados estão incompletos.
Visões Materializadas
O bloco Visões Materializadas mostra as visões materializadas (tabelas de visão) e o número de linhas em cada uma delas: products_view, pages_view, blocks_view, etc.
Nos planos com Elasticsearch, a atualização das visões (view refresh) está desativada — os dados neste bloco podem estar desatualizados em relação ao estado real.
Elasticsearch
O bloco Elasticsearch lista os índices de busca e o número de documentos em cada um deles (products_v1, pages_v1, blocks_v1, etc.). A partir dele, é possível verificar quantos documentos o motor de busca realmente armazena para cada entidade.
Cobertura da Base de Dados Vetorial
O bloco Cobertura da Base de Dados Vetorial reflete a cobertura de dados na base de dados vetorial de busca inteligente — por exemplo, 1/1 (100%) significa que todos os registros adequados foram indexados na base de dados vetorial. Uma baixa porcentagem de cobertura indica que parte dos dados ainda não foi incluída na busca inteligente.
Atualizar
O botão Atualizar no canto superior direito da janela atualiza todos os indicadores de diagnóstico para obter o estado atual da indexação sem recarregar a página.