Description

Le module Graphite-Perfdata permet d'envoyer et stocker les métriques dans un serveur Graphite (via Carbon). Il est possible de modifier des paramètres (comme l'adresse du serveur Graphite ou son port) via le fichier de configuration ci-dessous.

Activation du module

Le module Graphite-Perfdata est un module qui peut être activé seulement sur le démon Broker.

  • L'activation du module s'effectue en ajoutant le nom de ce module dans le fichier de configuration du démon Broker.
  • Pour ce faire, ouvrer le fichier de configuration du Broker à l'emplacement /etc/shinken/brokers/, et ajouter le nom de votre module "Graphite-Perfdata".


Exemple: par défaut, nous livrons un module dont le nom est "Graphite-Perfdata":

define Broker {
    [...]
    modules                   Module 1, Module 2, Module 3, Graphite-Perfdata
    [...]
}


Pour prendre en compte le changement de configuration, redémarrer l'Arbiter:

service shinken-arbiter restart


Configuration

La configuration du module se trouve par défaut dans le fichier  /etc/shinken/modules/graphite.cfg

  • Vous trouverez aussi systématiquement un exemple dans /etc/shinken-user-example/configuration/daemons/brokers/modules/graphite_perfdata/graphite_perfdata-example.cfg

Exemple de fichier de configuration


#===============================================================================
# Graphite-Perfdata
#===============================================================================
# Daemons that can load this module:
# - broker
# This module send metrics into a graphite (carbon) server
#===============================================================================


define module {

# Shinken Enterprise. Lines added by import core. Do not remove it, it's used by Shinken Enterprise to update your objects if you re-import them.
    _SE_UUID             core-module-7d9e22e45adc11e5b3b3080027f08538
    _SE_UUID_HASH        2136b2756b5160cfad074e796ebc373e
# End of Shinken Enterprise part


    #======== Module identity =========
    # Module name. Must be unique
    module_name                 Graphite-Perfdata

    # Module type (to load module code). Do not edit.
    module_type                 graphite_perfdata

    #======== Workers in the broker ========
    # This module will use workers in the broker, each worker will manage a shard of all hosts/checks.
    # This parameter is used by the broker to set the number of workers. Each worker will use one CPU, which will balance the metrology processing load among CPUs.
    # default: 1
    broker_module_nb_workers     1

    #======== Graphite address =========
    # host:  graphite server address (ip or fqdn)
    host                        localhost

    # port:  tcp port of the graphite server
    port                        2003



    #======== realm filtering =========
    # By default, this module will save metrics from all realm and subrealms of the broker realm.
    # You can use realm_store_only to save only the realm you want into the graphite server
    #realm_store_only           Realm1, Realm2, Realm3


    #======== Storage tuning ========
    # For performance purpose, we can globally disable storage of warning and/or error thresholds
    # default: 1 => store_warnig_threshold
    # broker_module_graphite_perfdata_store_warning_threshold 1
    #
    # default: 1 => store error_threshold
    # broker_module_graphite_perfdata_store_error_threshold   1
}


Détails des sections composant le fichier de configuration

Identification du module

Il est possible de définir plusieurs instances de module de type Graphite-Perfdata dans votre architecture Shinken.

  • Chaque instance devra avoir un nom unique.


NomTypeUnitéDéfautCommentaire


module_name


Texte---Graphite-Perfdata

Nous vous conseillons de choisir un nom en fonction de l'utilisation du module pour que votre configuration soit simple à maintenir.

Doit être unique.


module_type 


Texte---graphite_perfdataNe peut être modifié.


Options du module


define module {
	[...]
    # default: 1
    broker_module_nb_workers     1

    # host:  graphite server address (ip or fqdn)
    host                        localhost

    # port:  tcp port of the graphite server
    port                        2003

    #realm_store_only           Realm1, Realm2, Realm3

    # default: 1 => store_warnig_threshold
    # broker_module_graphite_perfdata_store_warning_threshold 1

    # default: 1 => store error_threshold
    # broker_module_graphite_perfdata_store_error_threshold   1
    [...]
}




NomTypeUnitéDéfautCommentaire


broker_module_nb_workers


Entier---1

Ce module utilise des workers dans le broker, chaque worker va gérer un part des hôte/check.

Ce paramêtre est utilisé par le broker pour choisir le nombre de workers. chaque worker va utiliser un CPU, et la charge de calcul de métrologie sera répartie sur les CPU.


host


IP | fqdn---localhostAdresse du serveur Graphite.


port


Entier---2003Port du serveur Graphite.


realm_store_only


Liste Texte---

Par défaut, ce module sauvegarde les métriques de tout le royaume et les sous-royaumes du broker.

Vous pouvez choisir de sauvegarder dans uniquement certains royaumes.

Le noms des royaumes est renseigné à la suite séparé par une virgule.

Exemple:  'Realm1, Realm2, Realm3'


broker_module_graphite_perfdata_store_warning_threshold


Entier---1
  • 0 : Ne sauvegarde pas les seuils d’avertissement dans graphite.
  • 1 : Sauvegarde les seuils d'avertissement dans graphite.


broker_module_graphite_perfdata_store_error_threshold


Entier---1
  • 0 : Ne sauvegarde pas les seuils critiques dans graphite.
  • 1 : Sauvegarde les seuils critiques dans graphite.