Éléments à surveiller

Edge for Private Cloud v4.18.05

En général, dans une configuration de production, il est nécessaire d'activer des mécanismes de surveillance dans un déploiement Apigee Edge pour Private Cloud. Ces techniques de surveillance avertissent les administrateurs (ou opérateurs) réseau en cas d'erreur ou de défaillance. Chaque erreur générée est signalée sous forme d'alerte dans Apigee Edge. Pour en savoir plus sur les alertes, consultez Bonnes pratiques de surveillance.

Pour plus de simplicité, les composants Apigee sont classés principalement en deux catégories :

• Services de serveur Java spécifiques à Apigee : incluent le serveur de gestion, le processeur de messages, le serveur Qpid et le serveur Postgres.
• Services tiers : ils incluent le routeur Nginx, Apache Cassandra, Apache ZooKeeper, OpenLDAP, la base de données PostgreSQL et Qpid.

Dans un déploiement sur site d'Apigee Edge, le tableau suivant présente un aperçu des paramètres que vous pouvez surveiller :

En général, une fois Apigee Edge installé, vous pouvez effectuer les tâches de surveillance suivantes pour suivre les performances d'une installation Apigee Edge pour Private Cloud.

Vérifications de l'état du système

Il est très important de mesurer les paramètres d'état du système, tels que l'utilisation du processeur, l'utilisation de la mémoire et la connectivité des ports à un niveau supérieur. Vous pouvez surveiller les paramètres suivants pour obtenir les informations de base sur l'état du système.

• Utilisation du processeur : spécifie les statistiques de base (utilisateur/système/attente d'E/S/inactivité) concernant l'utilisation du processeur. Par exemple, le nombre total de processeurs utilisés par le système.
• Mémoire disponible/utilisée : spécifie l'utilisation de la mémoire système en octets. Par exemple, la mémoire physique utilisée par le système.
• Utilisation de l'espace disque : spécifie les informations du système de fichiers en fonction de l'utilisation actuelle du disque. Par exemple, l'espace disque utilisé par le système.
• Charge moyenne : spécifie le nombre de processus en attente d'exécution.
• Statistiques réseau : paquets et/ou octets réseau transmis et reçus, ainsi que les erreurs de transmission concernant un composant spécifié.

Vérifications des processus/applications

Au niveau du processus, vous pouvez afficher des informations importantes sur tous les processus en cours d'exécution. Par exemple, il s'agit des statistiques d'utilisation de la mémoire et du processeur par un processus ou une application. Pour les processus tels que qpidd, postgres postmaster, java, etc., vous pouvez surveiller les éléments suivants :

• Identification du processus : identifiez un processus Apigee particulier. Par exemple, vous pouvez surveiller l'existence d'un processus Java du serveur Apigee.
• Statistiques sur les threads : affichez les modèles de threads sous-jacents utilisés par un processus. Par exemple, vous pouvez surveiller le nombre maximal de threads et le nombre de threads pour tous les processus.
• Utilisation de la mémoire : affichez l'utilisation de la mémoire pour tous les processus Apigee. Par exemple, vous pouvez surveiller des paramètres tels que l'utilisation de la mémoire de tas et l'utilisation de la mémoire hors tas par un processus.

Vérifications au niveau de l'API

Au niveau de l'API, vous pouvez surveiller si le serveur est opérationnel pour les appels d'API fréquemment utilisés et transmis par proxy par Apigee. Par exemple, vous pouvez effectuer une vérification de l'API sur le serveur de gestion, le routeur et le processeur de messages en appelant la commande cURL suivante :

curl http://host:port/v1/servers/self/up

Où host est l'adresse IP du composant Apigee Edge. Le numéro port est spécifique à chaque composant Edge. Exemple :

Serveur de gestion : 8080

• Routeur : 8081
• Processeur de messages : 8082
• etc.

Consultez les sections ci-dessous pour savoir comment exécuter cette commande pour chaque composant.

Cet appel renvoie "true" et "false". Pour obtenir de meilleurs résultats, vous pouvez également émettre des appels d'API directement sur le backend (avec lequel le logiciel Apigee interagit) afin de déterminer rapidement si une erreur existe dans l'environnement logiciel Apigee ou sur le backend.

Vérifications du flux de messages

Vous pouvez collecter des données sur les routeurs et les processeurs de messages concernant les modèles/statistiques de flux de messages. Vous pouvez ainsi surveiller les éléments suivants :

• Nombre de clients actifs
• Nombre de réponses (10X, 20X, 30X, 40X et 50X)
• Échecs de connexion

Cela vous permet de fournir des tableaux de bord pour le flux de messages de l'API. Pour en savoir plus, consultez Surveiller.

Vérification de l'état du routeur du processeur de messages

Le routeur met en œuvre un mécanisme de vérification de l'état pour déterminer quels processeurs de messages fonctionnent comme prévu. Si un processeur de messages est détecté comme étant en panne ou lent, le routeur peut automatiquement le retirer de la rotation. Dans ce cas, le routeur écrit un message "Mark Down" dans le fichier journal du routeur à l'emplacement /opt/apigee/var/log/edge-router/logs/system.log.

Vous pouvez surveiller le fichier journal du routeur pour détecter ces messages. Par exemple, si le routeur retire un processeur de messages de la rotation, il écrit un message dans le journal sous la forme suivante :

2014-05-06 15:51:52,159 org: env: RPCClientClientProtocolChildGroup-RPC-0 INFO CLUSTER - ServerState.setState() : State of 2a8a0e0c-3619-416f-b037-8a42e7ad4577 is now DISCONNECTED. handle = MP_IP at 1399409512159
2014-04-17 12:54:48,512 org: env: nioEventLoopGroup-2-2 INFO HEARTBEAT - HBTracker.gotResponse() : No HeartBeat detected from /MP_IP:PORT Mark Down

Où MP_IP:PORT est l'adresse IP et le numéro de port du processeur de messages.

Si, par la suite, le routeur effectue une vérification de l'état et détermine que le processeur de messages fonctionne correctement, il le remet automatiquement en rotation. Le routeur écrit également un message "Mark Up" dans le journal au format suivant :

2014-05-06 16:07:29,054 org: env: RPCClientClientProtocolChildGroup-RPC-0 INFO CLUSTER - ServerState.setState() : State of 2a8a0e0c-3619-416f-b037-8a42e7ad4577 is now CONNECTED. handle = IP at 1399410449054
2014-04-17 12:55:06,064 org: env: nioEventLoopGroup-4-1 INFO HEARTBEAT - HBTracker.updateHB() : HeartBeat detected from IP:PORT Mark Up