Outil de création de rapports

Utilisez l’outil Citrix® Citrix ADC® Reporting pour afficher les données de statistiques de performances Citrix ADC sous forme de rapports. Les données statistiques sont collectées par l’utilitaire nscollect et stockées dans une base de données. Lorsque vous souhaitez afficher certaines données de performances sur une période donnée, l’outil Reporting extrait les données spécifiées de la base de données et les affiche dans des graphiques.

Les rapports sont une collection de graphiques. L’outil Reporting fournit des rapports intégrés ainsi que la possibilité de créer des rapports personnalisés. Dans un rapport, vous pouvez modifier les graphiques et ajouter de nouveaux graphiques. Vous pouvez également modifier le fonctionnement de l’utilitaire de collecte de données, nscollect, et arrêter ou démarrer son opération.

Utilisation de l’outil de création de rapports

L’outil Reporting est une interface Web accessible depuis l’appliance Citrix® Citrix ADC®. Utilisez l’outil Reporting pour afficher les données des statistiques de performances sous forme de rapports contenant des graphiques. En plus d’utiliser les rapports intégrés, vous pouvez créer des rapports personnalisés que vous pouvez modifier à tout moment. Les rapports peuvent comporter entre un et quatre graphiques. Vous pouvez créer jusqu’à 256 rapports personnalisés. Vous pouvez créer un rapport personnalisé pour un nombre quelconque d’entités.

Pour appeler l’outil de création de rapports

  1. Utilisez le navigateur Web de votre choix pour vous connecter à l’adresse IP de Citrix ADC (par exemple,http://10.102.29.170/). L’écran d’ouverture de session Web s’affiche.
  2. Dans la zone de texte Nom d’utilisateur, tapez le nom d’utilisateur attribué à Citrix ADC.
  3. Dans la zone de texte Mot de passe, tapez le mot de passe.
  4. Dans la liste déroulante Démarrer dans, sélectionnez Reporting.Cliquez sur Connexion.

Les captures d’écran suivantes affichent la barre d’outils du rapport et la barre d’outils du graphique, qui sont fréquemment référencées dans cette documentation.

Figure 1. Barre d’outils Rapport

image localisée

Figure 2. Barre d’outils Graphique

image localisée

Utilisation des rapports

Vous pouvez tracer et surveiller les statistiques pour les différents groupes fonctionnels configurés sur Citrix ADC sur un intervalle de temps spécifié. Les rapports vous permettent de dépanner ou d’analyser le comportement de votre appliance. Il existe deux types de rapports : les rapports intégrés et les rapports personnalisés. Le contenu des rapports intégrés ou personnalisés peut être affiché sous forme graphique ou tabulaire. La vue graphique se compose de graphiques en ligne, en zone et en barres qui peuvent afficher jusqu’à 32 ensembles de données (compteurs). La vue tabulaire affiche les données en colonnes et en lignes. Cette vue est utile pour le débogage des compteurs d’erreurs.

Le rapport par défaut affiché dans l’outil Reporting est CPU vs. Utilisation de la mémoire et taux de requêtes HTTP. Vous pouvez modifier l’affichage du rapport par défaut en affichant le rapport souhaité comme affichage par défaut, puis en cliquant sur Rapport par défaut.

Les rapports peuvent être générés pour la dernière heure, le dernier jour, la semaine dernière, le dernier mois, l’année dernière, ou vous pouvez personnaliser la durée.

Vous pouvez effectuer les opérations suivantes avec les rapports :

  • Basculer entre une vue tabulaire des données et une vue graphique des données.
  • Modifiez le type d’affichage graphique, tel qu’un graphique à barres ou un graphique en courbes.
  • Personnaliser les graphiques dans un rapport.
  • Exportez le graphique en tant que fichier CSV (Excel séparé par des virgules).
  • Affichez les graphiques en détail en effectuant un zoom avant, un zoom arrière ou un glisser-déposer (défilement).
  • Définissez un rapport comme rapport par défaut à afficher chaque fois que vous ouvrez une session.
  • Ajouter ou supprimer des compteurs.
  • Imprimer des rapports.
  • Actualiser les rapports pour afficher les dernières données de performances.

Utilisation de rapports intégrés

L’outil Reporting fournit des rapports intégrés pour les données fréquemment consultées. Les rapports intégrés sont disponibles pour les groupes fonctionnels suivants : Système, Réseau, SSL, Compression, Cache intégré, Citrix ADC Gateway et Citrix ADC Application Firewall. Par défaut, les rapports intégrés sont affichés pour le dernier jour. Toutefois, vous pouvez afficher les rapports de la dernière heure, de la dernière semaine, du dernier mois ou de l’année dernière.

Remarque :

Vous ne pouvez pas enregistrer les modifications apportées aux rapports intégrés, mais vous pouvez enregistrer un rapport intégré modifié en tant que rapport personnalisé.

Pour afficher un rapport intégré

  1. Dans le volet gauche de l’outil Rapports, sous Rapports intégrés, développez un groupe (par exemple, SSL).
  2. Cliquez sur un rapport (par exemple, SSL > Tous les chiffrements backend).

Création et suppression de rapports

Vous pouvez créer vos propres rapports personnalisés et les enregistrer avec des noms définis par l’utilisateur pour les réutiliser. Vous pouvez tracer différents compteurs pour différents groupes en fonction de vos besoins. Vous pouvez créer jusqu’à 256 rapports personnalisés.

Vous pouvez créer un rapport ou enregistrer un rapport intégré en tant que rapport personnalisé. Par défaut, un rapport personnalisé nouvellement créé contient un graphique nommé Vue d’ensemble du système, qui affiche le compteur d’utilisation du processeur tracé pour le dernier jour. Vous pouvez personnaliser l’intervalle et définir la source de données et le fuseau horaire à partir de la barre d’outils du rapport.

Par défaut, les rapports personnalisés nouvellement créés contiennent un graphique nommé Vue d’ensemble du système qui affiche un compteur d’utilisation de l’UC tracé pour le dernier jour.

Pour créer un rapport personnalisé

  1. Dans l’outil Rapports, dans la barre d’outils du rapport, cliquez sur Créer ou, si vous souhaitez créer un rapport personnalisé basé sur un rapport existant, ouvrez le rapport existant, puis cliquez sur Enregistrer sous.
  2. Dans la zone Nom du rapport, tapez un nom pour le rapport personnalisé.
  3. Procédez comme suit :
    • Pour ajouter le rapport à un dossier existant, dans Créer dans ou Enregistrer dans, cliquez sur la flèche vers le bas pour choisir un dossier existant, puis cliquez sur OK.
    • Pour créer un nouveau dossier pour stocker le rapport, cliquez sur l’icône Cliquez pour ajouter un dossier, dans Nom du dossier, tapez le nom du dossier, puis dans Créer dans, indiquez où vous souhaitez que le nouveau dossier réside dans la hiérarchie, puis cliquez sur OK.

Remarque : Vous pouvez créer jusqu’à 128 dossiers.

Pour supprimer un rapport personnalisé

  1. Dans le volet gauche de l’outil Rapports, en regard de Rapports personnalisés, cliquez sur l’icône Cliquez pour gérer les rapports personnalisés.
  2. Activez la case à cocher correspondant au rapport à supprimer, puis cliquez sur Supprimer.

    Remarque :

    lorsque vous supprimez un dossier, tout le contenu de ce dossier est supprimé.

Modification de l’intervalle de temps

Par défaut, les rapports intégrés affichent les données du dernier jour. Toutefois, si vous souhaitez modifier l’intervalle de temps d’un rapport intégré, vous pouvez enregistrer le rapport en tant que rapport personnalisé. Le nouvel intervalle s’applique à tous les graphiques du rapport. Le tableau suivant décrit les options d’intervalle de temps.

Pour modifier l’intervalle de temps

  1. Dans le volet gauche de l’outil Rapports, cliquez sur un rapport.
  2. Dans la barre d’outils du rapport, cliquez sur Durée, puis sur un intervalle de temps.

Définition de la source de données et du fuseau horaire

Vous pouvez extraire des données de différentes sources de données pour les afficher dans les rapports. Vous pouvez également définir le fuseau horaire des rapports et appliquer la sélection horaire du rapport actuellement affiché à tous les rapports, y compris les rapports intégrés.

Pour définir la source de données et le fuseau horaire

  1. Dans l’outil Rapports, dans la barre d’outils du rapport, cliquez sur Paramètres.
  2. Dans la boîte de dialogue Paramètres, dans Source de données, sélectionnez la source de données à partir de laquelle vous souhaitez extraire les informations du compteur.
  3. Faites l’une des opérations suivantes ou les deux :
    • Si vous souhaitez que l’outil mémorise la période pendant laquelle un graphique est tracé, activez la case à cocher Mémoriser la sélection de temps pour les graphiques.
    • Si vous souhaitez que les rapports utilisent les paramètres d’heure de votre appliance Citrix ADC, activez la case à cocher Utiliser le fuseau horaire de l’appliance.

Exportation et importation de rapports personnalisés

Vous pouvez partager des rapports avec d’autres administrateurs Citrix ADC en exportant des rapports. Vous pouvez également importer des rapports.

Pour exporter ou importer des rapports personnalisés

  1. Dans le volet gauche de l’outil Rapports, en regard de Rapports personnalisés, cliquez sur l’icône Cliquez pour gérer les rapports personnalisés.
  2. Activez la case à cocher correspondant au rapport à exporter ou à importer, puis cliquez sur Exporter ou Importer.

    Remarque :

    lorsque vous exportez le fichier, il est exporté au format de fichier .gz.

Utilisation des graphiques

Utilisez des graphiques pour tracer et surveiller des compteurs ou des groupes de compteurs. Vous pouvez inclure jusqu’à quatre graphiques dans un rapport. Dans chaque graphique, vous pouvez tracer jusqu’à 32 compteurs. Les graphiques peuvent utiliser différents formats graphiques (par exemple, zone et barre). Vous pouvez déplacer les graphiques vers le haut ou vers le bas dans le rapport, personnaliser les couleurs et l’affichage visuel de chaque compteur d’un graphique et supprimer un graphique lorsque vous ne souhaitez pas le surveiller.

Dans tous les graphiques de rapport, l’axe horizontal représente le temps et l’axe vertical représente la valeur du compteur.

Ajout d’un graphique

Lorsque vous ajoutez un graphique à un rapport, le graphique Vue d’ensemble du système apparaît avec le compteur Utilisation de l’UC tracé pour le dernier jour.

Remarque :

Si vous ajoutez des graphiques à un rapport intégré et que vous souhaitez conserver le rapport, vous devez enregistrer le rapport en tant que rapport personnalisé.

Utilisez la procédure suivante pour ajouter un graphique à un état.

Pour ajouter un graphique à un rapport

  1. Dans le volet gauche de l’outil Rapports, cliquez sur un rapport.
  2. Sous le graphique dans lequel vous souhaitez ajouter le nouveau graphique, cliquez sur l’icône Ajouter.

Modification d’un graphique

Vous pouvez modifier un graphique en modifiant le groupe fonctionnel pour lequel les statistiques sont affichées et en sélectionnant différents compteurs.

Pour modifier un graphique

  1. Dans le volet gauche de l’outil Rapports, cliquez sur un rapport.
  2. Sous le graphique à modifier, cliquez sur Compteurs.
  3. Dans la boîte de dialogue qui apparaît, dans la zone Titre, tapez un nom pour le graphique.
  4. En regard de Graphique de tracé pour, effectuez l’une des opérations suivantes :
    • Pour tracer les compteurs pour les compteurs globaux, tels que Cache intégré et Compression, cliquez sur Statistiques globales système.
    • Pour tracer les compteurs d’entités pour les types d’entités, tels que l’équilibrage de charge et GSLB, cliquez sur Statistiques des entités système.
  5. Dans Sélectionner le groupe, cliquez sur l’entité souhaitée.
  6. Sous Compteurs, dans Disponible, cliquez sur le ou les noms de compteur que vous souhaitez tracer, puis cliquez sur le bouton>.
  7. Si vous avez sélectionné Statistiques des entités système à l’étape 4, sous l’onglet Entités, sous Disponible, cliquez sur le ou les noms d’instance d’entité que vous souhaitez tracer, puis cliquez sur le bouton>.
  8. Cliquez sur OK.

Affichage d’un graphique

Vous pouvez spécifier les formats graphiques des compteurs tracés dans un graphique. Les graphiques peuvent être affichés sous forme de graphiques en courbes, de graphiques en spline, de graphiques en courbes, de graphiques en nuages de points, de graphiques en aires, de graphiques à barres, de graphiques en aires empilées et de graphiques à barres empilées. Vous pouvez également effectuer un zoom avant, un zoom arrière ou un défilement à l’intérieur de la zone de tracé d’un graphique. Vous pouvez effectuer un zoom avant ou arrière pour toutes les sources de données pendant 1 heure, 1 jour, 1 semaine, 1 mois, 1 an et 3 ans.

D’autres options de personnalisation de la vue d’un graphique incluent la personnalisation des axes des graphiques, la modification de la couleur d’arrière-plan et de bordure de la zone de tracé, la personnalisation de la couleur et de la taille des grilles et la personnalisation de l’affichage de chaque jeu de données (compteur) d’un graphique.

Les numéros des ensembles de données, tels que l’ensemble de données 1, correspondent à l’ordre dans lequel les compteurs de votre graphique sont affichés en bas du graphique. Par exemple, si l’utilisation de l’UC et l’utilisation de la mémoire sont affichées dans le premier et le deuxième ordre au bas du graphique, l’utilisation de l’UC est égale à l’ensemble de données 1 et l’utilisation de la mémoire est égale à l’ensemble de données 2.

Chaque fois que vous modifiez un rapport intégré, vous devez l’enregistrer en tant que rapport personnalisé pour conserver vos modifications.

Pour modifier le type de graphique d’un graphique

  1. Dans le volet gauche de l’outil Reporting, sélectionnez un rapport.
  2. Dans le volet droit, sous le graphique à afficher, dans la barre d’outils du graphique, cliquez sur Personnaliser.
  3. Sous l’onglet Graphique, sous Catégorie, cliquez sur Type de tracé, puis sur le type de graphique à afficher pour le graphique. Si vous souhaitez afficher le graphique en 3D, activez la case à cocher Utiliser 3D.

Pour recentrer un graphique avec des données détaillées

  1. Dans le volet gauche de l’outil Reporting, sélectionnez un rapport.
  2. Dans le volet droit, dans la barre d’outils du rapport, cliquez sur Zoom avant, puis effectuez l’une des opérations suivantes ou les deux :
    • Pour recentrer le graphique pour afficher les données d’une fenêtre horaire spécifique, faites glisser le curseur de l’heure de début à l’heure de fin. Par exemple, vous pouvez afficher des données pour une période d’une heure sur un jour donné.
    • Pour recentrer le graphique pour afficher les données d’un point de données, il suffit de cliquer une fois sur le graphique où vous souhaitez zoomer et obtenir des informations plus détaillées.
  3. Une fois que vous avez la plage de temps souhaitée pour afficher les données détaillées, dans la barre d’outils du rapport, cliquez sur Affichage tabulaire. La vue tabulaire affiche les données sous forme numérique sous forme de lignes et de colonnes.

Pour afficher les données numériques d’un graphique

  1. Dans le volet gauche de l’outil Reporting, sélectionnez un rapport.
  2. Dans le volet droit, dans la barre d’outils du rapport, cliquez sur Affichage tabulaire. Pour revenir à la vue graphique, cliquez sur Vue graphique.

    Remarque : Vous pouvez également afficher les données numériques dans la vue graphique en plaçant le curseur sur les encoches du quadrillage.

Pour faire défiler le temps dans un graphique

  1. Dans le volet gauche de l’outil Reporting, sélectionnez un rapport.
  2. Dans le volet droit, dans la barre d’outils du rapport, cliquez sur Défiler, puis sur l’intérieur du graphique et faites glisser le curseur dans la direction dans laquelle vous souhaitez afficher les données pour une nouvelle période. Par exemple, si vous souhaitez afficher des données dans le passé, cliquez et faites glisser vers la gauche.

Pour modifier la couleur d’arrière-plan et la couleur du texte d’un graphique

  1. Dans le volet gauche de l’outil Reporting, sélectionnez un rapport.
  2. Dans le volet droit, sous le graphique pour lequel vous souhaitez personnaliser les axes, cliquez sur Personnaliser.
  3. Sous l’onglet Graphique, sous Catégorie, cliquez sur une ou plusieurs des options suivantes :
    • Pour modifier la couleur d’arrière-plan, cliquez sur Couleur d’arrière-plan, puis sélectionnez les options de couleur, de transparence et d’effets.
    • Pour modifier la couleur du texte, cliquez sur Couleurdu texte, puis sélectionnez les options de couleur, de transparence et d’effets.

Pour personnaliser les axes d’un graphique

  1. Dans le volet gauche de l’outil Reporting, sélectionnez un rapport.
  2. Dans le volet droit, sous le graphique pour lequel vous souhaitez personnaliser les axes, cliquez sur Personnaliser.
  3. Sous l’onglet Graphique, sous Catégorie, cliquez sur une ou plusieurs des options suivantes :
    • Pour modifier l’échelle de l’axe Y gauche, cliquez sur Axe Y gauche, puis sélectionnez l’échelle souhaitée.
    • Pour modifier l’échelle de l’axe Y droit, cliquez sur Axe Y droit, dans Jeu de données à tracer, sélectionnez le jeu de dates, puis sélectionnez l’échelle souhaitée.

      Note : Les numéros des ensembles de données, tels que l’ensemble de données 1, correspondent à l’ordre dans lequel les compteurs de votre graphique sont affichés en bas du graphique. Par exemple, si l’utilisation de l’UC et l’utilisation de la mémoire sont affichées dans le premier et le deuxième ordre au bas du graphique, l’utilisation de l’UC est égale à l’ensemble de données 1 et l’utilisation de la mémoire est égale à l’ensemble de données 2.

    • Pour tracer chaque jeu de données dans son propre axe y masqué, cliquez sur plusieurs axes, puis cliquez sur Activer.

Pour modifier la couleur d’arrière-plan, la couleur d’arête et le quadrillage d’une zone de tracé d’un graphique

  1. Dans le volet gauche de l’outil Reporting, sélectionnez un rapport.
  2. Dans le volet droit, sous le graphique pour lequel vous souhaitez personnaliser la zone de tracé, cliquez sur Personnaliser.
  3. Sous l’onglet Zone de traçage, sous Catégorie, cliquez sur une ou plusieurs des options suivantes :
    • Pour modifier la couleur d’arrière-plan et la couleur d’arête du graphique, cliquez sur Couleur d’arrière-plan et couleur d’arête, puis sélectionnez les options de couleur, de transparence et d’effets.
    • Pour modifier les grilles horizontales ou verticales du graphique, cliquez sur Grilles horizontales ou Grillesverticales, puis sélectionnez les options d’affichage des grilles, de la largeur de la grille, de la couleur de la grille, de la transparence et des effets.

Pour modifier la couleur et le type de graphique d’un ensemble de données

  1. Dans le volet gauche de l’outil Reporting, sélectionnez un rapport.
  2. Dans le volet droit, sous le graphique pour lequel vous souhaitez personnaliser l’affichage du jeu de données (compteurs), cliquez sur Personnaliser.
  3. Sous l’onglet Jeu de données, dans Sélectionner un jeu de données, sélectionnez le jeu de données (compteur) pour lequel vous souhaitez personnaliser l’affichage graphique. Note : Les numéros des ensembles de données, tels que l’ensemble de données 1, correspondent à l’ordre dans lequel les compteurs de votre graphique sont affichés en bas du graphique. Par exemple, si l’utilisation de l’ UC et l’utilisation de la mémoire sont affichées dans le premier et le deuxième ordre au bas du graphique, l’utilisation de l’ UC est égale à l’ensemble de données 1 et l’utilisation de la mémoire est égale à l’ensemble de données 2.
  4. Sous Catégorie, effectuez l’une des opérations suivantes :
    • Pour modifier la couleur d’arrière-plan, cliquez sur Couleur, puis sélectionnez les options de couleur, de transparence et d’effets.
    • Pour modifier le type de graphique, cliquez sur Type de diagramme, puis sélectionnez le type de graphique à afficher pour le jeu de données. Si vous souhaitez afficher le graphique en 3D, activez la case à cocher Utiliser 3D.

Exportation de données de graphique vers Excel

Pour une analyse plus poussée des données, vous pouvez exporter des graphiques vers Excel dans un format CSV (valeur séparée par des virgules).

Pour exporter des données de graphique vers Excel

  1. Dans le volet gauche de l’outil Reporting, sélectionnez un rapport.
  2. Dans le volet droit, sous le graphique contenant les données à exporter vers Excel, cliquez sur Exporter.

Suppression d’un graphique

Si vous ne souhaitez pas utiliser de graphique, vous pouvez le supprimer du rapport. Vous pouvez supprimer définitivement des graphiques des rapports personnalisés uniquement. Si vous supprimez un graphique d’un rapport intégré et que vous souhaitez conserver les modifications, vous devez enregistrer le rapport en tant que rapport personnalisé.

Pour supprimer un graphique

  1. Dans le volet gauche de l’outil Reporting, sélectionnez un rapport.
  2. Dans le volet droit, sous le graphique à supprimer, cliquez sur l’icône Supprimer.

Exemples

Pour afficher le rapport de tendance pour l’utilisation de l’UC et de la mémoire pour la dernière semaine

  1. Dans le volet gauche de l’outil Rapports, sous Rapports intégrés, développez Système.
  2. Cliquez sur le rapport CPU vs. Utilisation de la mémoire et taux de requêtes HTTP.
  3. Dans le volet droit, dans la barre d’outils du rapport, cliquez sur Durée, puis sur Semaine dernière.

Pour comparer le taux d’octets reçus et le taux d’octets transmis entre deux interfaces au cours de la dernière semaine

  1. Dans le volet droit, dans la barre d’outils du rapport, cliquez sur Créer.
  2. Dans la zone Nom du rapport, tapez un nom pour le rapport personnalisé (par exemple, Custom_Interfaces), puis cliquez sur OK . Le rapport est créé avec le graphique Vue d’ensemble du système par défaut, qui affiche le compteur d’utilisation de l’UC tracé pour la dernière heure.
  3. Sous Vue d’ensemble du système, dans la barre d’outils du graphique, cliquez sur Compteurs.
  4. Dans le volet de sélection des compteurs, dans Titre, tapez un nom pour le graphique (par exemple, Interfaces octets data).
  5. Dans Graphique de tracé pour, cliquez sur Statistiques des entités système, puis dans Sélectionner un groupe, sélectionnez Interface.
  6. Sous l’onglet Entités, cliquez sur le ou les noms d’interface que vous souhaitez tracer (par exemple, 1/1 et 1/2), puis cliquez sur le bouton>.
  7. Sous l’onglet Compteurs, cliquez sur Octets reçus (Taux) et Octets transmis (Taux), puis cliquez sur le bouton>.
  8. Cliquez sur OK.
  9. Dans la barre d’outils du rapport, cliquez sur Durée, puis sur Semaine dernière.

Arrêt et démarrage de l’utilitaire de collecte de données

L’utilitaire de collecte de données, nscollect, s’exécute automatiquement lorsque vous démarrez Citrix ADC. Cet utilitaire récupère les données de performances de l’application et les stocke sous la forme de sources de données sur ADC. Vous pouvez créer jusqu’à 32 sources de données. La source de données par défaut est/var/log/db/default.

L’utilitaire de collecte de données crée des bases de données pour les compteurs globaux et les compteurs spécifiques à l’entité, et utilise ces données pour générer des rapports. Les bases de données Global-counter sont créées à/var/log/db/<DataSourceName> . Les bases de données spécifiques à l’entité sont créées en fonction des entités configurées sur Citrix ADC, et un dossier distinct est créé pour chaque type d’entité dans/var/log/db/<DataSourceName/EntityNameDB>.

NScollect récupère les données une fois toutes les 5 minutes. Il conserve les données en granularité de 5 minutes pendant un jour, toutes les heures pendant les 30 derniers jours et tous les jours pendant trois ans.

Vous devrez peut-être arrêter et redémarrer l’utilitaire de collecte de données si les données ne sont pas correctement mises à jour ou si les rapports affichent des données corrompues.

Pour arrêter nscollect

À l’invite de commandes, tapez :

/netscaler/nscollect stop

Pour démarrer nscollect sur la session SSH actuelle vers Citrix ADC :

À l’invite de commandes, tapez :

/netscaler/nscollect start

Pour démarrer nscollect sur le système local :

À l’invite de commandes, tapez :

/netscaler/nscollect start &