Structure du fichier de profile RRD

Le fichier RRD_Profile.xml contient une liste de toutes les profils RRD déclarées dans LoriotPro. Un profil RRD au sein du logiciel LoriotPro est une description des enregistrements que peut contenir une base de données RRD.

Cette liste est mise à jour à partir de RRD manager ou de RRD collector de manière transparent pour l’utilisateur.

Schema de la structure xml (RRD_Profile.xsd)

La balise global du document

Balise de délimitation d’un profil dans le fichier des profils

DateCreation	Date de création
Author	Auteur du profil RRD
Description	Description du profil RRD

Le nom identifiant ce profil

La balise de délimitation des paramètres de la base RRD

Hordatage minimum des valeurs pour que celles-ci soient prises en compte et ajoutées à la base. Cette valeur est initialisée à la date et l'heure courante lors de la création de la base.

<Step>

Interval de temps en secondes entre chaque ajout de données dans la base RRD

<Users>

<DB_User>

Utilisateurs de ce profil. Il permet de vérifier que ce profil n'est pas actuellement utilisé par une base avant de pouvoir le détruire.

La description d'une source de donnée. Un profil peut contenir plusieurs sources de données

La description d'une archive round robin. Un profil peut contenir plusieurs archives round robin.

<DataSource> Contient les caractéristiques d'un source de données

<DS_Name>

Le nom de la source de données RRD (Data Source Name)

Le type de la source de données

Gauge	Jauge : Les jauges sont utilisées pour la mesure intantané, tel que le niveau d'un réservoire, la vitesse d'un vehicule, une température, la charge d'un processeur, le nombre d'impression en attente, un espace disque, nombre d'utilisateurs connectés au système, etc.
Counter	Compteur : Les compteurs représentes des quantités qui s'incrémentent en permanence. Les compteur sont toujours croissants (Exception faite liée à la capacité de stockage maximal qui provoque un retour à 0, "overflow"). Exemples de compteurs, les kilometres parcourus, le nombre d'octets transmit sur une interface réseau,
Derive	Valeur dérivé : S'applique principalement sur des variables instanées (gauge SNMP) pour mesurer une variation de celle-ci sur une période de temps. Si on applique cela au nombre d'utilisateurs connectés au système on obtient un taux de connections sur la période considérée.
Absolute	Valeur absolue : S'applique à la lecture de compteur qui sont remis à zero lors de leur lecture. Cette méthode est utilisée pour les compteurs à croissance rapide et permet d'eviter la saturation (overflow).

Le nombre maximum de secondes qui peuvent s'écouler entre deux mises à jour de la base RRD pour cette source de données. Si cette limite est dépassée la valeur de l'échantillon sera positionnée à inconnu (Unknown)

La valeur minimal accepté pour cette source de donnée. Si cette limite est dépassée la valeur de l'échantillon sera positionnée à inconnu (Unknown)

La valeur maximal accepté pour cette source de donnée. Si cette limite est dépassée la valeur de l'échantillon sera positionnée à inconnu (Unknown)

<RRA_Name>

Le nom de l'archive Round Robin

La fonction de consolidation a réalisé sur les valeurs collectées

Average	Réalise la moyenne arithmétique des valeurs collectées
Min	Conserve la plus petite valeur des valeurs collectées
Max	Conserve la plus grande valeur des valeurs collectées
Last	Conserve le dernier valeurs collectées

Nombre d'échantillons de valeur inconnue tolérée avant de considérer la valeur résultant de la consolidation comme inconnu.

Exemple: un facteur de 0.5 permettra de considérer un résultat bon si au moins un échantillon est bon sur deux collectés.

<RRA_Step>

Le nombre de valeurs utilisés pour réaliser la consolidation.

Exemple: La consolidation de type "average" de 60 valeurs à raison d'un valeur par minute donnera la valeur moyenne par heure.

<RRA_Rows>

Le nombre de valeurs conservées dans la base RRD.

Exemple: Si on défini un stockage de 240 entrée des valeurs horaire calculées précédemment on obtiendra un historique des 100 derniers jours à raison d'une valeur moyenne par heure.

Exemple de profil avec un profil de défini:

<?xml version="1.0"?>
<RoundRobinDatabases>
      <Profile DateCreation="Thursday, February 09, 2006" Author="489427ì514039619590" Description="Created by RRD Collector Plugin attached to host :LoriotPro IP address : 127_0_0_1">
            <ProfileName>P_LoriotPro-4894270514039619590</ProfileName>
            <DataBase>
                  <StartTime>1139536168</StartTime>
                  <Step>60</Step>
                  <Users>
                        <DB_User>LoriotPro-4894270514039619590</DB_User>
                  </Users>
                  <DataSource Description="Ping Round Trip Time, Host : LoriotPro, Packet size : 64, TTL: 32, Timeout: 4">
                        <DS_Name>DS0</DS_Name>
                        <DataSourceType>GAUGE</DataSourceType>
                        <HeartBeat>120</HeartBeat>
                        <MinValue></MinValue>
                        <MaxValue></MaxValue></DataSource>
                  <RoundRobinArchive Description="The last hour of collected data">
                        <RRA_Name>Last Hour</RRA_Name>
                        <ConsolidationFunction>AVERAGE</ConsolidationFunction>
                        <xFileFactor>0.5</xFileFactor>
                        <RRA_Step>1</RRA_Step>
                        <RRA_Rows>800</RRA_Rows></RoundRobinArchive>
                  <RoundRobinArchive Description="The last 24 hours of collected data">
                        <RRA_Name>Last Day</RRA_Name>
                        <ConsolidationFunction>AVERAGE</ConsolidationFunction>
                        <xFileFactor>0.5</xFileFactor>
                        <RRA_Step>4</RRA_Step>
                        <RRA_Rows>800</RRA_Rows></RoundRobinArchive>
                  <RoundRobinArchive Description="The last week of collected data">
                        <RRA_Name>Last Week</RRA_Name>
                        <ConsolidationFunction>AVERAGE</ConsolidationFunction>
                        <xFileFactor>0.5</xFileFactor>
                        <RRA_Step>28</RRA_Step>
                        <RRA_Rows>800</RRA_Rows></RoundRobinArchive>
                  <RoundRobinArchive Description="The last month of collected data">
                        <RRA_Name>Last Month</RRA_Name>
                        <ConsolidationFunction>AVERAGE</ConsolidationFunction>
                        <xFileFactor>0.5</xFileFactor>
                        <RRA_Step>112</RRA_Step>
                        <RRA_Rows>800</RRA_Rows>
                  </RoundRobinArchive>
            </DataBase>
      </Profile>
</RoundRobinDatabases>