====== RRDGRAPH ======


===== Introduction =====

"RRDGraph" est une interface de génération et de visualisation de graphes basée sur RRDTool (http://oss.oetiker.ch/rrdtool). C'est un composant de la solution de supervision Vigilo.

Elle permet de concanéter des RRDs si nécessaire, et de générer des graphes à partir de ces RRDs (concaténés ou non).

Cette application est constituée d'une librarie de classes et de fonctions, et d'un script prévu pour s'exécuter dans mod_python et générer les graphes. La configuration se fait par des fichiers de configurations dans le répertoire ''/etc/vigilo-rrdgraph''.

Les dépendances de l'application sont donc :
  * Apache (1.x ou 2.x),
  * python (testé avec 2.4, devrait fonctionner avec 2.3),
  * mod_python (testé avec 3.2.10, mais le script devrait fonctionner avec toutes les versions relativement récentes),
  * python-rrd, le binding RRDTool pour python, disponible sur le site de RRDTool.

Le script s'appuie sur trois fichiers de configuration :
  * general.py, qui définit les variables génériques de l'application, notamment les chemins utilisés,
  * templates.py, qui définit les modèles de graphes à générer.
  * graphs.py, où sont définis les graphes

Ces fichiers sont en python et doivent en suivre la syntaxe.

Le fichier graphs.py est très spécifique à votre configuration, un exemple commenté est proposé dans le dossier ''conf.d''.


===== Installation =====

  * Placer les fichiers ''RRDGraph.py'', ''rrdgraph.py'' et ''conf.py'' dans un répertoire accessible par le web
  * Configurer Apache pour activer mod_python dans ce répertoire. Le fichier ''rrdgraph.apache.conf'' contient un exemple de configuration
  * Copier le répertoire ''conf.d'' dans ''/etc'', sous le nom ''vigilo-rrdgraph''. Modifier les fichiers de ce répertoire si besoin
  * Créer le répertoire de cache spécifié dans ''general.py'', et régler les permissions pour que le serveur web puisse écrire dedans
  * Recharger Apache