IPMI Sensor Monitoring Plugin
Inhaltsverzeichnis |
Download
- Version 2.x basierend auf FreeIPMI (Changelog Version 2.x; empfohlene Version, überwacht auch Sensoren der Sensor Klasse discrete)
- Version 1.x basierend auf ipmitool (Changelog Version 1.x; wird zwar weiterhin unterstützt, überwacht aber keine Sensoren der Sensor Klasse discrete)
Mailinglisten
Seit 31. Mai 2010 gibt es zwei Mailinglisten auf http://lists.thomas-krenn.com/ zum IPMI Plugin:
- ipmi-plugin-announce (Informationen zu neuen Versionen, moderierte Mailingliste)
- ipmi-plugin-user (allgemeine Diskussionen und Fragen zum Plugin)
Einstiegsartikel aus ADMIN Magazin
Einen dreiseitigen Artikel zum Plugin finden Sie im ADMIN Magazin 01/2011. Als Leser des Thomas Krenn Wikis können Sie den Artikel exklusiv hier kostenlos als PDF herunterladen:
- Lebenszeichen - Serverhardware mit dem IPMI-Plugin für Nagios überwachen (PDF, aus ADMIN Magazin 01/2011)
Plugin Version 2.x Konfiguration
Softwareanforderungen
Das IPMI Sensor Monitoring Plugin benötigt folgende Software-Komponenten:
- Nagios oder Icinga (siehe dazu z.B. Nagios Installation in Debian 5.0 Lenny)
- FreeIPMI ab Version 0.5.1, bei Version 0.8 legacy-output Option verwenden
- gawk
Plugin einspielen
Damit das Plugin verwendet werden kann muss es in Nagios eingespielt werden. Kommt etwa Nagios unter Debian 5 zum Einsatz wird das Plugin an folgende Stelle kopiert:
- /usr/lib/nagios/plugins/check_ipmi_sensor
Kommando Definition
Definieren sie das Kommando check_ipmi_sensor in ihrer commands.cfg (unter Debian 5 z.B. in /etc/nagios3/commands.cfg):
define command{
command_name check_ipmi_sensor
command_line $USER1$/check_ipmi_sensor -H $_HOSTIPMI_IP$ -f $ARG1$
}
Host Definition
In der jeweiligen Host Definition konfigurieren sie die IP Adresse des IPMI Interfaces als Custom Object Variable[1] _ipmi_ip:
define host{
use linux-server
host_name centos4
alias centos4
address 192.168.1.151
_ipmi_ip 192.168.1.211
}
Service Definition
Die abschließende Servicedefinition erfordert als Parameter nur mehr den Pfad zur Free-IPMI-Konfigurationsdatei, die
define service{
use generic-service
host_name centos4
service_description IPMI
check_command check_ipmi_sensor!/etc/ipmi-config/ipmi.cfg
}
FreeIPMI Konfiguration bis FreeIPMI 0.7.*
Die FreeIPMI Konfigurationsdatei enthält IPMI-Benutzernamen, -Passwort und Channel-Privilege-Level und kann auch weitere FreeIPMI Konfigurationsparameter enthalten:
username monitor password ao5$snNc! privilege-level user
FreeIPMI Konfiguration bei FreeIPMI 0.8.* und neuer
Bei FreeIPMI 0.8.* ist die legacy-output Option für ipmimonitoring notwendig (da sich die Standardausgabe des Kommandos mit dieser Version geändert hat). Sie können diese Option bequem in der FreeIPMI Konfigurationsdatei ergänzen:
username monitor password ao5$snNc! privilege-level user ipmimonitoring-legacy-output on
Außerdem können Sie die Option ipmi-sensors-interpret-oem-data on ergänzen. Dadurch werden OEM Sensoren interpretiert (sofern die OEM-Sensoren ihres Systems bereits FreeIPMI bekannt sind - z.B. bei dem Sensor CPU1 Temp des Supermicro Mainboards X8DT3-F, abgefragt mit FreeIPMI Version 1.0.1):
username monitor password ao5$snNc! privilege-level user ipmimonitoring-legacy-output on ipmi-sensors-interpret-oem-data on
Sofern Unrecognized Events von FreeIPMI gemeldet werden, können Sie diese bei Bedarf über folgende Option in der Konfigurationsdatei ignorieren:
ipmi-sensors-ignore-unrecognized-events on
Falls Sie das Plugin ohne Konfigurationsdatei nutzen, steht Ihnen dafür die -O Option zur Verfügung:
./check_ipmi_sensor -H 10.1.102.10 -U monitor -P ***** -L user -O '--legacy-output --interpret-oem-data'
Plugin Version 1.x Konfiguration
Informationen zur Konfiguration des IPMI Plugin Version 1.x finden Sie in folgendem Wiki Artikel:
Mögliche Plugin Erweiterungen
Geplante Erweiterungen für künftige Versionen (noch nicht verfügbar):
- for version 2.x and 1.x:
- option to change performance data output to omit quotes and to use underscores instead, e.g. to return
Fan_1=5432instead of'Fan 1'=5432- this should allow Zenoss users to use this plugin (a Zenoss user reported that zenoss has issues with creating graphs for data sources with quotes) - option to query only defined sensors (like a single sensor or a list of sensors)
- option to exclude OEM sensors (see this posting the plugin's mailinglist)
- option to change performance data output to omit quotes and to use underscores instead, e.g. to return
- for version 1.x:
- remove searching for "error" string as this causes problem when a sensor has the term "error" in its name, see this posting the plugin's mailinglist
- error handling for creation of SDR cache file
- search/query for other locations of ipmitool in case it is not in /usr/bin/ (e.g. in /bin, /usr/bin, /usr/local/bin) - e.g. using
IPMITOOL=$(which ipmitool) - if $ipmioutput contains "error" maybe add query if server is switched on -> error message could be more precise then
- validate if an option to execute different ipmitool queries instead of 'ipmitool sdr', e.g. 'ipmitool sunoem sbled get SERVICE' (with additional info on how the output should look like) would be useful
Einzelnachweise
Weitere Informationen
- IPMI Grundlagen
- IPMI Sensor Monitoring Plugin (www.monitoringexchange.org)
- IPMI Sensor Monitoring Plugin (exchange.nagios.org)
Feedback zu diesem Artikel geben