Cette page a été traduite par l'API Cloud Translation.

Bonnes pratiques de surveillance

Alertes de surveillance

Apigee Edge vous permet de transférer des alertes vers des journaux syslog ou des systèmes/outils de surveillance externes lorsque une erreur ou une défaillance se produit en raison de l'échec d'un événement. Ces alertes peuvent être des alertes/événements au niveau du système ou de l'application. Les alertes au niveau de l'application sont principalement des alertes personnalisées créés à partir des événements générés. L'administrateur réseau configure généralement les conditions personnalisées. Pour en savoir plus sur les alertes, contactez l'assistance Apigee.

Définir des seuils d'alerte

Définissez un seuil à partir duquel une alerte doit être générée. Ce que vous définissez dépend de votre configuration matérielle. Le seuil doit être défini en fonction de votre capacité. Par exemple, Apigee Il se peut que la périphérie soit trop faible si vous n'avez que 6 Go de capacité. Vous pouvez attribuer un seuil avec une valeur égale à (=) ou supérieur au critère (>). Vous pouvez également spécifier un intervalle de temps entre deux la génération d'alertes. Vous pouvez utiliser l'option "heures/minutes/secondes".

Critères de paramétrage des alertes au niveau du système

Le tableau suivant décrit les critères:

Alerte	Seuil suggéré	Description
Mémoire insuffisante	500 Mo	Mémoire trop faible pour démarrer un composant
Espace disque faible (/var/log)	8 Go	L'espace disque est insuffisant.
Charge élevée	3+	Le nombre de processus en attente d'exécution a augmenté de manière inattendue
Processus arrêté	N/A, valeur booléenne "true" ou "false"	Le processus Java Apigee du système s'est arrêté

Vérification des versions spécifiques à Apigee et tierces Ports

Surveillez les ports suivants pour vous assurer qu'ils sont actifs

Ports 4526, 4527 et 4528 sur le serveur de gestion, le routeur et le processeur de messages
Ports 1099, 1100 et 1101 sur le serveur de gestion, le routeur et le processeur de messages
Ports 8081 et 15999 sur les routeurs
Ports 8082 et 8998 sur les processeurs de messages
Port 8080 sur le serveur de gestion

Vérifiez que les ports tiers suivants sont actifs:

Port Qpid 5672
Port Postgres 5432
Ports Cassandra 7000, 7199, 9042, 9160
Port 2181 de ZooKeeper
Port OpenLDAP 10389

Pour déterminer le port sur lequel chaque composant Apigee écoute les appels d'API, les appels d'API suivants au serveur de gestion (qui se trouve généralement sur le port 8080):

curl -v -u username:password http://host:port/v1/servers?pod=gateway&region=dc-1
curl -v -u username:password http://host:port/v1/servers?pod=central&region=dc-1
curl -v -u username:password http://host:port/v1/servers?pod=analytics&region=dc-1

Le résultat de ces commandes contient des sections semblables à celles présentées ci-dessous. La La section http.management.port indique le numéro de port du composant spécifié.

{
  "externalHostName" : "localhost",
  "externalIP" : "111.222.333.444",
  "internalHostName" : "localhost",
  "internalIP" : "111.222.333.444",
  "isUp" : true,
  "pod" : "gateway",
  "reachable" : true,
  "region" : "default",
  "tags" : {
    "property" : [ {
      "name" : "Profile",
      "value" : "Router"
    }, {
      "name" : "rpc.port",
      "value" : "4527"
    }, {
      "name" : "http.management.port",
      "value" : "8081"
    }, {
      "name" : "jmx.rmi.port",
      "value" : "1100"
    } ]
  },
  "type" : [ "router" ],
  "uUID" : "2d4ec885-e20a-4173-ae87-10be38b35750"
}

Afficher les journaux

Les fichiers journaux gardent une trace des messages concernant l'événement/le fonctionnement du système. Messages s'affichent dans le journal lorsque les processus commencent et se terminent ou lorsqu'une condition d'erreur se produit. En consultant le journal fichiers, vous pouvez obtenir des informations sur les composants du système, par exemple, CPU, mémoire, disque, charge, les processus, ainsi de suite, avant et après avoir atteint un état d'échec. Cela vous permet également d'identifier et diagnostiquer la source des problèmes actuels du système ou vous aider à prévoir un système potentiel ; des problèmes.

Par exemple, un journal système type d'un composant contient les entrées suivantes, comme illustré ci-dessous :

TimeStamp = 25/01/13 19:25 ; NextDelay = 30
Memory
HeapMemoryUsage = {used = 29086176}{max = 64880640} ;
NonHeapMemoryUsage = {init = 24313856}{committed = 57278464} ;
Threading
PeakThreadCount = 53 ; ThreadCount = 53 ;
OperatingSystem
SystemLoadAverage = 0.25 ;

Vous pouvez modifier le fichier /opt/apigee/conf/logback.xml pour contrôler le mécanisme de journalisation sans devoir redémarrer un serveur. Le fichier logback.xml contient la propriété suivante, qui définit le fréquence à laquelle le mécanisme de journalisation recherche les modifications de configuration dans le fichier logback.xml:

<configuration scan="true" scanPeriod="30 seconds" >

Par défaut, le mécanisme de journalisation recherche les modifications toutes les minutes. Si vous omettez les unités de temps de l'attribut scanPeriod, elles sont définies par défaut sur des millisecondes.

Le tableau suivant indique l'emplacement des fichiers journaux des composants de cloud privé Apigee Edge.

Composants	Lieu
Serveur de gestion	`opt/apigee/var/log/edge-management-server`
Routeur	`opt/apigee/var/log/edge-router`
Processeur de messages	`opt/apigee/var/log/edge-message-processor`
Serveur Qpid	`opt/apigee/var/log/edge-qpid-server`
Serveur Postgres Apigee	`opt/apigee/var/log/edge-postgres-server`
Interface utilisateur périphérique	`opt/apigee/var/log/edge-ui`
ZooKeeper	`opt/apigee/var/log/apigee-zookeeper`
OpenLDAP	`opt/apigee/var/log/apigee-openldap`
Cassandra	`opt/apigee/var/log/apigee-cassandra`
Qpidd	`opt/apigee/var/log/apigee-qpidd`
Base de données PostgreSQL	`opt/apigee/var/log/apigee-postgresql`

Activer les journaux de débogage pour le message Processeur et interface utilisateur Edge

Pour activer les journaux de débogage pour le processeur de messages:

Sur le nœud "Message Processor", modifiez /opt/apigee/customer/application/messsage-processor.properties. Si ce fichier n'existe pas, créez-le.
Ajoutez la propriété suivante au fichier:
```
conf_system_log.level=DEBUG
```

Redémarrez le processeur de messages :

/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Pour activer les journaux de débogage pour l'interface utilisateur Edge :

Sur le nœud d'interface utilisateur Edge, modifiez /opt/apigee/customer/application/ui.properties. Si ce fichier n'existe pas, créez-le.
Ajoutez la propriété suivante au fichier :
```
conf_application_logger.application=DEBUG
```

Redémarrez l'interface utilisateur Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Bonnes pratiques concernant apigee-monit

Lorsque vous utilisez apigee-monit, Apigee vous recommande de :

Arrêtez de surveiller un composant avant d'effectuer toute action une opération qui la démarre ou l'arrête, telle qu'une sauvegarde ou une mise à niveau.
Surveillez apigee-monit à l'aide d'un outil tel que cron. Pour plus consultez la section Surveiller apigee-monit.

Outils de surveillance

Des outils de surveillance tels que Nagios, Collectd, Graphite, Splunk, Sumologic et Monit peuvent vous aider pour surveiller l'ensemble de votre environnement et de vos processus métier.

Composant		Nagios	Collecté	Splunk
Vérifications au niveau du système	Utilisation du processeur
	Mémoire disponible/utilisée
	Utilisation de l'espace disque
	Statistiques du réseau
Processus
Vérifications de l'API
JMX
Java
Fichiers journaux
Événements critiques	Limite de débit atteinte
	Impossible d'accéder au serveur backend (Hybris ou SharePoint)
	Impossible de joindre le service FaaS (STS)
Événements de type avertissement	Impossible d'accéder au serveur SMTP
Événements de type avertissement	Non-respect des SLA