Fork me on GitHub
Translations of this page:

Custom Templates

Wie bereits unter ”Was sind Templates ?” beschrieben, ist die Darstellung der Graphen abhängig vom verwendeten Check-Command.

Es gibt jedoch Situationen, in denen dieses Verhalten übersteuert werden muss.

CUSTOM_TEMPLATE

Notwendig wird dies, wenn allgemeingültige Commands definiert wurden.

Beispiel:

define command {
  command_name check_nrpe
  command_line $USER1$/check_nrpe -H $HOSTADDRESS$ -C $ARG1$ -a "$ARG2$"
}

Die Folge wäre, dass immer das Template check_nrpe.php verwendet werden würde, auch wenn auf dem zu überwachenden Server via NRPE ein ganz anderes Plugin aufgerufen wurde.

PNP, speziell process_perfdata.pl, sucht zur Laufzeit für jedes check_command im Verzeichnis etc/pnp/check_commands nach einer Config-Datei ( <check_command>.cfg ) und liest diese, wenn vorhanden, ein.

Da unser Beispiel-Command check_nrpe lautet, wird nach etc/pnp/check_commands/check_nrpe.cfg gesucht.

Eine Beispiel-Config wird bereits während der Installation mit der Dateierweiterung .cfg-sample in etc/pnp/check_commands gespeichert.

In diesen Config-Files können zwei Optionen gesetzt werden.

# check_command check_nrpe!load!-w 4,4,4 -c 5,5,5
# ________0__________|       |       |
# ________1__________________|       |
# ________2__________________________|
#
CUSTOM_TEMPLATE = 1

CUSTOM_TEMPLATE = 1 sorgt dafür, dass nur der Inhalt von $ARG1$ als Template-Name verwendet wird. Da in diesem Beispiel $ARG1$ mit dem Wert “load” gefüllt ist, ergibt sich als Template-Name “load.php”

CUSTOM_TEMPLATE = 0,1 ergibt → “check_nrpe_load.php”

CUSTOM_TEMPLATE = 1,0 ergibt → “load_check_nrpe.php”

DATATYPE

Über die Option “DATATYPE” kann beeinflusst werden mit welchem Datentyp die RRD Datenbank angelegt werden soll. Default ist in diesem Fall “GAUGE”. Für fortlaufende Werte wird aber hier der Datentyp COUNTER benötigt. Normalerweise sollten Plugin Entwickler für Daten von Typ Counter die Einheit “c” verwenden. Dies ist jedoch nicht immer der Fall.

Alle Datenreihen auf Typ COUNTER einstellen.

DATATYPE = COUNTER

Einzelnen Datenreihen spezielle Datentypen zuweisen. (ab PNP-0.4.11)

DATATYPE = GAUGE,GAUGE,COUNTER,COUNTER

Diese Option hat nur Einfluss, wenn die RRD Datenbank neu erstellt wird.

Weitere Datentypen sind in der RRDTool Dokumentation unter rrdcreate erklärt.

MIN und MAX

In einigen wenigen Situationen ist es notwendig, die für RRDTool gültigen Daten zu begrenzen.

RRD Datenbanken lassen sich mit definierten Minimum- und Maximum-Werten anlegen. Weitere Infos unter http://oss.oetiker.ch/rrdtool/doc/rrdcreate.en.html

Berücksichtigen des Maximum-Wertes aus den Performance-Daten (ab PNP-0.4.13)

USE_MAX_ON_CREATE = 1

Berücksichtigen des Minimum-Wertes aus den Performance-Daten (ab PNP-0.4.13)

USE_MIN_ON_CREATE = 1
de/pnp-0.4/tpl_custom.txt · Last modified: 2009/08/08 20:20 by Joerg Linge
www.chimeric.de Creative Commons License Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0