Citrix ADC

Affichage des objets mis en cache et des statistiques de cache

Vous pouvez afficher des objets mis en cache particuliers et afficher des statistiques récapitulatives sur les accès au cache, les échecs et l’utilisation de la mémoire. Les statistiques fournissent un aperçu de la quantité de données qui est servi à partir du cache, des éléments qui apportent le plus de gain en matière de performance et des éléments que vous pouvez régler pour améliorer les performances du cache.

Cette section comprend les détails suivants :

  • Affichage des objets mis en cache
  • Recherche de réponses mises en cache particulières
  • Affichage des statistiques du cache

Afficher les objets mis en cache

Après avoir activé la mise en cache, vous pouvez afficher les détails des objets mis en cache. Par exemple, vous pouvez afficher les éléments suivants :

  • Tailles de réponse et tailles d’en-tête
  • Codes d’état
  • Groupes de contenu
  • En-têtes ETag, Last Modified et Cache-Control
  • URL de demande
  • Paramètres d’accès
  • Adresses IP de destination
  • Délais de demande et de réponse

Pour afficher une liste d’objets mis en cache à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

show cache object

Propriétés Spécifications
Taille de la réponse (octets) Taille de l’en-tête et du corps de la réponse.
Taille de l’en-tête de réponse (octets) Taille de la partie d’en-tête de la réponse.
Code d’état de la réponse Code d’état envoyé avec la réponse.
ETag En-tête ETag inséré dans la réponse. En règle générale, cet en-tête indique si la réponse a changé récemment.
Last-Modified En-tête Last-Modified inséré dans la réponse. Cet en-tête indique la date à laquelle la réponse a été modifiée pour la dernière fois.
Cache-Control En-tête Cache-Control inséré dans la réponse.
Date En-tête Date qui indique quand la réponse a été envoyée.
Groupe de contenu Groupe de contenu dans lequel la réponse est stockée.
Correspondance complexe Si cet objet a été mis en cache sur la base de valeurs paramétrées, cette valeur de champ est OUI.
Hôte Hôte spécifié dans l’URL qui a demandé cette réponse.
Port hôte Port d’écoute de l’hôte spécifié dans l’URL qui a demandé cette réponse
URL URL émise pour la réponse stockée.
IP destination Adresse IP du serveur à partir duquel cette réponse a été récupérée.
Port de destination Port d’écoute du serveur de destination.
Paramètres d’accès Si le groupe de contenu qui stocke la réponse utilise des paramètres d’accès, ils sont répertoriés dans ce champ.
Sélecteur d’accès Si ce groupe de contenu utilise un sélecteur d’accès, il est répertorié dans ce champ.
Sélecteur inval Si ce groupe de contenu utilise un sélecteur d’invalidation, il est répertorié dans ce champ.
Expressions de sélecteur Si ce groupe de contenu utilise un sélecteur, ce champ affiche l’expression qui définit la règle de sélection.
Durée de la requête Durée en millisecondes depuis que la demande a été émise.
Temps de réponse Temps en millisecondes depuis que le cache a commencé à recevoir la réponse.
Âge Durée pendant laquelle l’objet a été dans le cache.
Expiration Durée après laquelle l’objet est marqué comme expiré.
Vidé Si la réponse a été vidé après expiration.
Prérécupération Si la fonction Prefetch a été configurée pour ce groupe de contenu, la durée avant l’expiration pendant laquelle l’objet est récupéré à partir de l’origine. Prefetch ne s’applique pas aux objets négatifs (par exemple, 404 réponses « objet introuvable »).
Lecteurs actuels Nombre actuel approximatif d’accès servis. Lorsqu’une réponse avec un objet d’en-tête Content-Length est en cours de téléchargement, les échecs actuels et les valeurs des lecteurs actuels sont généralement 1. Lorsqu’un objet de réponse fragmentée est téléchargé, la valeur d’erreur actuelle est généralement 1, mais la valeur des lecteurs actuels est généralement 0, car la réponse fragmentée qui est fournie au client ne provient pas des tampons de mise en cache intégrés.
Échecs actuels Nombre actuel de requêtes qui ont entraîné une absence de cache et une extraction à partir du serveur d’origine. Cette valeur est généralement 0 ou 1. Si l’option Interroger chaque fois est activée pour un groupe de contenus, le nombre peut être supérieur à 1.
Accès Nombre d’accès au cache pour cet objet.
Absences Nombre d’échecs de cache pour cet objet.
Format de compression Type de compression appliqué à cet objet. Les formats de compression incluent gzip, deflate, compress et pack200-gzip.
Version HTTP en réponse Version de HTTP utilisée pour envoyer la réponse.
etag faible présent dans la réponse Les en-têtes etag forts changent si les bits d’une entité changent. Les en-têtes forts sont basés sur les valeurs d’octet d’un objet. Les en-têtes etag faibles changent si la signification d’une entité change. Les valeurs d’etag faibles sont basées sur l’identité sémantique. Les valeurs d’etags faibles commencent par un « W. »
Cellule marqueur négatif Un objet marqueur peut être mis en cache, mais il ne répond pas encore à tous les critères pour être mis en cache. Par exemple, l’objet peut dépasser la taille de réponse maximale pour le groupe de contenus. Une cellule de marqueur est créée pour les objets de ce type. La prochaine fois qu’un utilisateur envoie une requête pour cet objet, une absence de cache est servie.
Marqueur de motif créé La raison pour laquelle une cellule de marqueur a été créée (par exemple, « En attente de minhit », « Les données de réponse Content-length ne sont pas dans la limite de taille du groupe »).
Sondage automatique à chaque fois Si le cache intégré reçoit une réponse 200 OK déjà expirée avec des validateurs (les en-têtes de réponse Last Modified ou ETag), il stocke la réponse et la marque comme Auto-PET (interroge automatiquement chaque fois).
Citrix ADC Etag inséré dans la réponse Variation de l’en-tête ETag généré par l’appliance Citrix ADC. La valeur YES s’affiche si Citrix ADC insère un Etag dans la réponse.
Réponse complète présente dans le cache Indique s’il s’agit d’une réponse complète.
IP de destination vérifiée par DNS Indique si la résolution DNS a été effectuée lors du stockage de l’objet.
Objet stocké via un proxy de transfert de cache Indique si cette réponse a été stockée en raison d’un proxy de transfert configuré dans le cache intégré.
L’objet est un fichier de base Delta Une réponse qui est compressée en delta.
En attente de minhits Indique si ce groupe de contenu nécessite un nombre minimum d’accès au serveur d’origine avant de mettre en cache une réponse.
Nombre de minhit Si ce groupe de contenu nécessite un nombre minimum d’accès au serveur d’origine avant de mettre en cache un objet, ce champ affiche le nombre de visites reçues jusqu’à présent.
Méthode de requête HTTP Méthode, GET ou POST, utilisée dans la requête qui a obtenu cet objet.
Stocké par stratégie Nom de la stratégie de mise en cache qui a provoqué le stockage de cet objet. La valeur NOT AVAILABLE indique que la stratégie a été désactivée ou supprimée. La valeur NONE indique que l’objet ne correspond pas à une stratégie visible, mais qu’il a été stocké selon des critères internes de mise en cache.
Des métadonnées de pare-feu d’application existent Ce paramètre est utilisé lorsque le pare-feu de l’application et le cache intégré sont tous les deux activés. Le pare-feu de l’application analyse le contenu d’une page de réponse, stocke ses métadonnées (par exemple, les URL et les formulaires contenus dans la page) et exporte les métadonnées avec la réponse dans le cache. Le cache stocke la page et les métadonnées, et lorsque le cache sert la page, il renvoie les métadonnées à la session de la requête.
Objet de légende HTTP, nom, type, réponse Ces cellules indiquent si ces données ont été stockées à la suite d’une expression de légende HTTP et fournissent des informations sur divers aspects de la légende et la réponse correspondante. Pour plus d’informations sur les légendes HTTP, voir « Légendes HTTP ».

Rechercher des réponses mises en cache particulières

Vous pouvez trouver des éléments individuels dans le cache en fonction de critères de recherche. Il existe différentes méthodes pour trouver les éléments mis en cache, selon que le groupe de contenu contenant les données utilise des sélecteurs d’accès et d’invalidation, comme suit :

Si le groupe de contenu utilise des sélecteurs, vous ne pouvez effectuer la recherche qu’à l’aide de l’ID de localisateur de l’élément mis en cache.

Si le groupe de contenu n’utilise pas de sélecteurs, vous effectuez la recherche en utilisant des critères tels que l’URL, l’hôte, le nom du groupe de contenu, etc.

Lorsque vous recherchez une réponse mise en cache, vous pouvez localiser certains éléments par URL et hôte. Si la réponse se trouve dans un groupe de contenu qui utilise un sélecteur, vous ne pouvez la trouver qu’à l’aide d’un numéro de localisateur (par exemple, 0x00000000ad7af00000050). Pour enregistrer un numéro de localisateur en vue d’une utilisation ultérieure, cliquez avec le bouton droit sur l’entrée et sélectionnez Copier. Pour plus d’informations sur les sélecteurs, consultez “Configuration des sélecteurs et des groupes de contenu de base.”

Pour afficher les réponses mises en cache dans des groupes de contenu qui n’ont pas de sélecteur à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

show cache object [-locator <positiveInteger>] | [(-url <URL> (-host <hostName> [-port <port>] [-groupName <contentGroupName>] [-httpMethod GET | POST ])) | [-httpStatus<positive integer>] | -group <contentGroupName> | -ignoreMarkerObjects (ON | OFF) | -includeNotReadyObjects (ON | OFF)]

Pour afficher les réponses mises en cache dans des groupes de contenu dotés d’un sélecteur à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

show cache object -locator <locatorString> MarkerObjects ( ON | OFF ) | -includeNotReadyObjects ( ON | OFF ) | [-httpStatus<positive integer>]

Pour afficher les réponses mises en cache dans des groupes de contenu qui n’ont pas de sélecteur à l’aide de l’ interface graphique graphique

Accédez à Optimisation > Mise en cache intégrée> Objets de cache, cliquez sur Rechercher et définissez les critères de recherche pour afficher la réponse mise en cache requise.

Si vous n’avez pas encore configuré de groupes de contenu, tous les objets se trouvent dans le groupe Par défaut.

Pour afficher les réponses mises en cache dans des groupes de contenu dotés d’un sélecteur à l’aide de l’interface graphique graphique

Accédez à Optimisation > Mise en cache intégrée > Objets de cache, cliquez sur Rechercher et définissez les critères de recherche du sélecteur pour afficher la réponse mise en cache requise.

Afficher les statistiques du cache

Le tableau suivant récapitule les statistiques du cache.

Compteur

Spécifications

Affichage des statistiques du cache

Mis à jour : 2013-10-28

Le tableau suivant récapitule les statistiques détaillées du cache que vous pouvez consulter.

Compteur Spécifie
Accès Réponses trouvées dans et servies à partir du cache intégré. Inclut des objets statiques tels que des fichiers image, des pages avec des codes d’état 200, 203, 300, 301, 302, 304, 307, 403, 404, 410 et des réponses qui correspondent à une stratégie définie par l’utilisateur avec une action CACHE.
Absences Requêtes HTTP interceptées où la réponse a finalement été récupérée à partir du serveur d’origine.
Demandes Nombre total d’accès au cache et nombre total d’échecs de cache.
Accès non-304 Si l’utilisateur demande un élément plusieurs fois et que l’élément du cache est inchangé depuis la dernière fois que l’appliance Citrix ADC l’a servi, l’appliance Citrix ADC fournit une réponse 304 au lieu de l’objet mis en cache. Cette statistique indique le nombre d’éléments que l’appliance Citrix ADC a servis à partir du cache, à l’exclusion des réponses 304.
304 accès Nombre de 304 réponses (objet non modifié) fournies par l’appliance Citrix ADC à partir du cache.
Taux de succès 304 (%) Pourcentage de 304 réponses fournies par l’appliance Citrix ADC, par rapport aux autres réponses.
Taux de succès (%) Pourcentage de réponses fournies par l’appliance Citrix ADC à partir du cache (accès au cache) par rapport aux réponses qui n’ont pas pu être fournies à partir du cache.
Bande passante d’origine enregistrée (%) Estimation de la capacité de traitement enregistrée par l’appliance Citrix ADC sur le serveur d’origine en raison du service de réponses provenant du cache.
Octets servis par Citrix ADC Nombre total d’octets que l’appliance Citrix ADC a servis à partir du serveur d’origine et du cache.
Octets servis par le cache Nombre total d’octets que l’appliance Citrix ADC a servis à partir du cache.
Taux d’octets de succès (%) Pourcentage de données fournies par l’appliance Citrix ADC à partir du cache, par rapport à toutes les données de toutes les réponses envoyées.
Octets compressés à partir du cache Quantité de données, en octets, que l’appliance Citrix ADC a servi sous forme compressée.
Ravages de stockage Si l’appliance Citrix ADC ne trouve pas d’objet demandé dans le cache, il récupère l’objet à partir du serveur d’origine. Ceci connu sous le nom de « cache miss » (échec d’accès au cache). Une absence de cache stockable peut être stockée dans le cache.
Échecs non stockables Un défaut de mémoire cache non stockable ne peut pas être stocké dans le cache.
Absences Toutes les absences du cache.
Revalidations Le paramètre Max-Age dans un en-tête Cache-Control détermine, en nombre de secondes, lorsqu’un cache intermédiaire doit revalider le contenu avec le cache intégré avant de le diffuser à l’utilisateur. Pour plus d’informations, voir “Insertion d’un en-tête de contrôle de cache”.
Revalidations réussies Nombre de revalidations effectuées. Pour plus d’informations, voir “Insertion d’un en-tête de contrôle de cache”.
Conversions en demande conditionnelle Une demande d’agent utilisateur pour un objet PET mis en cache est toujours convertie en requête conditionnelle et envoyée au serveur d’origine. Pour plus d’informations, reportez-vous à la section “Interroger le serveur d’origine chaque fois qu’une demande est reçue.”
Tau d’échec de cache stockables (%) Nombre d’échecs de cache stockable en pourcentage des échecs de cache non stockable.
Taux de reprise réussi (%) Revalidations réussies en pourcentage de toutes les tentatives de revalidation. Pour plus d’informations, voir “Insertion d’un en-tête de contrôle de cache”.
Expire au dernier octet Nombre de fois où le cache a expiré le contenu immédiatement après avoir reçu le dernier octet corporel. Ne s’applique qu’aux réponses positives, comme décrit dans le tableau « Accès au cache et échecs. « Pour plus d’informations, consultez « Exemple d’optimisation des performances. »
manque de Flashcache Si vous activez Flash Cache, le cache n’autorise qu’une seule requête pour atteindre le serveur, éliminant ainsi les foules flash. Cette statistique indique le nombre de requêtes Flash Cache qui se sont soldées par des échecs d’accès au cache. Pour plus d’informations, « Queuing Requests to the Cache ».
Résultats Flashcache Nombre de requêtes Flash Cache qui ont été des accès au cache. Pour plus d’informations, voir « Queuing Requests to the Cache ».
Demandes inval paramétrées Demandes qui correspondent à une stratégie avec une action d’invalidation (INVAL) et un groupe de contenu qui utilise un sélecteur d’invalidation ou des paramètres pour expirer sélectivement les objets mis en cache dans le groupe.
Demandes d’inval complètes Demandes qui correspondent à une stratégie d’invalidation dans laquelle le paramètre InvalGroups est configuré et expire un ou plusieurs groupes de contenu.
Demandes inval Demandes qui correspondent à une stratégie d’invalidation et entraînent l’expiration de réponses mises en cache spécifiques ou de groupes de contenu entiers.
Demandes paramétrées Nombre de demandes de cache traitées à l’aide d’une stratégie avec un groupe de contenu paramétré.
Résultats paramétrés non 304 Nombre de demandes de cache traitées à l’aide d’une stratégie avec un groupe de contenu paramétré, où une réponse mise en cache complète a été trouvée et où la réponse n’était pas une réponse 304 (objet non mis à jour).
304 résultats paramétrés Nombre de demandes de cache traitées à l’aide d’une stratégie avec un groupe de contenu paramétré, où l’objet mis en cache a été trouvé et où l’objet était une réponse 304 (objet non mis à jour).
Nombre total de résultats paramétrés Nombre de requêtes de cache traitées à l’aide d’une stratégie avec un groupe de contenu paramétré, où l’objet mis en cache a été trouvé.
Taux de succès paramétré 304 ( %) Pourcentage de 304 réponses (objet non mis à jour) trouvées à l’aide d’une stratégie paramétrée, par rapport à tous les accès au cache.
Sondage à chaque demande Si l’option Poll chaque fois est activée, l’appliance Citrix ADC consulte toujours le serveur d’origine avant de servir un objet stocké. Pour plus d’informations, reportez-vous à la section “Interroger le serveur d’origine chaque fois qu’une demande est reçue.”
Sondage à chaque fois que des visites Nombre de fois qu’un accès au cache a été trouvé à l’aide de la méthode Poll Every Time. Pour plus d’informations, reportez-vous à la section “Interroger le serveur d’origine chaque fois qu’une demande est reçue.”
Sondage à chaque fois que le taux de succès ( %) Pourcentage d’accès au cache à l’aide de la méthode Poll Every Time, par rapport à toutes les recherches d’objets mis en cache à l’aide de l’option Poll Every Time. Pour plus d’informations, reportez-vous à la section “Interroger le serveur d’origine chaque fois qu’une demande est reçue.”
Mémoire maximale (Ko) Quantité maximale de mémoire allouée au cache dans l’appliance Citrix ADC. Pour plus d’informations, reportez-vous à “Configuration des attributs globaux pour la mise en cache.”
Valeur maximale de la mémoire active (Ko) Quantité maximale de mémoire (valeur active) qui sera définie après que la mémoire est réellement allouée au cache. Pour plus d’informations, reportez-vous à “Procédure de configuration de la fonctionnalité de mise en cache intégrée d’une appliance Citrix ADC pour différents scénarios.”
Mémoire utilisée (Ko) Quantité de mémoire réellement utilisée.
Échecs d’allocation de mémoire Nombre de tentatives d’utilisation de la mémoire dans le but de stocker une réponse dans le cache.
Réponse la plus importante à ce jour Réponse la plus importante en octets trouvés dans le cache ou le serveur d’origine et envoyée au client.
Objets mis en cache Nombre d’objets dans le cache, y compris les réponses qui n’ont pas encore été entièrement téléchargées et les réponses qui ont expiré mais qui n’ont pas encore été virées.
Objets marqueurs Les objets marqueurs sont créés lorsqu’une réponse dépasse la taille de réponse maximale ou minimale du groupe de contenus ou n’a pas encore reçu le nombre minimum de résultats pour le groupe de contenus.
Succès en cours de service Nombre d’accès qui ont été servis à partir du cache.
Manque en cours de traitement Réponses récupérées à partir du serveur d’origine, stockées dans le cache, puis servies. Devrait évaluer le nombre approximatif d’échecs stockables. N’inclut pas les échecs non stockables.

Pour afficher les statistiques du cache récapitulatif à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

stat cache

Pour afficher des statistiques de cache spécifiques à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

stat cache -detail

    > stat cache -detail
    Integrated Cache Statistics - Detail
    Integrated Cache Statistics - Summary
                                              Rate (/s)                Total
    Hits                                               0                    0
    Misses                                             0                    0
    Requests                                           0                    0
    Hit ratio(%)                                      --                    0
    Origin bandwidth saved(%)                         --                    0
    Cached objects                                    --                    0
    Marker objects                                    --                    0
                                              Rate (/s)                Total
    Requests                                           0                    0
    Hit Statistics
                                              Rate (/s)                Total
    Non-304 hits                                       0                    0
    304 hits                                           0                    0
    Sql hits                                           0                    0
    Hits                                               0                    0
    304 hit ratio(%)                                  --                    0
    Hit ratio(%)                                      --                    0
    Origin bandwidth saved(%)                         --                    0

    Byte Statistics
                                              Rate (/s)                Total
    Bytes served by Citrix ADC                        648             55379204
    Bytes served by cache                              0                    0
    Byte hit ratio(%)                                 --                    0
    Compressed bytes from cache                        0                    0
    Miss Statistics
                                              Rate (/s)                Total
    Storable misses                                    0                    0
    Non-storable misses                                0                    0
    Misses                                             0                    0
    Revalidations                                      0                    0
    Successful revalidations                           0                    0
    Conversions to conditional req                     0                    0
    Storable miss ratio(%)                            --                    0
    Successful reval ratio(%)                         --                    0
    Flashcache Statistics
                                              Rate (/s)                Total
    Expire at last byte                                0                    0
    Flashcache misses                                  0                    0
    Flashcache hits                                    0                    0

    Invalidation Statistics
                                              Rate (/s)                Total
    Parameterized inval requests                       0                    0
    Full inval requests                                0                    0
    Inval requests                                     0                    0

    Parameterized Caching Statistics
                                              Rate (/s)                Total
    Parameterized requests                             0                    0
    Parameterized non-304 hits                         0                    0
    Parameterized 304 hits                             0                    0
    Total parameterized hits                           0                    0
    Parameterized 304 hit ratio(%)                    --                    0

    Poll Every Time (PET) Statistics
                                              Rate (/s)                Total
    Poll every time requests                           0                    0
    Poll every time hits                               0                    0
    Poll every time hit ratio(%)                      --                    0
    Memory Usage Statistics
                                                  Total
    Maximum memory(KB)                                 0
    Maximum memory active value(KB)                    0
    Utilized memory(KB)                                0
    Memory allocation failures                         0
    Largest response so far(B)                         0
    Cached objects                                     0
    Marker objects                                     0
    Hits being served                                  0
    Misses being handled                               0
     Done

Pour afficher les statistiques de cache récapitulatif à l’aide de l’interface graphique

  1. Cliquez sur l’onglet Tableau de bord en haut de la page.
  2. Faites défiler la page jusqu’à la section Mise en cache intégrée de la fenêtre.
  3. Pour afficher des statistiques détaillées, cliquez sur le lien Plus… au bas du tableau.

Pour afficher des statistiques de cache spécifiques à l’aide de l’interface graphique

  1. Cliquez sur l’onglet Rapports en haut de la page.
  2. Sous Rapports intégrés, développez Cache intégré, puis cliquez sur le rapport contenant les statistiques à afficher.
  3. Pour enregistrer le rapport en tant que modèle, cliquez sur Enregistrer sous et nommez le rapport. Le rapport enregistré apparaît sous Rapports personnalisés.

Affichage des objets mis en cache et des statistiques de cache