Informations de référence › Manuel de référence du catalogue d'appliance › Catalogue système › Appliances de surveillance › MON : Appliance de surveillance de l'application

MON : Appliance de surveillance de l'application

Dernière version : 3.0.3-1

Présentation fonctionnelle

MON est une appliance de surveillance de l'application qui collecte des statistiques de performances et d'utilisation des ressources (c'est-à-dire, compteurs) à partir d'autres appliances dans une application. Les appliances signalent leurs compteurs à MON via le terminal MON.

MON fournit une interface visuelle qui utilise un navigateur Web pour accéder et afficher des compteurs d'appliance. L'interface visuelle vous permet de créer des vues contenant un ou plusieurs graphiques. Chaque graphique affiche un ou plusieurs compteurs d'appliance. Accédez à l'interface visuelle en procédant comme suit :

• L'interface utilisateur graphique CA AppLogic
  • Un bouton Surveiller dans la barre d'outils de l'onglet Applications du tableau de bord
  • Une icône Surveiller dans la barre d'outils de l'éditeur d'applications
• Une passerelle (In ou INSSLR) connectée au terminal Web de MON

Pour plus d'informations sur l'accès et l'utilisation de l'interface visuelle, reportez-vous au Manuel de référence de l'interface utilisateur.

MON prend également en charge la surveillance en arrière-plan des compteurs d'appliance. Tous les compteurs dans une vue unique, tels que spécifiés par la propriété alarm_view, sont surveillés en arrière-plan par MON. Lorsqu'un de ces compteurs tombe sous un certain seuil ou le dépasse, MON génère une alarme dans le contrôleur de grille de CA AppLogic qui publie un message dans le tableau de bord. Il n'est pas nécessaire qu'un navigateur vers l'interface visuelle de MON soit ouvert pour que MON surveille les compteurs d'appliance en arrière-plan.

Ressources

Terminaux

L'interface par défaut est activée. L'appliance utilise l'interface par défaut pour signaler à CA AppLogic qu'elle a correctement démarré. Vous pouvez également l'utiliser pour vous connecter à l'appliance via un shell sécurisé à partir du contrôleur CA AppLogic, essentiellement à des fins de diagnostic et de dépannage. L'interface par défaut est utilisée par l'interface utilisateur graphique de CA AppLogic pour accéder à l'interface visuelle d'une appliance MON.

Volumes d'utilisateur

Propriétés

Messages d'erreur

Les messages suivants peuvent s'afficher dans le fichier journal de l'appliance ou dans le journal système du contrôleur de grille lorsque l'appliance ne parvient pas à démarrer :

• failed to mount data volume
• httpd did not start

Compteurs et groupes de compteur

Les groupes de compteurs suivants sont définis pour toutes les appliances :

• Récapitulatif d'UC
• n UC (uniquement en présence de plusieurs UC -- dans le cas contraire, aucun groupe de ce type)
• Planificateur
• Statistiques de mémoire
• Système de fichiers
• Nom de l'interface (un groupe par interface : terminaux ou bruts)
• Nom de volume (un groupe par volume, y compris la classe et les espaces réservés)

Reportez-vous à la section Création de compteurs personnalisés pour savoir comment créer et surveiller des compteurs personnalisés dans une appliance.

Surveillance des applications à l'aide de l'interface utilisateur graphique CA AppLogic

Le diagramme suivant affiche une utilisation standard de MON pour une application simple. Dans cette application, la surveillance est uniquement accessible via l'interface utilisateur graphique de CA AppLogic.

Appliances en cours d'utilisation :

• in - Passerelle d'entrée, classe IN
• srv - serveur Web, classe WEB5
• db - serveur de base de données, classe MYSQL5
• MON - Appliance de surveillance, classe MON

Le terminal mon de toutes les appliances est connecté au terminal mon de MON.

Surveillance de l'application par le biais de deux interfaces utilisateur graphiques CA AppLogic et une adresse IP sur le port 80

Le diagramme suivant affiche l'utilisation de MON pour accéder à la surveillance de l'application à l'aide de l'interface utilisateur graphique de CA AppLogic ou d'une adresse IP.

Appliances en cours d'utilisation :

• usr - passerelle d'entrée, classe IN
• admin - passerelle d'entrée, classe IN
• srv - serveur Web, classe WEB5
• db - serveur de base de données, classe MYSQL5
• MON - Appliance de surveillance, classe MON

Le terminal mon de toutes les appliances est connecté au terminal mon de MON.

Le terminal out d'admin est connecté au terminal web de MON pour que les utilisateurs puissent accéder à la surveillance via l'adresse IP spécifiée par la propriété ip_addr sur admin.

Surveillance des applications par le biais de deux interfaces utilisateur graphiques CA AppLogic et une adresse IP d'application sur le port 8080

Le diagramme suivant affiche l'utilisation de MON pour accéder à la surveillance de l'application à l'aide de l'interface utilisateur graphique de CA AppLogic ou de l'adresse IP d'une application sur le port 8080.

Appliances en cours d'utilisation :

• INSSLR - Passerelle d'entrée, classe INSSLR
• WEBx8 - Assemblage de serveurs Web, classe WEBx8
• MYSQL - Serveur de base de données, classe MYSQL5
• NAS - Appliance de stockage, classe NAS
• PS8 - Commutateur de port, classe PS8
• mail - Serveur de messagerie, classe MAIL
• NET - Passerelle de sortie, classe NET
• MON - Appliance de surveillance, classe MON

Le terminal mon de toutes les appliances est connecté au terminal mon de MON.

INSSLR est configuré pour transférer le trafic https vers WEBx8 et le reste du trafic TCP vers le terminal aux. PS8 est configuré pour transférer tout le trafic sur le port 8080 via out8 vers le terminal web de MON. De cette manière, les utilisateurs peuvent surveiller l'application à l'aide de l'adresse IP d'application spécifiée par la propriété ip_addr sur INSSLR sur le port 8080.

Remarque : L'appliance MAIL n'est pas distribuée avec CA AppLogic.

Surveillance d'arrière-plan

Ce cas d'utilisation décrit comment utiliser MON pour surveiller les compteurs d'appliance en arrière-plan et leur faire générer des alertes lorsqu'un compteur d'appliance se trouve en dehors de la plage.

1. Définissez la propriété alarm_view de MON sur le nom d'une vue qui contient les compteurs à surveiller.
2. (Re)démarrez l'application.
3. Connectez-vous à Application Monitor.
4. Cliquez sur le bouton New (Nouveau) pour créer une nouvelle vue et lui donner le même nom que la propriété alarm_view.
5. Cliquez sur le bouton Ajouter un graphique pour créer un nouveau graphique et l'ajouter à la vue.
6. Sélectionnez un compteur à surveiller et ajoutez-le au graphique.
7. Définissez le seuil d'alarme en complétant les deux champs en regard d'alarme.
   Pour définir un seuil minimum, introduisez une valeur dans la zone de texte à gauche. Aucun seuil minimum n'existe si cette zone de texte reste vide.
   Pour définir un seuil maximum, introduisez une valeur dans la zone de texte à droite. Aucun seuil maximum n'existe si cette zone de texte reste vide.
8. Répétez les étapes 5 à 7 pour surveiller d'autres compteurs d'appliance.

Lorsqu'un compteur d'appliance tombe sous le seuil spécifié ou le dépasse, MON génère une alerte sur le contrôleur de CA AppLogic. Un message est alors consigné dans le tableau de bord et indique le compteur de l'appliance qui est en dehors de la plage. Pour chaque appliance, le contrôleur CA AppLogic consigne uniquement la dernière alerte dans le tableau de bord. Toutefois, il spécifie dans le message du tableau de bord si plusieurs alertes ont été reçues pour l'appliance. Toutes les alertes sont consignées dans le répertoire /var/journal/messages sur le contrôleur de CA AppLogic.

Remarque : Il n'est pas nécessaire qu'un navigateur d'Application Monitor soit ouvert pour que MON surveille les compteurs d'appliance en arrière-plan.

Pour arrêter la surveillance d'un compteur d'appliance spécifique :

• Si le compteur est le seul compteur sur le graphique, supprimez le graphique.
• Si le compteur est sur un graphique comportant plusieurs compteurs, supprimez le compteur du graphique.

Pour désactiver la surveillance en arrière-plan, effectuez l'une des opérations suivantes :

• Renommez la vue avec un autre nom que celui de la propriété alarm_view sur MON.
• Supprimez tous les graphiques de la vue.
• Supprimez la vue.
• Arrêtez l'appliance MON dans l'application (par exemple, comp stop myapp:main.mon).
• Effacez la propriété alarm_view de MON et redémarrez l'instance MON (ou redémarrez l'application).

Interface de collecte de données

Depuis la version 1.1.3, l'appliance MON fournit une API de collecte de données de type service REST, elle exporte la configuration du compteur et les valeurs aux formats XML, JSON et UDL. Pour plus d'informations sur l'API, visitez le site Web MonDataCollectionInterface.

Commentaires

Limitations connues

Pour surveiller une application via l'interface utilisateur graphique CA AppLogic, le nom de l'appliance MON dans l'application doit être MON.

Logiciels Open Source et tiers utilisés au sein de l'appliance

Compteurs d'appliance

Présentation

Ce document définit la liste de tous les compteurs standard exportés par CCA. CCA est l'agent de collection des compteurs qui s'exécute sur toutes les appliances CA AppLogic. CCA permet de signaler les compteurs à l'interface utilisateur graphique de surveillance présente dans l'appliance MON. La disponibilité de ces compteurs peut être limitée sur certaines des plates-formes d'appliance prises en charge (comme indiqué dans la table de compteurs ci-dessous). Lorsque le système d'exploitation de l'appliance prend en charge un compteur donné, il doit être visible dans l'interface utilisateur graphique MON lorsque le terminal de sortie MON de l'appliance est connecté à l'appliance MON.

Récapitulatif d'UC

Système de fichiers

Statistiques de mémoire

Planificateur

UC X

Volume X

Terminal X

Présentation

Chaque appliance exécutant le démon ccad (agent de collecte de compteurs) permet de définir des compteurs personnalisés et de les faire collecter par des utilitaires tiers. Cette capacité s'appelle interface d'extension et fournit aux créateurs d'appliance la possibilité de surveiller des données de compteur spécifiques à l'appliance via l'interface utilisateur MON standard.

Création de compteurs personnalisés

Pour surveiller des compteurs personnalisés, vous devez ajouter les définitions de compteurs à la configuration ccad et indiquer les valeurs de compteur réelles sur ccad.

Ajout de définitions de compteur

Les compteurs personnalisés doivent être définis dans le fichier de configuration facultatif /etc/ccad.conf (au format UDL). Lorsque vous apportez des modifications à la configuration, le démon ccad doit être redémarré pour prendre en compte les modifications.

Voici un exemple de configuration simple :

counters Apache
   {
   pace = 1000
   pipe = /tmp/cca
   counter Total_Accesses
      {
      name        = "Total hits"
      desc        = "Total number of hits"
      units       = "#"
      type        = "MAX"
      }
   counter Total_kBytes
      {
      name        = "Total bytes"
      desc        = "Total number of bytes"
      units       = "bytes"
      type        = "MAX"
      }
   counter BusyWorkers
      {
      name        = "Active requests"
      desc        = "Number of active requests"
      units       = "#"
      type        = "MAX"
      }
   counter IdleWorkers
      {
      name        = "Idle servers"
      desc        = "Number of idle servers"
      units       = "#"
      type        = "MAX"
      }
   }

Cet exemple définit 4 compteurs. Chaque entité de compteur prend en charge les attributs suivants :

• name - Nom du compteur lisible par l'utilisateur (valeur définie par défaut sur le nom d'entité du compteur).
• desc - Description du compteur lisible par l'utilisateur (valeur vide par défaut).
• type - Type de compteur (SUM, AVG, MIN ou MAX. L'option par défaut est AVG.)
• units - Unités dans lesquelles les valeurs de compteur doivent être interprétées (valeur vide par défaut).
• range_lower - La plus petite valeur possible de ce compteur (Les valeurs inférieures seront ignorées.)
• range_upper - La plus grande valeur possible de ce compteur (Les valeurs supérieures seront ignorées.)
• alarm_below - La plus petite valeur de compteur qui ne déclenchera pas d'alarme. (Les valeurs inférieures déclenchent une alarme.)
• alarm_above - La plus grande valeur de compteur qui ne déclenchera pas d'alarme. (Les valeurs supérieures déclenchent une alarme.)

Lorsque les compteurs s'affichent ensuite dans MON, le nom d'entité utilisé est celui qui s'affiche dans les compteurs au niveau de la racine. Par ailleurs, les attributs suivants sont pertinents pour cette entité :

• pace - Vitesse (en millisecondes) de la collecte de compteurs personnalisés. (1000 est la valeur par défaut si aucune valeur n'est spécifiée.)
• pipe - Chemin d'accès au canal nommé utilisé pour la collecte (/tmp/cca est la valeur par défaut si aucune valeur n'est spécifiée.)

En plus de la méthode de définition des compteurs décrite ci-dessus, ccad.conf permet le regroupement des compteurs. Cette opération est effectuée en les plaçant à un niveau inférieur dans des entités de groupe comme dans l'exemple suivant :

counters Plants
   {
   pace = 2000
   pipe = /my-pipe
   counter tree: desc = "Any tree" , units = "#"
   group Fruits
      {
      desc = "Delicious Fruits!!!"
      counter pears : desc = "Number of pears"   , units = "pears"
      counter apples: desc = "Number of apples"  , units = "apples"
      }
   group Vegetables
      {
      counter potato: desc = "Number of potatoes", units = "potatoes"
      counter tomato: desc = "Number of tomatoes", units = "tomatoes"
      }
   }

Cette configuration produit 3 entités de compteur personnalisées dans l'interface utilisateur graphique de MON : Plants, Delicious Fruits et Vegetables. Les 5 compteurs définis sont distribués entre eux. A l'instar des entités de compteur, les groupes prennent en charge un attribut desc qui permet d'attribuer un nom de groupe plus complet par opposition au nom d'entité du groupe qui lui est plus restreint. Les noms de compteur doivent être uniques dans le fichier de configuration, faute de quoi la collecte de compteur est impossible pour les noms de compteur en double.

Alimentation des données de compteur

Lorsque ccad s'exécute avec les définitions de compteur appropriées, vous devez indiquer les valeurs de compteur réelles. Pour ce faire, écrivez les valeurs de compteur dans le canal nommé créé par ccad (spécifié par l'attribut de canal dans le fichier enregistré sous /etc/ccad.conf, valeur par défaut /tmp/cca).
Le format approprié est l'un des suivants :

counter = value (Le nom et la valeur sont séparés par le signe =)

counter = value (Le nom et la valeur sont séparés par :)
Un ensemble de compteurs doit être vidé (sur MON) en imprimant un point (.) ou en formant lui-même un caractère de saut de ligne (\f) dans le canal nommé sur une ligne. Un script de collecte de compteur (dans un bash) peut procéder comme suit pour alimenter le compteur sur ccad :

echo "Total_Accesses = 31" > /tmp/cca
echo "Total_kBytes = 22241" > /tmp/cca
echo "BusyWorkers = 6" > /tmp/cca
echo "IdleWorkers = 34" > /tmp/cca
echo "." > /tmp/cca

Cette opération doit être effectuée à la vitesse en millisecondes spécifiée dans /etc/ccad.conf

Voici une boucle en bash simple qui collecte les données requises et les insère dans ccad. Le nombre de données reçues par ccad est supérieur à celui requis car il est plus rapide de transférer toutes les données collectées à ccad (qui ignore les lignes qui ne sont pas des valeurs de compteur) que d'analyser les données avant de le fournir à ccad :

while true; do
   curl -s http://in/server-status?auto | sed "s/^Total\ /Total_/g" > /tmp/cca # Cette commande analyse les données pour les faire correspondre aux définitions de compteur
   sleep 1 || exit 4        
   echo "." > /tmp/cca
done

Exemples

Exemple pour Windows

L'exemple suivant de compteur Windows personnalisé utilise Perl.  Pour installer le package Win32 de Perl sur une appliance Windows gérée, si Perl n'est pas déjà présent :

• Copiez le programme d'installation de ligne de commande héritée Cygwin sur l'appliance.  Vous pouvez le télécharger à partir de http://www.cygwin.com/setup-legacy.exe
• Copiez le package Win32 de la version 0.27 de Perl sur l'appliance (par exemple, sur c:\local_cygwin_pkg).  Vous pouvez télécharger ce package à partir de plusieurs sources dont : http://cygwin.basemirror.de/release-legacy/perl/perl-libwin32/perl-libwin32-0,27-1.tar.bz2
• Installez le package Win32 de Perl.  Dans un shell de commande de la console graphique de l'appliance, exécutez :  setup-legacy.exe -q -n -N -d -R c:\cygwin -l c:\local_cygwin_pkg -L

Exemple de code :

#!/bin/perl
use Win32::Pipe;

my $defaultPace=1000;
my $defaultPipe="\\\\.\\pipe\\cca";
my $ccadConf="/etc/ccad.conf";

sub get_value_from_config
   {
   open(F, $ccadConf) || die "can't open $ccadConf: $!\n";
   while(<F>)
      {
      #($name, $value) = split('=');
      my $row=$_;
      $row =~ m/^\s*(\w+)\s*=\s*(.*)\s*$/;
      if ($_[0] eq $1)
         {
         close F;
         return $2;
         }
      }
   close F;
   return "";
   }

my $cfgPace = &get_value_from_config("pace");
my $cfgPipe = &get_value_from_config("pipe");
if ($cfgPace eq "") { $cfgPace = $defaultPace; }
if ($cfgPipe eq "") { $cfgPipe = $defaultPipe; }
else { $cfgPipe = "\\\\.\\pipe\\".$cfgPipe; }

my $pipe;
$pipe = new Win32::Pipe($cfgPipe) || die "can't connect to pipe\n";
$pipe->ResizeBuffer(4096);

# cette boucle alimente un compteur appelé Test avec une valeur qui augmente à chaque itération
my $val = 0;
while (1)
{  
   $val ++;
   my $str = "Test = $val\n.";
   $pipe->Write( $str );
   sleep( $cfgPace / 1000 );
   }

Exemples Linux

Apache

Remarque : Le statut étendu (extended status) doit être activé pour le serveur.

#!/bin/bash

DEFAULT_PACE=1000
DEFAULT_PIPE=/tmp/cca
CCAD_CONF=/etc/ccad.conf
STATUS_URL='http://in/server-status?auto'
CURL=/usr/bin/curl
SED=/bin/sed
SLEEP=/bin/sleep
function get_value_from_config {
   CONF_VALUE=`grep -oE "$1[[:space:]]*=[[:space:]]*[^[:space:]]+" $CCAD_CONF |cut -d"=" -f 2|tr -d " "`
}
get_value_from_config "pace"
PACE=${CONF_VALUE:-$DEFAULT_PACE}
PACE=$(( $PACE / 1000))
get_value_from_config "pipe"
PIPE=${CONF_VALUE:-$DEFAULT_PIPE}
test -p $PIPE || exit 3
while true; do
   $CURL -s "$STATUS_URL" | $SED "s/^Total\ /Total_/g" > $PIPE
   sleep $PACE || exit 4
   echo "." > $PIPE
done

Mysql

#!/bin/bash

DEFAULT_PACE=1000
DEFAULT_PIPE=/tmp/cca
CCAD_CONF=/etc/ccad.conf
MYSQL='/usr/bin/mysql'
TR=/usr/bin/tr
SLEEP=/bin/sleep
function get_value_from_config {
   CONF_VALUE=`grep -oE "$1[[:space:]]*=[[:space:]]*[^[:space:]]+" $CCAD_CONF |cut -d"=" -f 2|tr -d " "`
}
get_value_from_config "pace"
PACE=${CONF_VALUE:-$DEFAULT_PACE}
PACE=$(( $PACE / 1000))
get_value_from_config "pipe"
PIPE=${CONF_VALUE:-$DEFAULT_PIPE}
test -p $PIPE || exit 3
while true; do
   $MYSQL -e 'show status'|$TR '[[:blank:]]' '=' > $PIPE
   $SLEEP $PACE || exit 4
   echo "." > $PIPE
done

Présentation de l'API de surveillance

L'appliance MON exporte les données de compteur et de configuration collectées auprès des appliances connectées sur son terminal de sortie auxiliaire. Cela s'effectue via le protocole REST personnalisé, qui s'exécute sur HTTP. Ce protocole définit 3 types de ressources :

• Appliances
• Entités
• Compteurs

Chacun de ces types est intégré dans la portée du précédent. Cela signifie que les entités ne sont pertinentes que dans la portée des appliances et que les compteurs n'ont de sens que dans la portée d'une entité particulière. L'API de collecte de données permet de récupérer toutes les valeurs et les configurations de compteur connues de MON.

MON exporte les configurations de données et valeurs demandées dans un des formats de texte structurés suivants :

• XML (format principal utilisé si aucun format spécifique n'est demandé via l'argument fmt)
• UDL (pour une utilisation interne dans CA AppLogic)
• JSON (pour les clients de navigateur JavaScript)

Protocole de l'API de surveillance

Le protocole utilise uniquement la méthode GET HTTP, puisqu'il offre seulement une fonctionnalité de lecture. Ainsi, tous les types de requêtes de protocole pris en charge peuvent être définis au moyen de leur URI et de la structure de sortie. Les caractères considérés comme spéciaux pour l'URI doivent être échappés à l'aide du codage standard %. La sortie se définit par son schéma XML (le format de sortie principal est XML). La conversion dans d'autres formats de sortie (UDL, JSON) est obtenue par l'utilisation directe des moyens d'expression de la structure et des attributs du format de sortie respectif (par exemple entités UDL/ entités XML, attributs UDL/ attributs XML, objets JSON/ entités XML, propriétés d'objet JSON/ attributs XML).

Le noeud racine de toutes les sorties contient l'attribut d'horodatage qui indique l'heure du serveur au moment de la création de la réponse.

Vous trouverez ci-dessous une description de toutes les URL prises en charge (appels).

Appels de configuration de compteur

/monapi/desc[?fmt=<format>] 

Renvoie une liste de toutes les appliances disponibles dans un format de sortie spécifié (<format> est l'un des formats de sortie connus, par exemple XML).

Sortie :

<response timestamp="1194967464">
   <appliance name="main.web" />
   <appliance name="main.in" />
</response>

/monapi/desc/<apps>[?fmt=<format>] 

Renvoie la liste de toutes les entités disponibles dans les appliances demandées (<apps>). <Apps> peut être un nom d'appliance unique, une liste séparée par des virgules de noms d'appliance ou un caractère générique (*) qui signifie que toutes les appliances sont disponibles.

Sortie :

<response timestamp="1194967464">
   <appliance name="main.web">
      <entity name="Terminal in" />
      <entity name="Terminal out" />
      <entity name="Volume data" />
      <entity name="CPU" />
      <entity name="Memory" />
      <entity name="Network" />
   </appliance>
</response>
/monapi/desc/<apps>/<ents>[?fmt=<format>] 

Renvoie la liste de tous les compteurs disponibles dans les appliances demandées (<ents>). (<ents>) peut être un nom d'entité unique, une liste séparée par des virgules de noms d'entités ou un caractère générique (*) qui correspond à toutes les entités disponibles. Identique pour <apps>.

Sortie :

<response timestamp="1194967464">
   <appliance name="main.web">
      <entity name="Terminal in">
         <counter name="Sent bytes" />
         <counter name="Received bytes" />
      </entity>
   </appliance>
</response>
/monapi/desc/<apps>/<ents>/<cnts>[?fmt=<format>] 

Renvoie les descriptions des compteurs demandés (<cnts>). <ents>, <ents> et <ents> peut être un(e) appliance/entité/compteur unique, une liste séparée par des virgules de ces derniers ou un caractère générique.

Sortie :

<response timestamp="1194967464">
   <appliance name="main.web">
      <entity name="Terminal in">
         <counter name="Sent bytes" description="" units="" alarm_below="" alarm_above="" range_lower="" range_upper="" pace="" />
         <counter name="Received bytes" description=""  units=""  alarm_below="" alarm_above="" range_lower="" range_upper="" pace="" />
      </entity>
   </appliance>
</response>

Appels de valeur de compteur

/monapi/val/<apps>/<ents>/<cnts>[?fmt=<format>] 

Renvoie les valeurs des compteurs spécifiés. Si l'un des paramètres app, ent ou cnt est ignoré, le système utilise la valeur de caractère générique. Ainsi, /monapi/val/main.web signifie : les valeurs de tous les compteurs dans toutes les entités de l'appliance main.web.

Sortie :

<response timestamp="1194967464">
   <appliance name="main.web">
      <entity name="Terminal in">
         <counter name="Sent bytes" value="23234" />
         <counter name="Received bytes" value="690432" />
      </entity>
   </appliance>
</response>