Doc produitsMenu

Déploiement du module Analytiques

Les composantes du module Analytiques sont présentes lorsque vous installez un serveur Coveo .NET Front-End (voir Installation de Coveo .NET Front-End), mais les fonctionnalités d'Analytiques sont éteintes par défaut.

Le module Analytiques exige également une connexion à une base de données Microsoft SQL où il enregistrera des actions de recherche et de navigation. Vous pouvez utiliser un serveur Microsoft SQL existant ou en créer une nouvelle instance. Coveo .NET Front-End et la base de données Microsoft SQL peuvent être installés dans le même serveur ou dans des serveurs différents. Vous pouvez déployer le module Analytiques dans une configuration unique de serveur Coveo ou dans une topologie de serveurs d'interface et d'index Coveo.

En résumé, le processus de déploiement consiste en la création d'une base de données Microsoft SQL dédiée, l'établissement des permissions à la base de données, et, dans chaque serveur d'interface Coveo, l'activation et la configuration du module Analytiques pour se connecter à la base de données.

Exigences du module Analytiques :

  • Microsoft SQL Server 2012, 2008 ou 2003 prend en charge la version gratuite de Microsoft SQL Express Edition (voir SQL Server Editions).

    Note : Le serveur SQL 2012 est officiellement pris en charge à partir de Coveo .NET Front-End 12.0.252, publié en juin 2013.

  • Il vous faut des droits d'administrateur de Coveo et de Microsoft SQL Server afin d'effectuer la procédure suivante.

  • Aide à Microsoft Silverlight utilisée pour visionner l'interface d'utilisateur Analytiques.

Note : La nouvelle génération d’analytique de recherche de Coveo est dans le nuage. Nous vous encourageons à utiliser le service Coveo Cloud Usage Analytics pour surveiller l’utilisation de la recherche locale (voir Coveo Cloud Usage Analytics).

Pour déployer le module Analytiques

  1. Choisissez un serveur Microsoft SQL existant ou installez une nouvelle instance où la base de données d'Analytiques sera créée.

  2. Prenez-en note le nom de l'instance de Microsoft SQL Server.

  3. Dans le serveur d'interface Coveo, trouvez le nom de l'utilisateur qui exécute le site Coveo dans IIS (Internet Information Services) (voir Découverte du nom de l'utilisateur qui exécute un processus dans IIS).

  4. Dans le serveur Microsoft SQL, créez une nouvelle base de données d'Analytiques vide avec le nom par défaut CoveoAnalytics (voir Création d'une base de données dans Microsoft SQL Server).

    Note : Vous pouvez utiliser un nom différent pour la base de données, mais vous devrez spécifier ce nom dans le fichier Web.config plus tard pendant cette procédure. Également, avant d'exécuter le script de création de la base de données, vous devrez modifier la première ligne du script de création de la base de données afin de remplacer le nom par défaut de la base de données par le nom que vous avez choisi.

  5. Exécutez le bon script de création de la base de données, qui est distribué dans le dossier [.Net_Front-End_Path]\Web\Analytics\Scripts\Creation (voir Exécution d'un script dans Microsoft SQL Server).

    Exemple : Avec CES (Coveo Enterprise Search) 7.0, exécutez le script CREATE_CES_ANALYTICS_DB_V7-1.SQL.

    Important : Utilisez le script de création seulement lors de la première fois que vous commencez à utiliser le module Analytiques. L'exécution des scripts de création efface de façon permanente toute donnée d'Analytiques existante alors que des tableaux vides de base de données d'Analytiques sont créés.

    Si vous installez une nouvelle version de CES et déployez le module Analytiques pour une version antérieure, vous devriez effectuer des tâches de migration pour la base de données Analytiques (voir Mise à jour du format de la base de données Analytiques).

  6. Dans Microsoft SQL Server Management Studio, définissez des droits d'accès en lecture et en écriture à la base de données pour l'utilisateur qui exécute le service CES :

    1. Dans le panneau Object Explorer pane, agrandissez le dossier Security, cliquez avec le bouton droit de la souris sur Logins, puis sélectionnez New Login dans le menu contextuel.


    2. Dans la boîte de dialogue Login - New, créez une connexion pour l'utilisateur identifié à l'étape 3, puis cliquez sur OK.

      Exemple : Lorsque CES et Microsoft SQL sont exécutés dans le même serveur et l'utilisateur identifié est NetworkServices, créez une connexion NT AUTHORITY\NETWORK SERVICE.

      Exemple : Lorsque CES et Microsoft SQL sont exécutés dans différents serveurs et l'utilisateur identifié est NetworkServices, créez une connexion [CESserverdomain]\[CESservername]$, où vous remplacez [CESserverdomain] et [CESservername] par les noms appropriés.

    3. De retour dans le panneau Object Explorer, agrandissez Security et Logins, cliquez avec le bouton droit de la souris sur le nom de connexion nouvellement créé, puis sélectionnez Properties dans le menu contextuel.

    4. Dans la boîte de dialogue Login Properties, sélectionnez la base de données CoveoAnalytics et cochez db_datareader et db_datawriter, comme affiché ci-dessous.


  7. Dans le Gestionnaire de configuration SQL Server, veillez à ce que le protocole qui est utilisé par CES afin de communiquer avec la base de données SQL soit activé (tel qu'affiché dans l'exemple suivant de Microsoft SQL 2008). Redémarrez le serveur SQL après avoir effectué les changements.

  8. Si CES et Microsoft SQL sont exécutés dans différents serveurs, veillez à ce que le pare-feu de Microsoft SQL Server permette les communications à partir du serveur Coveo (habituellement dans le port 1433).

  9. Dans chaque serveur d'interface Coveo, modifiez le fichier Web.config pour activer le module Analytiques et configurer à quel serveur SQL il se connecte :

    Notes :

    • À partir de Coveo .NET Front-End 12.0.664 (mars 2014), ces paramètres peuvent être faits automatiquement pendant la première installation (voir Première installation de Coveo .NET Front-End).

    • Il est conseillé d'enregistrer le fichier web.config avant de le modifier.

    • Répétez les étapes suivantes pour tous les serveurs de recherche dans vos déploiements de Coveo, dont les intégrations telles que SharePoint, Sitecore ou un site web.

    1. À l'aide d'un éditeur de texte, ouvrez le fichier web.config du serveur d'interface Coveo.

      Exemple :

      • Dans un serveur d'interface Coveo : [.Net_Front-End_Path]\Web\Web.config.

      • Dans le cas d'une intégration SharePoint, le fichier web.config est à la racine de chaque serveur virtuel SharePoint (habituellement situé dans C:\inetpub\wwwroot\wss\VirtualDirectories\[PortNumber]).

      • Dans le cas d'une intégration de Sitecore, pour une instance nommée Sitecore, le fichier se trouve dans le dossier C:\inetpub\wwwroot\Sitecore\WebSite.

    2. Dans le fichier, après la balise <coveoEnterpriseSearch>, localisez la ligne suivante :

      <analytics enabled="false" connectionString="Data Source=yourServerName;Initial Catalog=CoveoAnalytics;Integrated Security=SSPI;"/>
    3. Modifiez la ligne comme suit :

      1. Modifiez enabled="false" à enabled="true" pour activer la collection des données d'Analytiques.

      2. Remplacez yourServerName par le nom du serveur Microsoft SQL qui est l'hôte de la base de données d'Analytiques (noté à l'étape 2) pour établir la chaîne de connexion à la base de données (connectionString=).

        Exemple : Si CES et Microsoft SQL sont exécutés dans le même serveur, remplacez yourServerName par localhost ou par <yourServerName>\<SQLInstance> pour une instance spécifique de SQL Server comme MyMachine\SQLExpress ou .\SQLExpress.
        Si CES et Microsoft SQL sont exécutés dans différents serveurs, remplacez yourServerName par une chaîne sous la forme SQLservername.yourcompany.com ou par l'adresse IP du serveur Coveo.

        Astuce : Pour plus d'informations sur la façon d'écrire une chaîne de connexion SQL, veuillez vous référer à http://www.connexionstrings.com/sql-server-2008.

      3. Si vous avez utilisé un nom de base de données autre que le nom par défaut lorsque vous avez créée la base de données, remplacez CoveoAnalytics par le nom que vous avez utilisé.

    4. Enregistrez le fichier Web.config.

      Le module Analytiques commence immédiatement à récolter des informations sur l'utilisation de la recherche dans la base de données et l'onglet Analytics de l'interface utilisateur apparaît dans l'interface de recherche Coveo par défaut (pour un administrateur CES seulement).

    Important : Si vous avez plus d'un serveur d'interface Coveo, répétez la modification du fichier Web.config dans chaque serveur d'interface afin d'obtenir l'utilisation de recherche de ces serveurs.

    Astuce : Vous pouvez personnaliser le comportement de collection des données d'Analytiques en configurant le fichier Web.config (voir Personnalisation des données d'Analytiques récoltées).

  10. Dans le serveur d'interface Coveo, testez le module Analytiques :

    1. À l'aide d'un compte d'administrateur Coveo, ouvrez la page de recherche Coveo par défaut (barre de tâches Windows Démarrer > Tous les programmes > Coveo Enterprise Search 7 > Default Search Interface).

    2. Effectuez quelques requêtes pour être certain que certaines données soient envoyées à la base de données d'Analytiques.

      Si un message d'erreur apparaît, la connexion ou les permissions à la base de données peuvent ne pas être définies correctement (voir Résolution et gestion d'erreurs du module Analytiques).

    3. Dans l'interface de recherche par défaut, cliquez sur l'onglet Analytics pour ouvrir l'interface d'utilisateur.

    4. Si Microsoft Silverlight n'est pas encore installé dans votre serveur, cliquez sur l'icône Installer Microsoft Silverlight qui apparaît afin de l'installer.

    5. Vérifiez si l'interface d'utilisateur Analytics présente les requêtes que vous avez effectuées.