Aller au contenu principal

Index Diagnostic

Index Diagnostic est une fenêtre modale de diagnostic de l'indexation du système. Elle indique dans quelle mesure les données du projet sont indexées de façon complète et correcte dans les moteurs de recherche. Elle vous aide aussi à trouver rapidement la cause lorsque la recherche ne renvoie pas tous les enregistrements ou répond avec du retard.

Pour ouvrir la fenêtre, cliquez sur l'icône d'index dans la barre supérieure de l'application (l'en-tête). Les icônes de la barre supérieure sont décrites dans la section Éléments principaux de l'interface.

Fenêtre de diagnostic de l'index : « Table Health » avec la file d'indexation, tableaux « Data Consistency », « Materialized Views », « Elasticsearch » et « Vector Data Base Coverage »

info

Un écart entre « Expected » et « In search » est normal pendant une réindexation ou juste après la modification d'ensembles d'attributs. Les données seront prises en compte lors de la prochaine indexation planifiée. Si l'écart persiste après l'indexation suivante, cela signale un problème.

Table Health​

Le bloc supérieur présente l'état général de l'indexation pour l'ensemble des tables du système.

  • Total: N/N ✓ : nombre de tables, sur le total, qui sont dans un état correct.
  • Index-data Queue : état de la file des tâches d'indexation des données :
    • Active : tâches en cours d'exécution.
    • Waiting : tâches en attente d'exécution.
    • Failed : tâches terminées en erreur.
    • Delayed : tâches différées.
  • Failed Background Jobs : nombre de tâches en arrière-plan terminées en erreur. Vous pouvez déplier le bloc pour afficher le détail.
  • Delayed background jobs : nombre de tâches en arrière-plan différées. Ce bloc se déplie lui aussi pour afficher le détail.

En dessous, un tableau présente l'état de chaque entité, avec les colonnes suivantes :

  • Table : nom de la table (products, pages, blocks, admins, discounts, etc.).
  • Expected : nombre d'enregistrements qui devraient figurer dans l'index.
  • Indexed : nombre d'enregistrements réellement indexés.
  • Not in index : nombre d'enregistrements absents de l'index.
  • Orphans : enregistrements « orphelins », présents dans l'index mais qui n'existent plus dans les données sources.
  • Skipped : enregistrements ignorés lors de l'indexation (par exemple, 3 of 4 entities signifie qu'ils ont été ignorés pour une partie des entités ; la ligne peut être dépliée).
  • Last Indexed : moment de la dernière indexation de la table (ou Never Indexed si elle n'a jamais été indexée).
  • Status : statut final de la ligne. ✓ signifie que la table ne présente aucun problème.

Data Consistency​

Le bloc Data Consistency compare, pour chaque entité, le nombre d'enregistrements dans les différents stockages. Il permet de voir précisément où les données divergent.

Colonnes :

  • Entity : entité (products, pages, blocks).
  • Catalog : nombre d'enregistrements dans le catalogue principal (la source des données).
  • Overview Table (views) : nombre d'enregistrements dans la table d'aperçu (vues matérialisées).
  • Search Engine (Elastic) : nombre d'enregistrements dans Elasticsearch.
  • Smart Search (Vector DB) : nombre d'enregistrements dans la base de données vectorielle de la recherche intelligente (un tiret — signifie que l'entité ne participe pas à la recherche intelligente).

Si les valeurs d'une ligne ne concordent pas, les écarts sont mis en couleur, ce qui indique quel stockage contient des données incomplètes.

Materialized Views​

Le bloc Materialized Views affiche les vues matérialisées (tables d'aperçu) et le nombre de lignes de chacune : products_view, pages_view, blocks_view, etc.

info

Sur les forfaits avec Elasticsearch, l'actualisation des vues (view refresh) est désactivée. Les données de ce bloc peuvent donc être en retard sur l'état réel.

Elasticsearch​

Le bloc Elasticsearch liste les index de recherche et le nombre de documents de chacun (products_v1, pages_v1, blocks_v1, etc.). Il permet de vérifier combien de documents le moteur de recherche stocke réellement pour chaque entité.

Vector Data Base Coverage​

Le bloc Vector Data Base Coverage indique la couverture des données par la base vectorielle de la recherche intelligente. Par exemple, 1/1 (100%) signifie que tous les enregistrements concernés sont indexés dans la base vectorielle. Un faible taux de couverture indique qu'une partie des données n'est pas encore disponible dans la recherche intelligente.

Refresh​

Le bouton Refresh, en haut à droite de la fenêtre, met à jour tous les indicateurs de diagnostic pour afficher l'état actuel de l'indexation sans recharger la page.