Guide de résolution des problèmes de la Plateforme Coveo
À propos de l'outil SystemStatus de Coveo
Contact du Service à la clientèle de Coveo
Obtention des informations de débogage d'une interface de recherche
Connexion au serveur FTP de Coveo
Collecte des informations de l'Analyseur de performances de Windows Server
Utilisation de la journalisation du suivi des transactions
Utilisation du profilage de requête
Journalisation d’informations avec log4net
Collecte de journaux d'événements BlackBerry
Pourquoi certains documents ne sont pas retournés par le moteur de recherche?
Pourquoi la page de recherche initiale prend-t-elle plus de temps à apparaître?
Impossible d'établir la connexion avec l'instance default
Message Accès refusé pendant l'ouverture d'un résultat
Impossible de trouver les documents SharePoint
Résolution d'un chargement lent de l'interface de recherche dans Sitecore
Le fournisseur de sécurité n'est pas configuré correctement
Version non prise en charge du serveur d'index
Erreur SharePoint – Nombre de colonnes de consultation
À propos du message d’avertissement sur le paramètre non-utilisé dans la Console CES
Les problèmes de la Plateforme Coveo sont divisés en quatre principales catégories :
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.
Service CES
-
Panne du service CES
-
Une panne du service CES (Coveo Enterprise Search) se produit si le processus CESServiceX.exe (CESMirrorServicex.exe dans le serveur de miroir) s'interrompt de façon inattendue.
Symptômes :
-
Aucun accès à l'Outil d'administration
-
Le serveur d'index ne répond pas aux requêtes.
-
Dans le cas d'un serveur principal, l'analyse s'interrompt.
-
Dans la majorité des cas, des fichiers clichés du noyau sont créés afin d'aider Coveo Support à comprendre la cause d'un problème.
Ce que vous devriez envoyer à Coveo Support afin d'obtenir de l'aide pour ce type de problème :
-
Une copie des fichiers .dmp et .txt du dossier [CES_Path]\CoreDumps\.
-
Le résultat de l'exécution de la deuxième option par l'outil SystemStatus (voir Utilisation de l'outil SystemStatus de Coveo).
-
Analyse ou détails du réglage de problèmes que vous avez déjà effectué
-
-
Blocage du service CES
-
Symptômes :
-
L'Outil d'administration ne charge pas
-
L'interface de recherche ne charge pas
-
Les horaires réguliers d'analyse ne démarrent pas.
-
Dans tous les cas, le service CES semble toujours fonctionner normalement.
Habituellement, le redémarrage du service règle le problème, mais afin de veiller à ce que les informations sur ce problème ne soient pas perdues, ceci ne devrait pas, si possible, être fait avant que Coveo Support vous demande de le faire.
Ce que vous devriez envoyer à Coveo Support afin d'obtenir de l'aide pour ce type de problème :
-
Le résultat de l'exécution de la troisième option par l'outil SystemStatus (voir Utilisation de l'outil SystemStatus de Coveo).
-
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 :
-
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).
-
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.
-
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 :
-
Les journaux d'index du moment où le problème est survenu, qui se retrouvent dans le dossier [drive]:\CES7\Logs\.
-
Le fichier config.txt de Coveo, qui se trouve dans le dossier [Index_Path]\Logs\.
-
Le nom de la collection et de la source qui sont touchées.
-
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 :
-
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 :
-
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).
-
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.
-
-
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 :
-
Résultats de l'Analyseur de performances Windows.
-
Le résultat de l'exécution de la deuxième option par l'outil SystemStatus (voir Utilisation de l'outil SystemStatus de Coveo).
-
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 :
-
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%.
-
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)?
-
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.
-
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 :
-
Fichiers de profilage des requêtes (voir Utilisation du profilage de requête).
-
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).
-
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
En général, les problèmes de l'interface de recherche peuvent être séparés en deux catégories :
-
Problèmes dans le skin
-
Problèmes avec les paramètres de l'interface de recherche
Ce que vous devriez envoyer à Coveo Support afin d'obtenir de l'aide pour ce type de problème :
-
Le nom de l'interface de recherche qui rencontre ce problème
-
Un fichier zip du dossier [.Net_Front-End_Path]\Web\Coveo\Skins.