Les problèmes de la Plateforme Coveo sont divisés en quatre principales catégories :

• Service CES

• Balayage

• Performance

• Interface de recherche

Chaque catégorie en soi peut être divisée en différents types de problèmes, pour lesquels Coveo Support peut exiger différents fichiers afin de pouvoir aider à la résolution de ces problèmes.

Cette rubrique vous offre une vue d'ensemble d'où rechercher la source de tout problème, et de quelles informations vous devriez envoyer à Coveo Support afin d'obtenir de l'aide.

Balayage

Index en mode lecture seulement

Symptômes :

• Toute l'analyse est interrompue.

• Tous les contrôles de l'Outil d'administration sont désactivés (grisés).

Causes possibles :

1. Un horaire a basculé l'index en mode lecture seulement entre certaines heures.

   Vous pouvez vérifier les horaires à partir de l'Outil d'administration (voir Modification d'horaires de système).

2. Quelqu'un a basculé manuellement l'index en mode lecture seulement.

   Le système journalise toutes les actions qui sont effectuées dans l'Outil d'administration et la personne qui était connectée à ce moment (trouvée dans [Index_Path]\Logs\) afin que vous soyez en mesure de savoir qui a basculé l'index en mode lecture seulement.

3. Une petite quantité d'espace disque bascule automatiquement l'index en mode lecture seulement.

   Ceci est également enregistré dans les journaux système. Si les alertes par courriel sont configurées au niveau Erreur, une alerte par courriel sera envoyée si ceci se produit (voir Configuration d'alertes par courriel).

L'analyse arrête avant le moment où il devrait le faire, ou l'analyse ne commence pas du tout

Ce problème est habituellement accompagné d'un message dans les journaux de l'index avec le niveau ERREUR qui explique pourquoi l'analyse s'est interrompu ou ne peut pas débuter (trouvé dans [Index_Path]\Logs\).

Ce que vous devriez envoyer à Coveo Support afin d'obtenir de l'aide pour ce type de problème :

1. Les journaux d'index du moment où le problème est survenu, qui se retrouvent dans le dossier [drive]:\CES7\Logs\.

2. Le fichier config.txt de Coveo, qui se trouve dans le dossier [Index_Path]\Logs\.

3. Le nom de la collection et de la source qui sont touchées.

4. Tout fichier de correspondances ou de configuration référencé dans la source.

L'analyse se termine, mais certains documents ne peuvent être trouvés

Causes possibles et symptômes reliés :

1. Un document est indexé, mais son contenu ne peut être retrouvé

   À partir de l'interface de recherche, vous pouvez trouver le document à l'aide de son nom, mais pas de son contenu.

   Dans ce cas, le document est fort probablement indexé par référence. Si un document est indexé par référence, seuls son chemin d'accès et ses métadonnées de base sont indexés, et non son contenu (voir Quelle est la différence entre l'indexation par référence et l'indexation par contenu?).

   Deux aspects que vous pouvez vérifier :

   1. Dans l'Outil d'administration, veillez à ce que l'Action de ce type de document soit définie à Indexer le document en entier (voir Modification de la façon dont CES gère un type de document).

   2. Recherchez le document en question dans les journaux de l'index (se retrouve dans [Index_Path]\Logs\). Vous devriez trouver une entrée avec un niveau AVERTISSEMENT qui a un message d'erreur expliquant pourquoi le document a été indexé par référence.

2. Un document est indexé, mais il est introuvable.

   La sécurité est la cause la plus probable si le document a été indexé, mais est introuvable à partir de l'interface de recherche :

   • À l'aide du Navigateur d'index, trouvez le document, comparez la sécurité qui se trouve dans le document tel qu'il apparaît dans l'index et veillez à ce qu'il corresponde à la sécurité du document tel qu'il apparaît dans son référentiel original (voir Évaluation des détails d'un document du Navigateur d'index).

   • Si tout semble bien se passer là, vous pouvez alors vérifier la sécurité que l'interface de recherche détecte pour un utilisateur qui devrait trouver le document en ajoutant debug=1 à la chaîne de requête. Ces informations peuvent être envoyées à Assistance Coveo pour analyse.

Performance

Les transactions sont lentes à appliquer à l'index

La cause la plus commune d'une application lente de transactions à l'index est reliée à I/O, car ce processus peut solliciter le disque dur de manière très intensive.

Pour collecter des informations sur le réglage de problèmes :

• Activez l'analyse de performances Windows dans le serveur (voir Collecte des informations de l'Analyseur de performances de Windows Server).

• Activez la journalisation du suivi de la transaction afin de voir exactement quelle action entraîne l'embouteillage (voir Utilisation de la journalisation du suivi des transactions).

Ce que vous devriez envoyer à Coveo Support afin d'obtenir de l'aide sur ce type de problème une fois que la journalisation est désactivée :

1. Résultats de l'Analyseur de performances Windows.

2. Le résultat de l'exécution de la deuxième option par l'outil SystemStatus (voir Utilisation de l'outil SystemStatus de Coveo).

3. Le résultat des journaux de suivi de la transaction (les fichiers [Index_Path]\Index\Default\Default\CESProfiling-Trn*.txt de chaque tranche).

Les requêtes sont lentes

En général, vous devriez vous attendre à ce qu'une interface de recherche Coveo retourne les résultats de recherche d'une requête en moins d'une seconde. Des cas particuliers, tels qu'une page de recherche modifiée qui lance plusieurs sous-requêtes ou des requêtes avec caractères de remplacement, doivent habituellement prendre plus de temps.

Si les requêtes sont plus longues qu'à l'habitude, vérifiez les détails suivants :

1. Dans le serveur maître Coveo, à l'aide du Gestionnaire des tâches, vérifiez si toutes les unités centrales du serveur sont constamment utilisées à 100%.

2. Le serveur répond-il aux exigences de système recommandées de Coveo (voir Exigences du matériel et du logiciel de la Plateforme Coveo)?

3. Coveo est-il exécuté dans un serveur dédié? Sinon, les spécifications du serveur devraient être augmentées afin de prendre la charge supplémentaire en considération.

4. Combien de requêtes le serveur reçoit-il (voir Quelles informations sont présentées dans l'historique des requêtes?)? Si vous en avez davantage, vous devriez ajouter un serveur miroir Coveo afin de distribuer la charge (voir Ajout d'un serveur de miroir).

Ce que vous devriez envoyer à Coveo Support afin d'obtenir de l'aide pour ce type de problème :

1. Fichiers de profilage des requêtes (voir Utilisation du profilage de requête).

2. Résultats de l'Analyseur de performances Windows pendant que le profilage de requêtes est activé (voir Collecte des informations de l'Analyseur de performances de Windows Server).

3. Le résultat de l'exécution de la deuxième étape par l'outil SystemStatus une fois que le profilage est terminé (voir Utilisation de l'outil SystemStatus de Coveo).

Interface de recherche