Source de données Citrix Gateway

La source de données Gateway représente les instances Citrix Gateway locales de votre environnement. Si vous êtes abonné au service ADM (Citrix Application Delivery Management) de Citrix Cloud, Citrix Analytics détecte automatiquement les agents et les instances de Gateway ajoutées à Citrix ADM.

Si vous n’êtes pas abonné à Citrix ADM et que vous souhaitez ajouter vos instances Gateway, vous pouvez les ajouter à partir du service Analytics.

Cet article décrit les procédures permettant d’activer Analytics dans les deux scénarios.

Activer Analytics on Gateway sources de données ajoutées à Citrix ADM

Conditions préalables

  • Abonnez-vous à Citrix ADM et ajoutez vos instances Gateway à Citrix ADM. Pour savoir comment démarrer avec Citrix ADM, reportez-vous à la section Mise en route.

  • Examinez les Configuration système requise et assurez-vous qu’elles sont remplies.

Afficher la source de données et activer le traitement des données

Citrix Analytics détecte automatiquement les agents Citrix ADM et les instances Citrix Gateway ajoutées à Citrix ADM.

Pour afficher la source de données :

Dans la barre supérieure, cliquez sur Paramètres > Sources de données > Sécurité.

Les agents détectés sont affichés sous forme de cartes de site sur la page Sources de données . Cliquez sur Activer le traitement des données pour autoriser Citrix Analytics à commencer le traitement des données pour cette source de données.

Page Source de données

Afficher les événements, les utilisateurs et les agents reçus

La fiche de site affiche le nombre d’utilisateurs de Gateway, d’agents Citrix ADM et les événements reçus de cette source de données au cours de la dernière heure, qui correspond à la sélection d’heure par défaut. Vous pouvez également sélectionner 1 semaine (1W) et afficher les données. Cliquez sur le nombre d’utilisateurs à afficher sur la page Utilisateurs. Cliquez sur le nombre d’agents pour afficher les instances Citrix Gateway et les agents.

Page Source de données

Une fois que vous avez activé le traitement des données, la carte de site peut afficher le statut Aucune donnée reçue. Ce statut apparaît pour deux raisons :

  1. Si vous avez activé le traitement des données pour la première fois, les événements prennent un certain temps pour atteindre le hub d’événements dans Citrix Analytics. Lorsque Citrix Analytics reçoit les événements, le statut devient Traitement des données activé. Si l’état ne change pas après un certain temps, actualisez la page Sources de données.

  2. Analytics n’a reçu aucun événement de la source de données au cours de la dernière heure.

    Pas de Gateway de données

Activer ou désactiver le traitement des données

Pour arrêter le traitement des données, cliquez sur l’ellipse verticale (⋮) sur la carte de site, puis cliquez sur Désactiver le traitement des données. Citrix Analytics cesse de traiter les données de cette source de données.

Page Source de données

Pour réactiver le traitement des données, cliquez sur Activer le traitement des données.

Page Source de données

Activer Analytics on Gateway sources de données non ajoutées à Citrix ADM

Si vous ne disposez pas d’un abonnement Citrix ADM et que vous souhaitez ajouter vos instances Gateway, vous pouvez les ajouter à partir du service Analytics.

Vous devez effectuer les opérations suivantes :

Conditions préalables

  • Examinez les Configuration système requise et assurez-vous qu’elles sont remplies.

  • Configurationrequise pour l’installation de l’agent Citrix ADM : dans votre centre de données, vous pouvez installer un agent sur Citrix Hypervisor, VMware ESXi, Microsoft Hyper-V et Linux KVM Server.

    Le tableau suivant répertorie les ressources informatiques virtuelles que l’hyperviseur doit fournir pour l’agent.

    Composant Exigences
    RAM 8 Go (32 Go recommandés pour de meilleures performances.)
    CPU virtuel 4 (8 processeurs virtuels recommandés pour de meilleures performances)
    Espace de stockage 120 Go
    Interfaces réseau virtuelles 1
    Débit 1 Gbit/s
  • Configuration requise des ports : assurez-vous que les ports suivants sont ouverts pour que l’agent Citrix ADM puisse communiquer avec les instances Citrix Gateway.

    Type Port Description
    TCP 80/443 Pour la communication NITRO entre l’agent et les instances Citrix Gateway
    TCP 22 Pour la communication SSH entre l’agent et l’instance Citrix Gateway.
    UDP 4739 Pour la communication AppFlow entre Citrix Gateway et l’agent
    ICMP Aucun port réservé Pour détecter l’accessibilité du réseau de l’agent aux instances Citrix Gateway.
    SNMP 161, 162 Pour recevoir des événements SNMP de l’instance Citrix Gateway vers l’agent.
    Syslog 514 Pour recevoir des messages syslog dans l’agent à partir de l’instance Citrix Gateway.
    TCP 5557 pour la communication de flux de journaux entre les instances de Citrix Gateway et l’agent.

    Pour la communication entre l’agent Citrix ADM et Citrix Analytics, assurez-vous que le port suivant est ouvert :

    Type Port Description
    TCP 443 Pour la communication NITRO entre l’agent et le service Citrix Application Delivery Management.

Afficher la source de données

Après vous être connecté à Citrix Analytics, dans la barre supérieure, cliquez sur Paramètres > Sources de données > Sécurité pour afficher la page Sources de données.

  • Si aucun agent n’est configuré sur Citrix ADM, vous voyez les 0 agents détectés sur la carte de site. Cliquez sur + pour ajouter des agents et des instances de passerelle.

    Sources de données liées, sélection de Citrix Gateway

  • Ou si vous souhaitez ajouter d’autres instances de Gateway, cliquez sur les agents sur la fiche de site pour afficher la page Agents découverts. Dans la vignette Ajouter des sources de données locales, cliquez sur Citrix Gateway.

    Sources de données liées, sélection de Citrix Gateway

  • Cliquez sur Démarrer sur la page suivante.

    Sources de données liées, sélection de Citrix Gateway

Installer et configurer un agent

Installez et configurez l’agent de service Citrix ADM dans votre environnement réseau pour activer la communication entre Citrix Analytics et les instances de votre datacenter.

Vous pouvez installer un agent sur les hyperviseurs suivants dans votre datacenter d’entreprise :

  • Citrix Hypervisor

  • VMware ESXi

  • Microsoft Hyper-V

  • Serveur KVM Linux

Pour installer et configurer un agent, procédez comme suit :

  1. Télécharger l’image de l’agent.

    Sur la page Configurer l’agent sur un Hypervisor, sélectionnez l’Hypervisor, puis cliquez sur Télécharger l’image pour télécharger l’image de l’agent sur votre système local.

    Sélectionner l'Hypervisor

  2. Copier l’URL du service et le code d’activation.

    Une URL de service et un code d’activation sont générés et affichés sur l’interface utilisateur comme indiqué dans l’image ci-dessous. (Ce processus peut prendre quelques secondes.) L’agent utilise l’URL du service pour localiser le service et le code d’activation pour s’inscrire auprès du service. Vous devez entrer l’URL du service et le code d’activation lors de l’installation de l’agent sur votre Hypervisor.

    Copier l'URL du service et le code d'activation

  3. Installez l’agent sur un Hypervisor.

    Remarque

    Avant de commencer l’installation de l’agent, assurez-vous que :

    • Vous disposez des ressources informatiques virtuelles requises que l’Hypervisor doit fournir pour chaque agent : RAM : 8 Go, vCPU : 4, espace de stockage : 120 Go, interface réseau virtuelle : 1 et débit : 1 Gbit/s

    • Vous configurez votre DNS pour autoriser l’accès Internet à votre agent.

    • Sur Citrix Hypervisor, effectuez les opérations suivantes :

      1. Importez le fichier image de l’agent dans votre hyperviseur. Dans l’onglet Console, configurez les options de configuration réseau initiales comme indiqué dans l’exemple suivant.

        Configuration de l'agent réseau

        Si vous avez entré des valeurs incorrectes ou si vous souhaitez modifier une valeur quelconque, connectez-vous à l’invite de shell en utilisant les informations d’identification par défautnsrecover/nsroot, puis exécutez la commandenetworkconfig.

      2. Entrez l’URL du service et le code d’activation que vous avez enregistrés lorsque vous avez téléchargé l’image de l’agent.

        Coller l'URL du service et le code d'activation

        Si vous avez saisi l’URL du service ou le code d’activation de manière incorrecte, connectez-vous à l’invite de shell de l’agent, puis exécutez le script :deployment_type.py. Ce script vous permet de réentrer l’URL du service et le code d’activation.

    • Sur l’Hypervisor VMware ESXi, effectuez les opérations suivantes :

      1. Importez le fichier image de l’agent dans votre hyperviseur. Dans l’onglet Console, configurez les options de configuration réseau initiales comme indiqué dans l’exemple suivant.

        Configuration de l'agent réseau

      2. Après avoir configuré le réseau, lorsque vous y êtes invité, connectez-vous à l’invite shell de l’agent à l’aide des informations d’identification par défautnsrecover/nsroot.

        Login

      3. Accédez au répertoire /mps, exécutez le script et entrez l’URL du service et le code d’activation que vous avez enregistrés lorsque vous avez téléchargé l’image de l’agent.

        Coller l'URL du service et le code d'activation

        Coller l'URL du service et le code d'activation

    Remarque

    Vous pouvez utiliser le même fichier image pour installer plusieurs agents. Toutefois, vous ne pouvez pas utiliser le même code d’activation sur plusieurs agents. Pour générer un nouveau code d’activation, accédez à Citrix Analytics et sur l’agent d’installation sur une étape d’Hypervisor, cliquez à nouveau sur Télécharger l’image . Un nouveau code d’activation est généré.

  4. Agent d’enregistrement.

    Une fois l’enregistrement de l’agent réussi, l’agent redémarre pour terminer le processus d’installation. Une fois l’agent redémarré, accédez à Citrix Analytics et cliquez sur Register Agent, puis vérifiez l’état de l’agent.

    Vérifier l'enregistrement de l'agent

    Lorsque l’état de l’agent est à l’état UP, désigné par un point vert à côté de celui-ci, cliquez sur Suivant pour commencer à ajouter des instances au service.

Ajouter des instances Citrix Gateway

Les instances sont des appliances Citrix Gateway ou des appliances virtuelles qui sont les sources de données pour Citrix Analytics.

  1. Dans la page Ajouter des instances de Citrix Gateway, sélectionnez le type d’instance et spécifiez les noms d’hôte ou les adresses IP ou la plage d’adresses IP des instances de passerelle à découvrir.

  2. Créez un profil d’authentification que l’agent peut utiliser pour accéder aux instances de passerelle. Ce profil est les informations d’identification d’administrateur d’une instance de passerelle. Cliquez ensuite sur Ajouter des instances.

    Ajouter des instances

Une fois les instances ajoutées, vous pouvez afficher le nombre d’instances qui ont été découvertes avec succès. Pour ajouter d’autres instances, cliquez sur Ajouter une instance Citrix Gateway.

Ajouter des instances

Cliquez sur Suivant pour activer l’analyse.

Activer l’analyse

Citrix Analytics découvre automatiquement les serveurs virtuels sous licence sur les instances Citrix Gateway ajoutées. Vous devez activer l’analyse sur tous les serveurs virtuels découverts.

Sur la page Activer Analytics, par défaut, tous les serveurs virtuels sous licence des instances de passerelle apparaissent. Passez en revue la liste des serveurs virtuels sous licence et cliquez sur Activer Analytics pour activer l’analyse sur les serveurs virtuels.

Activer l'analyse

Le statut de la carte de site passe à Traitement des données On. Vous pouvez afficher les événements reçus.

Activer l'analyse

Gérer la source de données

Vous pouvez également ajouter d’autres instances à un agent ou supprimer des instances associées à un agent. Vous pouvez également supprimer l’agent et ses instances associées de Citrix Analytics.

Retournez une carte de site de l’agent et effectuez l’une des opérations suivantes :

Activer l'analyse

  • Ajouter ou supprimer des instances. Vous pouvez ajouter d’autres instances de passerelle à un agent et activer Analytics sur les serveurs virtuels configurés sur ces instances. Vous pouvez également supprimer des instances ajoutées à un agent. Lorsque vous dissociez une instance d’un agent, Citrix Analytics ne peut pas communiquer avec cette instance.

  • Supprimer de Citrix Analytics. Après avoir supprimé un site d’agent, Citrix Analytics cesse de collecter des données à partir des instances associées à cet agent. Mais toutes les données traitées précédemment sont disponibles pendant la période de conservation.