Autoréparation avec apigee-monit

Edge for Private Cloud v4.19.01

Apigee Edge pour le cloud privé inclut apigee-monit, un outil basé sur l'utilitaire de monétisation Open Source. apigee-monit interroge régulièrement les services Edge. Si un service est indisponible, apigee-monit tente de le redémarrer.

Pour utiliser apigee-monit, vous devez l'installer manuellement. Il ne fait pas partie de l'installation standard.

Par défaut, apigee-monit vérifie l'état des services Edge toutes les 60 secondes.

Démarrage rapide

Le tableau suivant vous montre comment commencer à utiliser apigee-monit immédiatement:

  Installer apigee-monit
/opt/apigee/apigee-service/bin/apigee-service apigee-monit install
/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

apigee-monit est installé et commence à surveiller par défaut tous les composants du nœud.

  Arrêter la surveillance des composants
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
  Démarrer la surveillance des composants
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all
  Obtenir un récapitulatif de l'état
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
  Examinez les fichiers journaux apigee-monit.
cat /opt/apigee/var/log/apigee-monit/apigee-monit.log

Chacun de ces sujets et d'autres sont décrits en détail dans les sections suivantes.

À propos de apigee-monit

apigee-monit permet de s'assurer que tous les composants d'un nœud restent opérationnels. Pour ce faire, elle fournit divers services, dont les suivants:

  • Redémarrer les services ayant échoué
  • Afficher des informations récapitulatives
  • État de la surveillance de Logging
  • Envoi de notifications
  • Surveiller les services autres que Edge

Apigee vous recommande de surveiller apigee-monit pour vous assurer qu'il est en cours d'exécution. Pour en savoir plus, consultez la section Surveiller apigee-monit.

architecture apigee-monit

Lors de l'installation et de la configuration d'Apigee Edge pour Private Cloud, vous pouvez éventuellement installer une instance distincte de apigee-monit sur chaque nœud de votre cluster. Ces instances apigee-monit distinctes fonctionnent indépendamment les unes des autres: elles ne communiquent pas l'état de leurs composants aux autres nœuds ni ne communiquent les défaillances de l'utilitaire de surveillance lui-même à un service central.

L'image suivante illustre l'architecture apigee-monit dans un cluster à cinq nœuds:

Figure 1: Une instance distincte de apigee-monit s'exécute de manière isolée sur chaque nœud d'un cluster

Plates-formes compatibles

apigee-monit est compatible avec les plates-formes suivantes pour votre cluster de cloud privé. (Le système d'exploitation compatible avec apigee-monit dépend de la version du cloud privé.)

Système d'exploitation Version du cloud privé
v4.50.00 v4.51.00 v4.52.00
CentOS 7,5, 7,6, 7,7, 7,8 7,5, 7,6, 7,7, 7,8 7,5, 7,6, 7,7, 7,8
RedHat Enterprise Linux (RHEL) 7,5, 7,6, 7,7, 7,8 7,5, 7,6, 7,7, 7,8, 7,9, 8,0 7,5, 7,6, 7,7, 7,8, 7,9, 8,0
Oracle Linux 7,5, 7,6, 7,7, 7,8 7,5, 7,6, 7,7, 7,8 7,5, 7,6, 7,7, 7,8
* Bien que cela ne soit pas techniquement pris en charge, vous pouvez installer et utiliser apigee-monit sur CentOS/RHEL/Oracle version 6.9 pour Apigee Edge pour Private Cloud version 4.19.01.

Configurations des composants

apigee-monit utilise des configurations de composants pour déterminer les composants à surveiller, les aspects du composant à vérifier et les actions à entreprendre en cas de défaillance.

Par défaut, apigee-monit surveille tous les composants Edge d'un nœud à l'aide de leurs configurations de composants prédéfinies. Pour afficher les paramètres par défaut, consultez les fichiers de configuration du composant apigee-monit. Vous ne pouvez pas modifier les configurations des composants par défaut.

apigee-monit vérifie différents aspects d'un composant, selon celui qu'il vérifie. Le tableau suivant répertorie ce que apigee-monit vérifie pour chaque composant et vous indique où se trouve la configuration des composants pour chaque composant. Notez que certains composants sont définis dans un seul fichier de configuration, et que d'autres ont leur propre configuration.

Composant Emplacement de la configuration Métriques surveillées
Serveur de gestion /opt/apigee/edge-management-server/monit/default.conf Vérifications apigee-monit :
  • Le ou les ports spécifiés sont ouverts et acceptent les requêtes
  • Le ou les protocoles spécifiés sont compatibles
  • État de la réponse

En outre, pour ces composants apigee-monit:

  • Nécessite plusieurs défaillances sur un certain nombre de cycles avant d'agir
  • Définit un chemin de requête personnalisé
Processeur de messages /opt/apigee/edge-message-processor/monit/default.conf
Serveur Postgres /opt/apigee/edge-postgres-server/monit/default.conf
Serveur Qpid /opt/apigee/edge-qpid-server/monit/default.conf
Routeur /opt/apigee/edge-router/monit/default.conf
Interface utilisateur Cassandra
Edge
OpenLDAP
Postgres
Qpid
Zookeeper
/opt/apigee/data/apigee-monit/monit.conf Vérifications apigee-monit :
  • Le service est en cours d'exécution

L'exemple suivant montre la configuration par défaut du composant edge-router:

check host edge-router with address localhost
  restart program = "/opt/apigee/apigee-service/bin/apigee-service edge-router monitrestart"
  if failed host 10.1.1.0 port 8081 and protocol http
    and request "/v1/servers/self/uuid"
    with timeout 15 seconds
    for 2 times within 3 cycles
  then restart

  if failed port 15999 and protocol http
    and request "/v1/servers/self"
    and status < 600
    with timeout 15 seconds
    for 2 times within 3 cycles
  then restart

L'exemple suivant présente la configuration par défaut du composant edge-ui:

check process edge-ui
 with pidfile /opt/apigee/var/run/edge-ui/edge-ui.pid
 start program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui start" with timeout 55 seconds
 stop program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui stop"

Vous ne pouvez pas modifier les configurations par défaut des composants Apigee Edge pour Private Cloud. Vous pouvez toutefois ajouter vos propres configurations de composants pour des services externes, tels que votre point de terminaison cible ou le service httpd. Pour plus d'informations, consultez la section Configurations de composants autres qu'Apigee.

Par défaut, apigee-monit surveille tous les composants d'un nœud sur lequel il s'exécute. Vous pouvez l'activer ou le désactiver pour tous les composants ou pour des composants individuels. Pour en savoir plus, consultez :

Installer apigee-monit

apigee-monit n'est pas installé par défaut. Vous pouvez l'installer manuellement après la mise à niveau ou l'installation de la version 4.19.01 ou ultérieure d'Apigee Edge pour Cloud privé.

Cette section explique comment installer apigee-monit sur les plates-formes compatibles, ainsi que la version 6.9 de CentOS/RHEL/Oracle Linux, qui ne sont pas compatibles.

Pour plus d'informations sur la uninstalling de apigee-monit, consultez la section Désinstaller apigee-monit.

Installer apigee-monit sur une plate-forme compatible

Cette section explique comment installer apigee-monit sur une plate-forme compatible.

Pour installer apigee-monit sur une plate-forme compatible:

  1. Installez apigee-monit à l'aide de la commande suivante :
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit install
  2. Configurez apigee-monit à l'aide de la commande suivante :
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  3. Lancez apigee-monit à l'aide de la commande suivante :
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit start
  4. Répétez cette procédure sur chaque nœud de votre cluster.

Installer apigee-monit sur une plate-forme non compatible

apigee-monit n'est pas compatible avec la version 6.9 de CentOS/RHEL/Oracle Linux, mais cette section explique comment l'installer.

Pour installer apigee-monit sur la version 6.9 de CentOS/RHEL/Oracle Linux:

  1. Installez le dépôt Extra Packages for Enterprise Linux (ou EPEL pour faire court) :
    sudo yum install epel-release
  2. Désactiver EPEL :
    yum-config-manager --disable epel
  3. Activez temporairement EPEL et installez monit :
    yum --enablerepo=epel install monit

    Notez que le dépôt EPEL doit être désactivé après l'installation de monit. L'option enablerepo n'active que le dépôt spécifié pour la commande en cours.

  4. Installer apigee-monit :
    apigee-service apigee-monit install
    apigee-service apigee-monit configure
    apigee-service apigee-monit start
  5. Vérifiez que EPEL est désactivé après l'installation de apigee-monit :
    yum repolist all | grep epel/x86_64
    !epel/x86_64                  Extra Packages for Enterprise Linu disabled

    Cet exemple montre que le dépôt EPEL est désactivé. Toutefois, si elle n'est pas désactivée, vous devez la désactiver:

    sudo yum-config-manager --disable epel

Arrêter et démarrer les composants de surveillance

Lorsqu'un service s'arrête pour une raison quelconque, apigee-monit tente de le redémarrer.

Cela peut poser un problème si vous souhaitez arrêter délibérément un composant. Par exemple, vous pouvez arrêter un composant lorsque vous devez le sauvegarder ou le mettre à niveau. Si apigee-monit redémarre le service lors de la sauvegarde ou de la mise à niveau, votre procédure de maintenance peut être interrompue et entraîner son échec.

Les sections suivantes présentent les options permettant d'arrêter la surveillance des composants.

Arrêter un composant et le surveiller

Pour arrêter un composant et le surveiller, exécutez la commande suivante:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop-component -c component_name
component_name peut être l'une des valeurs suivantes :
  • apigee-cassandra (Cassandra)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (base de données PostgreSQL)
  • apigee-qpidd (Qpidd)
  • apigee-sso (authentification unique Edge)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (serveur de gestion)
  • edge-management-ui (nouvelle interface utilisateur de périphérie)
  • edge-message-processor (processeur de messages)
  • edge-postgres-server (serveur Postgres)
  • edge-qpid-server (serveur Qpid)
  • edge-router (routeur périphérique)
  • edge-ui (interface utilisateur classique)

Notez que "all" n'est pas une option valide pour stop-component. Vous pouvez arrêter et annuler la surveillance d'un seul composant à la fois avec stop-component.

Pour redémarrer le composant et reprendre la surveillance, exécutez la commande suivante:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit start-component -c component_name

Notez que "all" n'est pas une option valide pour start-component.

Pour obtenir des instructions sur l'arrêt et l'annulation de la surveillance de tous les composants, consultez Arrêter tous les composants et annuler leur surveillance.

Annuler la surveillance d'un composant (sans l'arrêter)

Pour annuler la surveillance d'un composant (sans l'arrêter), exécutez la commande suivante:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name
component_name peut être l'une des valeurs suivantes :
  • apigee-cassandra (Cassandra)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (base de données PostgreSQL)
  • apigee-qpidd (Qpidd)
  • apigee-sso (authentification unique Edge)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (serveur de gestion)
  • edge-management-ui (nouvelle interface utilisateur de périphérie)
  • edge-message-processor (processeur de messages)
  • edge-postgres-server (serveur Postgres)
  • edge-qpid-server (serveur Qpid)
  • edge-router (routeur périphérique)
  • edge-ui (interface utilisateur classique)

Pour reprendre la surveillance du composant, exécutez la commande suivante:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name

Annuler la surveillance de tous les composants (sans les arrêter)

Pour annuler la surveillance de tous les composants (sans les arrêter), exécutez la commande suivante:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

Pour reprendre la surveillance de tous les composants, exécutez la commande suivante:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

Arrêter tous les composants et annuler leur surveillance

Pour arrêter tous les composants et annuler leur surveillance, exécutez les commandes suivantes:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
/opt/apigee/apigee-service/bin/apigee-all stop

Pour redémarrer tous les composants et reprendre la surveillance, exécutez les commandes suivantes:

/opt/apigee/apigee-service/bin/apigee-all start
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

Pour arrêter la surveillance de tous les composants, vous pouvez également désactiver apigee-monit, comme décrit dans la section Arrêter, démarrer et désactiver apigee-monit.

Arrêter, démarrer et désactiver apigee-monit

Comme pour tout service, vous pouvez arrêter et démarrer apigee-monit à l'aide de la commande apigee-service. En outre, apigee-monit est compatible avec la commande unmonitor, qui vous permet d'arrêter temporairement les composants de surveillance.

Arrêter apigee-monit

Pour arrêter apigee-monit, utilisez la commande suivante:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop

Démarrer apigee-monit

Pour démarrer apigee-monit, utilisez la commande suivante:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

Désactiver apigee-monit

Vous pouvez suspendre la surveillance de tous les composants du nœud à l'aide de la commande suivante:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

Vous pouvez également désactiver définitivement apigee-monit en le désinstallant du nœud, comme décrit dans la section Désinstaller apigee-monit.

Désinstaller apigee-monit

Pour désinstaller apigee-monit:

  1. Si vous avez configuré une tâche cron pour surveiller apigee-monit, supprimez la tâche cron avant de désinstaller apigee-monit :
    sudo rm /etc/cron.d/apigee-monit.cron
  2. Arrêtez apigee-monit à l'aide de la commande suivante :
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
  3. Désinstallez apigee-monit à l'aide de la commande suivante :
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall
  4. Répétez cette procédure sur chaque nœud de votre cluster.

Surveiller un composant que vous venez d'installer

Si vous installez un nouveau composant sur un nœud exécutant apigee-monit, vous pouvez commencer à le surveiller en exécutant la commande restart de apigee-monit. Cela génère un nouveau fichier monit.conf qui inclura le nouveau composant dans ses configurations de composants.

L'exemple suivant redémarre apigee-monit:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit restart

Personnaliser apigee-monit

Vous pouvez personnaliser divers paramètres apigee-monit, y compris:

  1. Paramètres de contrôle apigee-monit par défaut
  2. Paramètres de configuration globaux
  3. Configurations de composants autres qu'Apigee

Paramètres de contrôle Apigee par défaut

Vous pouvez personnaliser les paramètres de contrôle apigee-monit par défaut, tels que la fréquence des vérifications de l'état et l'emplacement des fichiers apigee-monit. Pour ce faire, modifiez un fichier de propriétés à l'aide de la technique de code avec configuration. Les fichiers de propriétés sont conservés même après la mise à niveau d'Apigee Edge pour le cloud privé.

Le tableau suivant décrit les paramètres de commande apigee-monit par défaut que vous pouvez personnaliser:

Propriété Description
conf_monit_httpd_port Port du daemon httpd. apigee-monit utilise httpd pour son tableau de bord et pour activer les rapports/résumés. La valeur par défaut est 2812.
conf_monit_httpd_allow Contraintes liées aux requêtes adressées au daemon httpd. apigee-monit utilise httpd pour exécuter son application de tableau de bord et activer les rapports/résumés. Cette valeur doit pointer vers l'hôte local (l'hôte sur lequel httpd est exécuté).

Pour exiger que les requêtes incluent un nom d'utilisateur et un mot de passe, utilisez la syntaxe suivante:

conf_monit_httpd_allow=allow username:"password"\nallow 127.0.0.1

Lorsque vous ajoutez un nom d'utilisateur et un mot de passe, insérez un "\n" entre chaque contrainte. N'insérez pas de retours chariot ni de sauts de ligne réels dans la valeur.

conf_monit_monit_datadir Répertoire dans lequel les détails de l'événement sont stockés.
conf_monit_monit_delay_time Durée d'attente de apigee-monit après son premier chargement en mémoire avant de s'exécuter. Cela n'affecte apigee-monit que lors de la première vérification du processus.
conf_monit_monit_logdir Emplacement du fichier journal apigee-monit.
conf_monit_monit_retry_time Fréquence à laquelle apigee-monit tente de vérifier chaque processus. La valeur par défaut est de 60 secondes.
conf_monit_monit_rundir Emplacement du PID et des fichiers d'état, que apigee-monit utilise pour vérifier les processus.

Pour personnaliser les paramètres de contrôle apigee-monit par défaut:

  1. Modifiez le fichier suivant :
    /opt/apigee/customer/application/monit.properties

    Si le fichier n'existe pas, créez-le et définissez le propriétaire sur l'utilisateur "apigee" :

    chown apigee:apigee /opt/apigee/customer/application/monit.properties

    Notez que si le fichier existe déjà, des propriétés de configuration supplémentaires peuvent y être définies en plus de celles indiquées dans le tableau ci-dessus. Vous ne devez pas modifier d'autres propriétés que celles indiquées ci-dessus.

  2. Définissez ou remplacez les valeurs de propriété par vos nouvelles valeurs.

    Par exemple, pour remplacer l'emplacement du fichier journal par /tmp, ajoutez ou modifiez la propriété suivante :

    conf_monit_monit_logdir=/tmp/apigee-monit.log

  3. Enregistrez les modifications apportées au fichier monit.properties.
  4. Reconfigurez apigee-monit à l'aide de la commande suivante :
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  5. Actualisez apigee-monit à l'aide de la commande suivante :
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    Si vous ne pouvez pas redémarrer apigee-monit, recherchez les erreurs éventuelles dans le fichier journal, comme décrit dans la section Accéder aux fichiers journaux apigee-monit.

  6. Répétez cette procédure pour chaque nœud de votre cluster.

Paramètres de configuration généraux

Vous pouvez définir des paramètres de configuration généraux pour apigee-monit. Par exemple, vous pouvez ajouter des notifications par e-mail pour les alertes. Pour ce faire, créez un fichier de configuration dans le répertoire /opt/apigee/data/apigee-monit, puis redémarrez apigee-monit.

Pour définir les paramètres de configuration généraux de apigee-monit:

  1. Créez un fichier de configuration du composant à l'emplacement suivant :
    /opt/apigee/data/apigee-monit/filename.conf

    filename peut être n'importe quel nom de fichier valide, sauf "monit".

  2. Remplacez le propriétaire du nouveau fichier de configuration par l'utilisateur "apigee", comme indiqué dans l'exemple suivant :
    chown apigee:apigee /opt/apigee/data/apigee-monit/my-mail-config.conf
  3. Ajoutez vos paramètres de configuration généraux au nouveau fichier. L'exemple suivant configure un serveur de messagerie et définit les destinataires des alertes :
    SET MAILSERVER smtp.gmail.com PORT 465
      USERNAME "example-admin@gmail.com" PASSWORD "PASSWORD"
      USING SSL, WITH TIMEOUT 15 SECONDS
    
    SET MAIL-FORMAT {
      from: edge-alerts@example.com
      subject: Monit Alert -- Service: $SERVICE $EVENT on $HOST
    }
    SET ALERT fred@example.com
    SET ALERT nancy@example.com

    Pour obtenir la liste complète des options de configuration globales, consultez la documentation de monétisation.

  4. Enregistrez les modifications que vous avez apportées au fichier de configuration du composant.
  5. Actualisez apigee-monit à l'aide de la commande suivante :
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    Si apigee-monit ne redémarre pas, recherchez les erreurs éventuelles dans le fichier journal, comme décrit dans la section Accéder aux fichiers journaux apigee-monit.

  6. Répétez cette procédure pour chaque nœud de votre cluster.

Configurations de composants hors Apigee

Vous pouvez ajouter vos propres configurations à apigee-monit afin qu'il vérifie les services qui ne font pas partie d'Apigee Edge pour le cloud privé. Par exemple, vous pouvez utiliser apigee-monit pour vérifier que vos API s'exécutent en envoyant des requêtes à votre point de terminaison cible.

Pour ajouter une configuration de composant autre qu'Apigee:

  1. Créez un fichier de configuration du composant à l'emplacement suivant :
    /opt/apigee/data/apigee-monit/filename.conf

    filename peut être n'importe quel nom de fichier valide, sauf "monit".

    Vous pouvez créer autant de fichiers de configuration de composants que nécessaire. Par exemple, vous pouvez créer un fichier de configuration distinct pour chaque composant autre qu'Apigee que vous souhaitez surveiller sur le nœud.

  2. Remplacez le propriétaire du nouveau fichier de configuration par l'utilisateur "apigee", comme indiqué dans l'exemple suivant :
    chown apigee:apigee /opt/apigee/data/apigee-monit/my-config.conf
  3. Ajoutez vos configurations personnalisées au nouveau fichier. L'exemple suivant vérifie le point de terminaison cible sur le serveur local :
    CHECK HOST localhost_validate_test WITH ADDRESS localhost
      IF FAILED
        PORT 15999
        PROTOCOL http
        REQUEST "/validate__test"
        CONTENT = "Server Ready"
        FOR 2 times WITHIN 3 cycles
      THEN alert

    Pour obtenir la liste complète des paramètres de configuration possibles, consultez la documentation de monétisation.

  4. Enregistrez les modifications apportées au fichier de configuration.
  5. Actualisez apigee-monit à l'aide de la commande suivante :
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    Si apigee-monit ne redémarre pas, recherchez les erreurs éventuelles dans le fichier journal, comme décrit dans la section Accéder aux fichiers journaux apigee-monit.

  6. Répétez cette procédure pour chaque nœud de votre cluster.

Notez que cette procédure s'applique uniquement aux composants autres que Edge. Vous ne pouvez pas personnaliser les configurations des composants Edge.

Accéder aux fichiers journaux apigee-monit

apigee-monit consigne toute l'activité, y compris les événements, les redémarrages, les modifications de configuration et les alertes dans un fichier journal.

L'emplacement par défaut du fichier journal est :

/opt/apigee/var/log/apigee-monit/apigee-monit.log

Vous pouvez modifier l'emplacement par défaut en personnalisant les paramètres de la commande apigee-monit.

Les entrées du fichier journal se présentent sous la forme suivante:

'edge-message-processor' trying to restart
[UTC Dec 14 16:20:42] info     : 'edge-message-processor' trying to restart
'edge-message-processor' restart: '/opt/apigee/apigee-service/bin/apigee-service edge-message-processor monitrestart'

Vous ne pouvez pas personnaliser le format des entrées du fichier journal apigee-monit.

Afficher l'état agrégé avec apigee-monit

apigee-monit inclut les commandes suivantes qui vous fournissent des informations d'état agrégées sur les composants d'un nœud:

Commande Utilisation
report
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
summary
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

Chacune de ces commandes est expliquée plus en détail dans les sections suivantes.

signaler

La commande report fournit un résumé cumulé du nombre de composants opérationnels, hors service, en cours d'initialisation ou non surveillés sur un nœud. L'exemple suivant appelle la commande report:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report

L'exemple suivant montre le résultat report sur une configuration AIO (tout-en-un) :

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
up:            11 (100.0%)
down:           0 (0.0%)
initialising:   0 (0.0%)
unmonitored:    1 (8.3%)
total:         12 services

Dans cet exemple, apigee-monit indique que 11 des 12 services sont opérationnels. Un service n'est actuellement pas surveillé.

Une erreur Connection refused peut s'afficher lorsque vous exécutez la commande report pour la première fois. Dans ce cas, attendez la durée de la propriété conf_monit_monit_delay_time, puis réessayez.

résumé

La commande summary répertorie chaque composant et indique son état. L'exemple suivant appelle la commande summary:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

L'exemple suivant montre le résultat summary sur une configuration AIO (tout-en-un) :

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
Monit 5.25.1 uptime: 4h 20m
 Service Name                     Status                      Type
 host_name                        OK                          System
 apigee-zookeeper                 OK                          Process
 apigee-cassandra                 OK                          Process
 apigee-openldap                  OK                          Process
 apigee-qpidd                     OK                          Process
 apigee-postgresql                OK                          Process
 edge-ui                          OK                          Process
 edge-qpid-server                 OK                          Remote Host
 edge-postgres-server             OK                          Remote Host
 edge-management-server           OK                          Remote Host
 edge-router                      OK                          Remote Host
 edge-message-processor           OK                          Remote Host

Si vous obtenez une erreur Connection refused lorsque vous exécutez la commande summary pour la première fois, attendez la durée de la propriété conf_monit_monit_delay_time, puis réessayez.

Surveiller apigee-monit

Il est recommandé de vérifier régulièrement que apigee-monit est exécuté sur chaque nœud.

Pour vérifier que apigee-monit est en cours d'exécution, utilisez la commande suivante:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

Apigee vous recommande d'émettre cette commande régulièrement sur chaque nœud qui exécute apigee-monit. Pour ce faire, vous pouvez utiliser un utilitaire tel que cron, qui exécute les tâches planifiées à des intervalles prédéfinis.

Pour surveiller apigee-monit à l'aide de cron:

  1. Ajoutez la prise en charge de cron en copiant le répertoire apigee-monit.cron dans le répertoire /etc/cron.d, comme indiqué dans l'exemple suivant :
    cp /opt/apigee/apigee-monit/cron/apigee-monit.cron /etc/cron.d/
  2. Ouvrez le fichier apigee-monit.cron pour le modifier.

    Le fichier apigee-monit.cron définit la tâche cron à exécuter, ainsi que la fréquence à laquelle elle doit être exécutée. L'exemple suivant montre les valeurs par défaut:

    # Cron entry to check if monit process is running. If not start it
    */2 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

    Ce fichier utilise la syntaxe suivante, dans laquelle les cinq premiers champs définissent l'heure à laquelle apigee-monit exécute son action:

    min hour day_of_month month day_of_week task_to_execute

    Par exemple, le temps d'exécution par défaut est */2 * * * *, ce qui demande à cron de vérifier le processus apigee-monit toutes les deux minutes.

    Vous ne pouvez pas exécuter une tâche cron plus d'une fois par minute.

    Pour en savoir plus sur l'utilisation de cron, consultez la documentation de l'OS de votre serveur ou les pages de manuel.

  3. Modifiez les paramètres cron pour qu'ils correspondent aux règles de votre organisation. Par exemple, pour définir la fréquence d'exécution sur 5 minutes, définissez la définition de la tâche comme suit :
    */5 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit
  4. Enregistrez le fichier apigee-monit.cron.
  5. Répétez cette procédure pour chaque nœud de votre cluster.

Si cron ne commence pas à regarder apigee-monit, vérifiez les points suivants:

  • Une ligne vide apparaît après la définition du job cron.
  • Il n'y a qu'une seule tâche cron définie dans le fichier. (Les lignes commentées ne comptent pas.)

Si vous souhaitez arrêter ou désactiver temporairement apigee-monit, vous devez également désactiver cette tâche cron, sinon cron redémarrera apigee-monit.

Pour désactiver cron, effectuez l'une des opérations suivantes:

  • Supprimez le fichier /etc/cron.d/apigee-monit.cron :
    sudo rm /etc/cron.d/apigee-monit.cron

    Vous devrez le copier à nouveau si vous souhaitez par la suite réactiver cron pour regarder apigee-monit.

    OR

  • Modifiez le fichier /etc/cron.d/apigee-monit.cron et mettez en commentaire la définition de la tâche en ajoutant un "#" au début de la ligne. Par exemple :
    # 10 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit