rrdcached - En ligne dans le Cloud

PROGRAMME:

Nom

rrdcached - Démon de mise en cache des données pour rrdtool

SYNOPSIS

rrdcaché [-a alloc_size] [-b rép_base [-B]] [-F] [-f temps mort] [-G groupe]] [-g]
[-j rép_journal] [-L] [-l propos] [-m mode] [-O] [-P autorisations] [-p fichier_pid] [-R]
[-s groupe] [-t écriture_threads] [-U utilisateur]] [-w temps mort] [-z retarder]

DESCRIPTION

rrdcaché est un démon qui reçoit les mises à jour des fichiers RRD existants, les accumule et,
s'il en a reçu suffisamment ou si un temps défini s'est écoulé, écrit les mises à jour dans le RRD
fichier. UNE affleurer La commande peut être utilisée pour forcer l'écriture de valeurs sur le disque, de sorte que la représentation graphique
installations et similaires peuvent fonctionner avec des données à jour.

Le démon a été écrit avec de grandes configurations à l'esprit. Ces configurations se heurtent généralement à des problèmes d'E/S
problèmes tôt ou tard pour des raisons qui sortent du cadre de ce document. Vérifier la
wiki sur la page d'accueil de RRDtool pour plus de détails. Consultez également les « CONDITIONS DE SÉCURITÉ » ci-dessous
avant d'utiliser ce démon ! Une description détaillée du fonctionnement du démon peut être trouvée
dans la section "COMMENT ÇA FONCTIONNE" ci-dessous.

OPTIONS

-l propos
Dit au démon de se lier à propos et accepter les connexions TCP entrantes sur ce
prise. Si propos commence par "unix :", tout ce qui suit ce préfixe est
interprété comme le chemin d'accès à un socket de domaine UNIX. Sinon l'adresse ou le nom du nœud
sont résolus en utilisant "getaddrinfo()".

Pour les sockets réseau, un port peut être spécifié en utilisant la forme "[propos]:Port". Si
l'adresse est une adresse IPv4 ou un nom de domaine complet (c'est-à-dire l'adresse
contient au moins un point ("".")), les crochets peuvent être omis, ce qui entraîne le
(plus simple) "propos:Port" modèle. Le port par défaut est 42217. Si vous spécifiez un réseau
socket, il est obligatoire de lire la section « CONSIDÉRATIONS DE SÉCURITÉ ».

Les formats suivants sont acceptés. Veuillez noter que l'adresse du domaine UNIX
douille doit commencez par un slash dans le second cas !

unix :
/

[ ] :
:

Étant donné un port sans hôte (par exemple "-l :42217"), le démon écoutera sur ce port sur
toutes les interfaces réseau. Utilisez "-L" pour éviter d'avoir à fournir explicitement le port si
le port par défaut est souhaité.

Sinon -l option n'est pas spécifiée l'adresse par défaut, "unix:/tmp/rrdcached.sock", sera
être utilisé. Plusieurs -l des options peuvent être proposées.

-L Indique au démon de se lier au port TCP par défaut sur toutes les interfaces disponibles. Il est
équivalent à "-l ''" sans la confusion du paramètre de chaîne vide.

-s nom de groupe|gid
Définissez les autorisations de groupe d'un socket de domaine UNIX. L'option accepte soit un nombre
ID de groupe ou nom de groupe. Ce groupe disposera alors à la fois des autorisations de lecture et d'écriture (le
socket aura les autorisations de fichier 0760) pour le socket et, par conséquent, est capable d'envoyer
commandes au démon. Cela peut être utile dans les cas où vous ne pouvez pas exécuter facilement tous
Les processus RRD avec les mêmes privilèges d'utilisateur (par exemple, des graphes générant des scripts CGI qui
généralement exécuté dans le contexte d'autorisation du serveur Web).

Cette option affecte le Abonnement Adresses de socket UNIX (les suivantes -l option) ou
le socket par défaut (si non -l options ont été spécifiées), c'est-à-dire que vous pouvez spécifier
différents réglages pour différentes prises.

La valeur par défaut est de ne pas modifier la propriété ou les autorisations du socket et, par conséquent, d'utiliser le
défaillance du système.

-m mode
Définissez les autorisations de fichier d'un socket de domaine UNIX. L'option accepte un nombre octal
représentant le modèle de bits pour le mode (voir chmod(1) pour les détails).

Veuillez noter que tous les systèmes n'honorent pas ce paramètre. Sous Linux, autorisations de lecture/écriture
sont nécessaires pour se connecter à un socket UNIX. Cependant, de nombreux systèmes dérivés de BSD ignorent
autorisations pour les sockets UNIX. Voir unix(7) pour plus de détails.

Cette option affecte le Abonnement Adresses de socket UNIX (les suivantes -l option) ou
le socket par défaut (si non -l options ont été spécifiées), c'est-à-dire que vous pouvez spécifier
différents réglages pour différentes prises.

La valeur par défaut est de ne pas modifier la propriété ou les autorisations du socket et, par conséquent, d'utiliser le
défaillance du système.

-P commander[,commander[,...]]
Spécifie les commandes acceptées via un réseau et un socket UNIX. Ceci permet
administrateurs de RRDCacheD contrôler les actions acceptées de diverses sources.

Les arguments donnés au -P option est une liste de commandes séparées par des virgules. Pour
exemple, pour autoriser les commandes "FLUSH" et "PENDING" on pourrait spécifier :

rrdcached -P FLUSH,EN ATTENTE $ MORE_ARGUMENTS

Le manuel de formation -P option affecte le Abonnement adresses de socket (les suivantes -l options) ou le
socket par défaut (si non -l options ont été spécifiées). Dans l'exemple suivant, seul
le socket réseau IPv4 (adresse 10.0.0.1) sera restreint au "FLUSH" et
Commandes "EN ATTENTE":

rrdcached -l unix:/certain/chemin -P FLUSH,PENDING -l 10.0.0.1

Une liste complète des commandes disponibles se trouve dans la section "Commandes valides"
au dessous de. Il existe deux exceptions spéciales mineures :

· Les commandes "HELP" et "QUIT" sont toujours autorisées.

· Si la commande "BATCH" est acceptée, le . la commande sera automatiquement acceptée,
également.

Veuillez également lire les « CONDITIONS DE SÉCURITÉ » ci-dessous.

-w temps mort
Les données sont écrites sur le disque tous les temps mort secondes. Un suffixe facultatif peut être utilisé (par ex.
"5m" au lieu de 300 secondes). Si cette option n'est pas spécifiée, l'intervalle par défaut de
300 secondes seront utilisées.

-z retarder
Si spécifié, rrdcached retardera l'écriture de chaque RRD pendant un nombre aléatoire de secondes
dans la plage [0,retarder). Cela évitera que trop d'écritures soient mises en file d'attente simultanément.
Cette valeur ne doit pas être supérieure à la valeur spécifiée dans -w. Un suffixe facultatif
peut être utilisé (par exemple "3m" au lieu de 180 secondes). Par défaut, il n'y a pas de délai.

-f temps mort
Chaque temps mort secondes, tout le cache est recherché pour les anciennes valeurs écrites dans
disque. Cela ne concerne que les fichiers pour lesquels les mises à jour se sont arrêtées, donc définissez-le sur un
une valeur élevée, telle que 3600 secondes, est acceptable dans la plupart des cas. Un suffixe facultatif peut
être utilisé (par exemple "1h" au lieu de 3600 secondes). Ce délai d'attente est par défaut de 3600 secondes.

-p filet
Définit le nom et l'emplacement du fichier PID. Si non spécifié, la valeur par défaut,
"$localstatedir/run/rrdcached.pid" sera utilisé.

-t écriture_threads
Spécifie le nombre de threads utilisés pour écrire les fichiers RRD. La valeur par défaut est 4.
L'augmentation de ce nombre permettra à rrdcached d'avoir plus de demandes d'E/S simultanées
dans le noyau. Cela peut permettre au noyau de réorganiser les écritures sur le disque, ce qui
meilleur débit de disque.

-j dir
Écrire des mises à jour dans un journal en dir. En cas de plantage du programme ou du système, ce
permettra au démon d'écrire toutes les mises à jour qui étaient en attente au moment du crash.

Au démarrage, le démon vérifiera les fichiers journaux dans ce répertoire. S'il est trouvé, tout
les mises à jour qu'il contient seront lues en mémoire avant que le démon commence à accepter de nouvelles
connexions.

Le journal sera tourné avec la même fréquence que la minuterie de rinçage donnée par -f.

Lorsque la journalisation est activée, le démon utilise une procédure d'arrêt rapide. Plutôt
que de vider tous les fichiers sur le disque, il s'assurera que le journal est correctement écrit et
sortir immédiatement. Bien que les fichiers de données RRD ne soient pas entièrement à jour, aucun
l'information est perdue ; toutes les mises à jour en attente seront relues à partir du journal la prochaine fois
le démon démarre.

Pour désactiver l'arrêt rapide, utilisez le -F option.

-F TOUJOURS vider toutes les mises à jour des fichiers de données RRD lorsque le démon est arrêté,
quel que soit le paramétrage du journal.

-g Courir au premier plan. Le démon ne fourchette().

-b dir
Le démon changera dans un répertoire spécifique au démarrage. Tous les fichiers transmis au
démon, qui sont spécifiés par un relatif chemin, sera interprété comme étant relatif à
ce répertoire. S'il n'est pas défini par défaut, "/ Tmp", sera utilisé.

+------------------------+------------------------ +
! Ligne de commande ! Fichier mis à jour !
+------------------------+------------------------ +
! foo.rrd ! /tmp/foo.rrd !
! foo/bar.rrd ! /tmp/foo/bar.rrd !
! /var/lib/rrd/foo.rrd ! /var/lib/rrd/foo.rrd !
+------------------------+------------------------ +
Chemins donnés sur la ligne de commande et chemins réellement
mis à jour par le démon, en supposant que le répertoire de base
"/ Tmp".

AVERTISSEMENT: Les chemins jusqu'au répertoire de base inclus DOIVENT ne pas BE liens symboliques.
En d'autres termes, si le répertoire de base est spécifié comme :

-b /base/dir/quelque part

... alors NONE des éléments suivants doivent être des liens symboliques :

/base
/base/répertoire
/base/dir/quelque part

-B Autoriser uniquement les écritures dans le répertoire de base spécifié dans -b (et tous les sous-répertoires).
Cela ne ne pas détecter les liens symboliques. Les chemins contenant "../" seront également bloqués.

-R Autoriser la création de sous-répertoire récursif dans le répertoire de base spécifié dans -b (et n'importe quel
sous-répertoires). Ne peut être utilisé que lorsque -B est également défini.

-a alloc_size
Allouer des pointeurs de valeur en morceaux de alloc_size. Cela peut améliorer l'utilisation du processeur sur
machines avec des implémentations lentes de "realloc()", en échange d'une mémoire légèrement plus élevée
utilisation. La valeur par défaut est 1. Ne définissez pas plus -w valeur divisée par
votre taille de pas RRD moyenne.

-O Empêcher la commande CREATE d'écraser les fichiers existants, même lorsqu'elle y est invitée
faire cela. C'est pour plus de sécurité.

-G -groupe
Lors de l'exécution en tant que démon et invoqué à partir d'un compte privilégié, réinitialisez les privilèges du groupe
à ceux de groupe. Le groupe peut être spécifié sous forme de nom ou d'ID de groupe. Le démon
se terminera avec un diagnostic s'il ne peut pas réussir la transition vers le
groupe.

-U -utilisateur
Lors de l'exécution en tant que démon et invoqué à partir d'un compte privilégié, réinitialisez les privilèges de l'utilisateur sur
ceux de utilisateur. L'utilisateur peut être spécifié sous forme de nom ou d'ID utilisateur. Le démon va
quitter avec un diagnostic s'il ne peut pas réussir la transition vers l'utilisateur spécifié.

AFFECTÉ OUTIL RRDT COMMANDES

Les commandes suivantes peuvent être informées de la rrdcaché en utilisant l'argument de ligne de commande
--démon ou la variable d'environnement ADRESSE_RRDCACHED:

· décharger

· aller chercher

· affleurer

· graphique

· graphiquev

· Info

· premier

· dernier

· dernière mise à jour

· mettre à jour

· xporter

· créer

Le manuel de formation Mise à jour la commande peut envoyer des valeurs au démon au lieu de les écrire sur le disque
lui-même. Toutes les autres commandes peuvent envoyer un CHASSE commande (voir ci-dessous) au démon avant
accéder aux fichiers, afin qu'ils fonctionnent avec des données à jour même si le délai d'expiration du cache est important.

ERREUR DE LA LIGNE

Le démon signale les erreurs de l'une des deux manières suivantes : Au démarrage, les messages d'erreur sont imprimés
à "STDERR". L'une des étapes du démarrage consiste à passer à l'arrière-plan et à fermer
"STDERR" - après cela, il n'est plus possible d'écrire directement à l'utilisateur. Une fois que cela a
s'est produit, le démon enverra des messages de journal au démon de journalisation du système en utilisant syslog (3).
La facilité utilisée est "LOG_DAEMON".

COMMENT IT TRAVAUX

Lors de la réception d'une mise à jour, rrdcaché n'écrit pas sur le disque mais cherche une entrée pour cela
fichier dans son arborescence interne. S'il n'est pas trouvé, une entrée est créée avec l'heure actuelle
(appelé « Premier » dans le schéma ci-dessous). Cette fois est pas l'heure indiquée sur la commande
mais l'heure que le système d'exploitation considère être "maintenant". La valeur et l'heure du
valeur (appelée « Temps » dans le schéma ci-dessous) sont ajoutées au nœud de l'arbre.

Lors de l'ajout d'une valeur à un nœud d'arbre, il est vérifié s'il est temps d'écrire les valeurs
sur disque. Les valeurs sont écrites sur le disque si "now() - First >= timeout", où "timeout" est le
délai d'attente spécifié à l'aide de la -w option, voir "OPTIONS". Si les valeurs sont « assez anciennes », elles
sera mis en file d'attente dans la "file d'attente de mise à jour", i. e. ils seront ajoutés à la liste chaînée
indiqué ci-dessous. Parce que les nœuds de l'arbre et les éléments de la liste chaînée sont les mêmes données
structures en mémoire, toute mise à jour d'un fichier déjà mis en file d'attente sera écrite
avec la prochaine écriture dans le fichier RRD aussi.

Un "fil de mise à jour" séparé retire constamment le premier élément de la file d'attente de mise à jour et
écrit toutes ses valeurs dans le fichier approprié. Donc tant que la file d'attente de mise à jour n'est pas vide
les fichiers sont écrits à la vitesse la plus élevée possible.

Étant donné que le délai d'expiration des fichiers n'est vérifié que lorsque de nouvelles valeurs sont ajoutées au fichier, "mort"
fichiers, je. e. les fichiers qui ne sont plus mis à jour ne seraient jamais écrits sur le disque.
Par conséquent, de temps en temps, contrôlé par le -f option, l'arbre entier est parcouru et
toutes les "anciennes" valeurs sont mises en file d'attente. Étant donné que cela n'affecte que les fichiers "morts" et parcourir l'arbre
est relativement cher, vous devez régler l'"intervalle de rinçage" sur une valeur raisonnablement élevée.
La valeur par défaut est de 3600 secondes (une heure).

L'inconvénient des valeurs de mise en cache est qu'elles n'apparaîtront pas dans les graphiques générés à partir du
fichiers RRD. Pour contourner ce problème, le démon fournit la "commande flush" pour vider des
des dossiers. Cela signifie que le fichier est inséré au front de la file d'attente de mise à jour ou y a été déplacé
s'il est déjà en file d'attente. La commande flush ne reviendra qu'une fois le fichier en attente
les mises à jour ont été écrites sur le disque.

+------+ +------+ +------+
! diriger ! ! racine ! ! queue !
+---+--+ +---+--+ +---+--+
! /\ !
! /\ !
! /\ /\ !
! /\/\ \ `----------------- ... --------, !
V / `-------, ! V
+---+----+---+ +------+-----+ +---+----+---+
! Fichier : foo ! ! Fichier : barre ! ! Fichier : qux !
! Premièrement : 101 ! ! Premier : 119 ! ! Premier : 180 !
! Suivant :&barre -+---> ! Suivant :&... -+---> ... --->! Suivant:NULL !
| Préc:NULL !<---+-Préc:&foo !<--- ... ----+-Préc: &... !
+============+ +============+ +=============+
! Temps : 100 ! ! Temps : 120 ! ! Temps : 180 !
! Valeur : 10 ! ! Valeur : 0.1 ! ! Valeur : 2,2 !
+------------+ +-----------+ +------------+
! Temps : 110 ! ! Temps : 130 ! ! Temps : 190 !
! Valeur : 26 ! ! Valeur : 0.1 ! ! Valeur : 7,3 !
+------------+ +-----------+ +------------+
: : : : : :
+------------+ +-----------+ +------------+
! Temps : 230 ! ! Temps : 250 ! ! Temps : 310 !
! Valeur : 42 ! ! Valeur : 0.2 ! ! Valeur : 1,2 !
+------------+ +-----------+ +------------+

Le schéma ci-dessus montre :

· Les fichiers/valeurs sont stockés dans une arborescence (équilibrée).

· Les nœuds d'arborescence et les entrées dans la file d'attente de mise à jour sont la même structure de données.

· L'heure locale (« Première ») et l'heure spécifiée dans les mises à jour (« Heure ») peuvent différer.

· Les valeurs de temporisation sont insérées à la "queue".

· Des valeurs explicitement rincées sont insérées à la "tête".

· Roches d'art ASCII.

SÛRETÉ CONSIDERATIONS

Authentification
Si votre installation de rrdtool a été construite sans libwrap, il n'y a aucune forme d'authentification
pour les clients se connectant au démon rrdcache !

Si votre installation de rrdtool a été construite avec libwrap, vous pouvez utiliser hosts_access pour
restreindre l'accès du client au démon rrdcache (rrdcached). Pour plus d'informations sur la façon de
utilisez hosts_access pour restreindre l'accès au démon rrdcache, vous devriez lire le
hosts_access(5) pages de manuel.

Il est toujours fortement recommandé d'installer un filtre de paquets ou un mécanisme similaire pour empêcher
connexions non autorisées. À moins que vous n'ayez un VLAN ou un VPN dédié pour cela, en utilisant le réseau
sockets est probablement une mauvaise idée!

Autorisation
Il y a une autorisation minimale par socket.

L'autorisation se fait actuellement par socket. Cela signifie que chaque socket a une liste
de commandes qu'il acceptera et qu'il acceptera. Il n'acceptera que ces commandes
explicitement répertorié, mais il acceptera (actuellement) ces commandes de toute personne atteignant le
prise.

Si les sockets réseau doivent être utilisés, il est nécessaire de restreindre les
commandes à celles nécessaires aux clients externes. Si, par exemple, des clients externes souhaitent
dessiner des graphiques des données mises en cache, ils ne devraient être autorisés à utiliser la commande "FLUSH".

L'autorisation ne fonctionne pas lorsque rrcached est activé par socket par systemd.

Chiffrement
Il n'y a pas de cryptage.

Encore une fois, cela peut être ajouté à l'avenir, mais pour le moment c'est votre travail de garder votre
données privées privées. Installez un VPN ou un tunnel crypté si vos statistiques sont
confidentiel!

santé mentale vérification
Il n'y a pas de vérification d'intégrité.

Le démon écrira aveuglément dans n'importe quel fichier qui lui sera dit, vous devriez donc vraiment créer un
utilisateur séparé juste pour ce démon. De plus, il ne fait aucun contrôle de cohérence, donc s'il obtient
dit d'écrire des valeurs pour un temps lointain dans le futur, vos fichiers seront bien foutus !

Conclusion
· La sécurité est le travail de l'administrateur.

· Nous vous recommandons d'autoriser l'accès en écriture via les sockets de domaine UNIX uniquement.

· Tu étais prévenu.

PROTOCOLE

Le démon communique avec les clients à l'aide d'un protocole ASCII basé sur une ligne qui est facile à
lire et taper facilement. Cela permet aux scripts d'implémenter facilement le protocole et
possible pour les utilisateurs d'utiliser telnet pour se connecter au démon et tester des choses "à la main".

Le protocole est basé sur des lignes, cela signifie que chaque enregistrement se compose d'une ou plusieurs lignes. UNE
La ligne se termine par le caractère de saut de ligne 0x0A, généralement écrit sous la forme "\n". Dans le
exemples ci-dessous, ce caractère sera écrit comme " " ("saut de ligne").

Une fois la connexion établie, le client doit envoyer une "commande". UNE
La commande se compose du mot-clé de commande, éventuellement de quelques arguments, et d'une terminaison
caractère de nouvelle ligne. Pour une liste des commandes, voir "Commandes valides" ci-dessous.

Exemple :

FLUSH /tmp/foo.rrd

Le démon répond par une ligne composée d'un code d'état et d'un court message d'état,
séparés par un ou plusieurs caractères espace. Un code d'état négatif signale une erreur, un
code d'état positif ou succès du signal zéro. Si le code d'état est supérieur à zéro, il
indique le nombre de lignes qui suivent la ligne d'état.

Exemples :

0 Succès

2 Deux lignes suivent
C'est la première ligne
Et c'est la deuxième ligne

Valide Commandes
Les commandes suivantes sont comprises par le démon :

CHASSE nom de fichier
Le démon met nom de fichier à la front de la file d'attente de mise à jour (éventuellement en la déplaçant
là si le nœud est déjà en file d'attente). La réponse sera envoyée après le nœud a
été retiré de la file d'attente.

RINÇAGE
Le démon commence à vider TOUTES les valeurs en attente sur le disque. Cela revient
immédiatement, même si les écritures peuvent prendre beaucoup de temps.

EN ATTENDANT nom de fichier
Affiche toutes les mises à jour "en attente" d'un fichier, dans l'ordre. Les mises à jour affichées n'ont pas encore été
écrit dans le fichier RRD sous-jacent.

FETCH nom de fichier CF [Commencer [fin] [ds ...]]
Appelle "rrd_fetch" avec les arguments spécifiés et renvoie le résultat sous forme de texte. Si
nécessaire, le fichier est d'abord vidé sur le disque. La fonction côté client "rrdc_fetch"
(déclaré dans "rrd_client.h") analyse la sortie et se comporte comme "rrd_fetch_r" pour
intégration facile des requêtes à distance. ds définit les colonnes à vider - si aucune n'est
étant donné que tous sont retournés

FETCHEBIN nom de fichier CF [Commencer [fin] [ds ...]]
Appelle "rrd_fetch" avec les arguments spécifiés et renvoie le résultat en texte/binaire
forme pour éviter les surcharges inutiles de désactivation/désactivation. Si nécessaire, le fichier est vidé
sur le disque en premier. La fonction côté client "rrdc_fetch" (déclarée dans "rrd_client.h")
analyse la sortie et se comporte comme "rrd_fetch_r" pour une intégration facile de la télécommande
requêtes. ds définit les colonnes à vider - si aucune n'est donnée, toutes sont renvoyées

OUBLIEZ nom de fichier
Supprime nom de fichier de la cachette. Toutes les mises à jour en attente SERONT BE PERDU.

FILE D'ATTENTE
Affiche les fichiers qui se trouvent dans la file d'attente de sortie. Renvoie zéro ou plusieurs lignes dans le
format suivant, où est le nombre de valeurs à écrire pour le
:



AIDE [commander]
Renvoie un court message d'utilisation. Si aucune commande n'est donnée, ou commander is AIDE, une liste de
les commandes prises en charge par le démon sont renvoyées. Sinon une brève description, éventuellement
contenant un pointeur vers une page de manuel, est renvoyé. Évidemment, cela est destiné à
l'utilisation interactive et le format dans lequel les commandes et les résumés d'utilisation sont
retourné n'est pas bien défini.

Statistiques
Renvoie une liste de métriques qui peuvent être utilisées pour mesurer les performances des démons et
vérifier son état. Pour une description des valeurs renvoyées, voir « Valeurs de performance »
ci-dessous.

Le format dans lequel les valeurs sont renvoyées est similaire à beaucoup d'autres lignes basées
protocoles : chaque valeur est imprimée sur une ligne distincte, chacune constituée du nom de
la valeur, deux points, un ou plusieurs espaces et la valeur réelle.

Exemple :

9 Les statistiques suivent
Longueur de la file d'attente : 0
Mises à jour reçues : 30
FlushsReçu: 2
Mises à jourÉcrit : 13
DataSetsÉcrit : 390
Nombre de nœuds d'arbre : 13
Profondeur de l'arbre : 4
JournalOctets : 190
JournalRotation : 0

PING
PING-PONG, ceci est très utile lors de l'utilisation d'un pool de connexion entre le client utilisateur et
RRDCACHÉ.

Exemple :

0 PONG

MISE A JOUR nom de fichier valeurs [valeurs ...]
Ajoute plus de données à un nom de fichier. C'est le opération pour laquelle le démon a été conçu, donc
il est inutile de décrire à nouveau le mécanisme. Lisez "COMMENT ÇA FONCTIONNE" ci-dessus pour un
explication détaillée.

Notez que rrdcached accepte uniquement les horodatages absolus dans les valeurs de mise à jour. Mises à jour
les chaînes telles que "N:1:2:3" sont automatiquement converties en temps absolu par le client RRD
bibliothèque avant d'envoyer à rrdcached.

A ÉCRIT nom de fichier
Cette commande est écrite dans le journal une fois qu'un fichier a été écrit avec succès dans
disque. Il est utilisé lors de la relecture du journal pour déterminer quelles mises à jour ont déjà été
appliqué. Il est uniquement valable dans le journal ; il n'est pas accepté de l'autre commande
Les canaux.

PREMIERE nom de fichier [ranum]
Renvoie l'horodatage du premier CDP dans le RRA spécifié. La valeur par défaut est d'utiliser RRA
zéro si aucun n'est spécifié.

DERNIER nom de fichier
Renvoie l'horodatage de la dernière mise à jour du RRD spécifié. Notez que le cache est
pas rincé avant de vérifier, car le client est censé le demander séparément si
c'est requis.

INFO nom de fichier
Renvoie les informations de configuration pour le RRD spécifié. Notez que le cache est pas
rincé avant de vérifier, car le client est censé le demander séparément s'il est
nécessaire.

Les informations sont renvoyées, un élément par ligne, au format :

je je je

CREATE nom de fichier [-s taille de pas] [-b heure de début] [-O] DSdéfinitions ... RRDéfinitions ...
Cela créera le fichier RRD en fonction des paramètres fournis, à condition que le
les paramètres sont valides, et (si l'option -O est donnée ou si le rrdcached a été lancé
avec l'indicateur -O) le spécifié nom de fichier n'existe pas déjà.

LOT
Cette commande lance le chargement en bloc de plusieurs commandes. Ceci est conçu pour
installations avec des taux de mise à jour extrêmement élevés, car il permet plus d'une commande
à émettre par lis() et écrire ().

Toutes les commandes sont exécutées comme elles le seraient si elles étaient données individuellement, à l'exception de
sortie à l'utilisateur. Les messages indiquant le succès sont supprimés et les messages d'erreur
sont retardés jusqu'à ce que le client ait terminé.

Le traitement de la commande est terminé lorsque le client envoie un point ("".") sur sa propre ligne.
Une fois que le client a terminé, le serveur répond avec un nombre d'erreurs et la liste des
messages d'erreur (le cas échéant). Chaque message d'erreur indique le numéro de la commande à
auquel il correspond, et le message d'erreur lui-même. La première commande utilisateur après
LOT est la commande numéro un.

client : LOT
serveur : 0 Allez-y. Terminez par le point '.' sur sa propre ligne.
client : MISE À JOUR x.rrd 1223661439:1:2:3 <--- commande #1
client : UPDATE y.rrd 1223661440:3:4:5 <--- commande #2
client : et ainsi de suite...
client: .
serveur : 2 erreurs
serveur : 1 message pour la commande 1
serveur : 12 message pour la commande 12

QUITTER
Déconnectez-vous de rrdcached.

Arts de la scène Nos valeurs
Les compteurs suivants sont renvoyés par le Statistiques commander:

Longueur de la file d'attente (non signé 64bit entier)
Nombre de nœuds actuellement mis en file d'attente dans la file d'attente de mise à jour.

Mises à jour reçues (non signé 64bit entier)
Nombre de commandes UPDATE reçues.

Chasses d'eau reçues (non signé 64bit entier)
Nombre de commandes FLUSH reçues.

Mises à jourÉcrit (non signé 64bit entier)
Nombre total de mises à jour, i. e. appels à "rrd_update_r", depuis le démarrage du démon.

DataSetsÉcrit (non signé 64bit entier)
Nombre total d'« ensembles de données » écrits sur le disque depuis le démarrage du démon. Un ensemble de données
est une ou plusieurs valeurs transmises au MISE A JOUR commander. Par exemple : "1223661439:123:456"
est un ensemble de données avec deux valeurs. Le terme « ensemble de données » est utilisé pour éviter toute confusion
si des valeurs individuelles ou des groupes de valeurs sont comptés.

Numéro de nœuds d'arbre (non signé 64bit entier)
Nombre de nœuds dans le cache.

ArbreProfondeur (non signé 64bit entier)
Profondeur de l'arborescence utilisée pour la recherche rapide des clés.

JournalOctets (non signé 64bit entier)
Nombre total d'octets écrits dans le journal depuis le démarrage.

JournalRotation (non signé 64bit entier)
Nombre de rotations du journal depuis le démarrage.

SIGNAUX

SIGINT et SIGTERM
Le démon se termine normalement à la réception de l'un ou l'autre de ces signaux. Les mises à jour en attente sont
traité conformément à la -j et -F options.

SIGUSR1
Le démon se ferme APRÈS avoir vidé toutes les mises à jour sur le disque. Cela peut prendre un peu de temps.

SIGUSR2
Le démon se ferme immédiatement, sans vider les mises à jour sur le disque. Mises à jour en attente
sera rejoué à partir du journal au redémarrage du démon. AVERTISSEMENT: if
journalisation (-j) is ne pas activée, tout En attente mises à jour SERONT BE PERDU.

Utilisez rrdcached en ligne à l'aide des services onworks.net