Saltar al contenido principal

Index Diagnostic

Index Diagnostic es una ventana modal para diagnosticar la indexación del sistema. Muestra hasta qué punto los datos del proyecto están indexados de forma completa y correcta en los motores de búsqueda, y ayuda a encontrar rápidamente la causa cuando la búsqueda no devuelve todos los registros o responde con retraso.

La ventana se abre al hacer clic en el ícono de índice de la barra superior de la aplicación (el encabezado). Los íconos de la barra superior se describen en la sección elementos básicos de la interfaz.

Ventana de diagnóstico del índice: «Table Health» con la cola de indexación y las tablas «Data Consistency», «Materialized Views», «Elasticsearch» y «Vector Data Base Coverage»

info

Es normal que «Expected» y «In search» no coincidan durante una reindexación o justo después de editar conjuntos de atributos: los datos se cargarán en la siguiente indexación programada. Si la diferencia persiste después de esa indexación, hay un problema.

Table Health​

El bloque superior muestra el estado general de la indexación de todas las tablas del sistema.

  • Total: N/N ✓: cuántas tablas del total están en un estado correcto.
  • Index-data Queue: estado de la cola de tareas de indexación de datos:
    • Active: tareas que se están ejecutando en este momento.
    • Waiting: tareas a la espera de ejecutarse.
    • Failed: tareas que terminaron con un error.
    • Delayed: tareas aplazadas.
  • Failed Background Jobs: número de tareas en segundo plano que terminaron con un error. Puede expandir el bloque para ver los detalles.
  • Delayed background jobs: número de tareas en segundo plano aplazadas. También se expande para ver los detalles.

Debajo hay una tabla con el estado de cada entidad y las siguientes columnas:

  • Table: nombre de la tabla (products, pages, blocks, admins, discounts, etc.).
  • Expected: cuántos registros debería haber en el índice.
  • Indexed: cuántos registros se indexaron realmente.
  • Not in index: cuántos registros faltan en el índice.
  • Orphans: registros huérfanos, es decir, que están en el índice pero ya no existen en los datos de origen.
  • Skipped: registros omitidos durante la indexación (por ejemplo, 3 of 4 entities indica que se omitieron para una parte de las entidades; puede expandir la fila).
  • Last Indexed: cuándo se indexó la tabla por última vez (o Never Indexed si nunca se indexó).
  • Status: estado final de la fila. ✓ significa que la tabla está en orden.

Data Consistency​

El bloque Data Consistency compara, para cada entidad, el número de registros en los distintos almacenamientos. Así puede ver en qué punto exacto los datos no coinciden.

Columnas:

  • Entity: la entidad (products, pages, blocks).
  • Catalog: número de registros en el catálogo principal (la fuente de datos).
  • Overview Table (views): número de registros en la tabla de resumen (vistas materializadas).
  • Search Engine (Elastic): número de registros en Elasticsearch.
  • Smart Search (Vector DB): número de registros en la base de datos vectorial de la búsqueda inteligente (un guion — indica que la entidad no participa en la búsqueda inteligente).

Si los valores de una fila no coinciden, las diferencias se resaltan en color para indicar en qué almacenamiento están incompletos los datos.

Materialized Views​

El bloque Materialized Views muestra las vistas materializadas (tablas de resumen) y el número de filas de cada una: products_view, pages_view, blocks_view, etc.

info

En los planes con Elasticsearch, la actualización de vistas (view refresh) está desactivada, por lo que los datos de este bloque pueden no reflejar el estado real.

Elasticsearch​

El bloque Elasticsearch enumera los índices de búsqueda y el número de documentos de cada uno (products_v1, pages_v1, blocks_v1, etc.). Con él puede comprobar cuántos documentos almacena realmente el motor de búsqueda para cada entidad.

Vector Data Base Coverage​

El bloque Vector Data Base Coverage muestra qué parte de los datos cubre la base de datos vectorial de la búsqueda inteligente. Por ejemplo, 1/1 (100%) significa que todos los registros aptos están indexados en la base de datos vectorial. Un porcentaje bajo indica que una parte de los datos todavía no ha llegado a la búsqueda inteligente.

Refresh​

El botón Refresh, en la esquina superior derecha de la ventana, actualiza todos los indicadores del diagnóstico para mostrar el estado actual de la indexación sin recargar la página.

Última actualización en