Configuration de la visualisation des journaux de recherche
À propos de la visualisation des journaux de recherche
Fess collecte les journaux de recherche et de clics des utilisateurs. Les journaux de recherche collectés peuvent être analysés et visualisés à l’aide d”OpenSearch Dashboards.
Informations pouvant être visualisées
Avec la configuration par défaut, les informations suivantes peuvent être visualisées.
Temps moyen pour afficher les résultats de recherche
Nombre de recherches par seconde
Classement des User Agent des utilisateurs accédant
Classement des mots-clés de recherche
Classement des mots-clés de recherche avec 0 résultat
Nombre total de résultats de recherche
Tendances de recherche dans le temps
En utilisant la fonction Visualize pour créer de nouveaux graphiques et les ajouter au Dashboard, vous pouvez construire votre propre tableau de bord de surveillance.
Configuration de la visualisation des données avec OpenSearch Dashboards
Installation d’OpenSearch Dashboards
OpenSearch Dashboards est un outil de visualisation des données d’OpenSearch utilisé par Fess. Installez OpenSearch Dashboards en suivant la documentation officielle d’OpenSearch.
Modification du fichier de configuration
Pour permettre à OpenSearch Dashboards de reconnaître OpenSearch utilisé par Fess, modifiez le fichier de configuration config/opensearch_dashboards.yml.
opensearch.hosts: ["http://localhost:9201"]
Remplacez localhost par le nom d’hôte ou l’adresse IP appropriée selon votre environnement. Dans la configuration par défaut de Fess, OpenSearch démarre sur le port 9201.
Note
Si le numéro de port d’OpenSearch est différent, modifiez-le avec le numéro de port approprié.
Démarrage d’OpenSearch Dashboards
Après avoir modifié le fichier de configuration, démarrez OpenSearch Dashboards.
$ cd /path/to/opensearch-dashboards
$ ./bin/opensearch-dashboards
Après le démarrage, accédez à http://localhost:5601 dans votre navigateur.
Configuration du modèle d’index
Sélectionnez le menu « Management » depuis l’écran d’accueil d’OpenSearch Dashboards.
Sélectionnez « Index Patterns ».
Cliquez sur le bouton « Create index pattern ».
Entrez
fess_log*dans Index pattern name.Cliquez sur le bouton « Next step ».
Sélectionnez
requestedAtdans Time field.Cliquez sur le bouton « Create index pattern ».
Vous êtes maintenant prêt à visualiser les journaux de recherche de Fess.
Création de visualisations et de tableaux de bord
Création de visualisations de base
Sélectionnez « Visualize » dans le menu de gauche.
Cliquez sur le bouton « Create visualization ».
Sélectionnez le type de visualisation (graphique linéaire, graphique circulaire, graphique à barres, etc.).
Sélectionnez le modèle d’index
fess_log*que vous avez créé.Configurez les métriques et les buckets (unités d’agrégation) nécessaires.
Cliquez sur le bouton « Save » pour enregistrer la visualisation.
Création de tableaux de bord
Sélectionnez « Dashboard » dans le menu de gauche.
Cliquez sur le bouton « Create dashboard ».
Cliquez sur le bouton « Add » pour ajouter les visualisations que vous avez créées.
Ajustez la mise en page et cliquez sur le bouton « Save » pour enregistrer.
Configuration du fuseau horaire
Si l’affichage de l’heure n’est pas correct, configurez le fuseau horaire.
Sélectionnez « Management » dans le menu de gauche.
Sélectionnez « Advanced Settings ».
Recherchez
dateFormat:tz.Définissez le fuseau horaire sur une valeur appropriée (par exemple :
Asia/TokyoouUTC).Cliquez sur le bouton « Save ».
Vérification des données de journal
Sélectionnez « Discover » dans le menu de gauche.
Sélectionnez le modèle d’index
fess_log*.Les données du journal de recherche s’affichent.
Vous pouvez spécifier la période à afficher avec la sélection de plage de temps en haut à droite.
Principaux champs de journal de recherche
Les journaux de recherche de Fess contiennent les informations suivantes.
| Nom du champ | Description |
|---|---|
queryId | Identifiant unique de la requête de recherche |
searchWord | Mot-clé de recherche |
requestedAt | Date et heure d’exécution de la recherche |
responseTime | Temps de réponse des résultats de recherche (millisecondes) |
queryTime | Temps d’exécution de la requête (millisecondes) |
hitCount | Nombre de résultats trouvés |
userAgent | Informations du navigateur de l’utilisateur |
clientIp | Adresse IP du client |
languages | Langue utilisée |
roles | Informations de rôle de l’utilisateur |
user | Nom d’utilisateur (lors de la connexion) |
En utilisant ces champs, vous pouvez analyser les journaux de recherche sous différents angles.
Dépannage
Si les données ne s’affichent pas
Vérifiez qu’OpenSearch fonctionne correctement.
Vérifiez que la configuration
opensearch.hostsdansopensearch_dashboards.ymlest correcte.Vérifiez que des recherches ont été effectuées dans Fess et que les journaux sont enregistrés.
Vérifiez que la plage de temps du modèle d’index est configurée de manière appropriée.
En cas d’erreur de connexion
Vérifiez que le numéro de port d’OpenSearch est correct.
Vérifiez la configuration du pare-feu ou des groupes de sécurité.
Vérifiez qu’il n’y a pas d’erreurs dans les fichiers journaux d’OpenSearch.