check_jmx4perl — Einfache Servicedefinitionen
Posted on October 8th, 2009 by lausser
Im Rahmen des Münchner Nagios-Stammtisches hielt Roland Huß gestern einen Vortrag über sein Framework Jmx4Perl. Mittlerweile haben sich mehrere Leute erkundigt, wie die Service- und Commanddefinitionen für das dazugehörige Plugin check_jmx4perl aussehen könnten. Deshalb soll hier erläutert werden, wie man ein paar grundlegende Messwerte aus einem Applicationserver ausliest und mit Nagios überwacht.
Zunächst muss natürlich erstmal jmx4perl installiert werden. Nachdem die aktuelle Version heruntergeladen und entpackt wurde, werden die Perl Module und das Nagios Plugin check_jmx4perl mit
perl Build.PL ./Build install |
systemweit installiert. Alternativ kann man natürlich auch CPAN in gewohnter Weise zur Installation verwenden. Zusätzlich muss noch der Java Agent j4p.war auf dem Applicationserver deployed werden, der sich im Unterverzeichnis agent/ befindet. Weitere Informationen zur Installation finden sich auch im README.
Danach legt man sich ein paar Command-Definitionen an, die die drei Betriebsarten des Plugins abbilden.
- absoluten Wert ermitteln (z.B. Anzahl der geladenen Klassen)
- das Verhältnis zweier Werte ermitteln (z.B. HeapSize.used / HeapSize.max)
- den Anstieg eines Werts pro Zeit ermitteln (z.B. Anzahl der erzeugten Threads / Sekunde bzw. wie im folgenden Beispiel, pro Minute)
Dabei wird jeweils unterschieden, ob man die MBeans mit ihrem vollständigen Objektnamen adressiert oder Aliase verwendet.
define command { command_name check_jmx4perl command_line $USER3$/check_jmx4perl \ --url $ARG1$ \ --mbean $ARG2$ \ --attribute $ARG3$ \ $ARG4$ } define command { command_name check_jmx4perl_rate command_line $USER3$/check_jmx4perl \ --url $ARG1$ \ --mbean $ARG2$ \ --attribute $ARG3$ \ --delta $ARG4$ \ $ARG5$ } define command { command_name check_jmx4perl_base command_line $USER3$/check_jmx4perl \ --url $ARG1$ \ --mbean $ARG2$ \ --attribute $ARG3$ \ --base $ARG4$ \ $ARG5$ } define command { command_name check_jmx4perl_alias command_line $USER3$/check_jmx4perl \ --url $ARG1$ \ --alias $ARG2$ \ $ARG3$ } define command { command_name check_jmx4perl_alias_base command_line $USER3$/check_jmx4perl \ --url $ARG1$ \ --alias $ARG2$ \ --base-alias $ARG3$ \ $ARG4$ } define command { command_name check_jmx4perl_alias_rate command_line $USER3$/check_jmx4perl \ --url $ARG1$ \ --alias $ARG2$ \ --delta $ARG3$ \ $ARG4$ } |
Darauf aufbauend legt man die Servicedefinitionen an. Als Beispiel soll die WebLogic-Applikation SHOP dienen, die auf dem Host bea läuft und unter der Url http://www.naprax.de:8001/j4p abgefragt wird.
Zunächst packt man die URL und den Host in ein Servicetemplate:
define service { register 0 name app_weblogic_SHOP host_name bea servicegroups app_weblogic_SHOP _agenturl http://www.naprax.de:8001/j4p } |
Im Folgenden werden Servicedescriptions verwendet, die einem hierarchischem Namensschema folgen. Darin steckt die Information, dass eine Applikation überwacht wird (app_), dass es sich um den Applikationstyp WebLogic (weblogic) handelt sowie ein Name für den Applicationserver (SHOP).
Zunächst wird eine Zwischenschicht eingezogen, in der die soeben erstellten SHOP-spezifischen Attribute mit einem weiteren Template app_weblogic_default gemischt werden. Der Sinn dahinter ist, dass es z.B. ein Betriebsteam für Java-Applicationserver gibt und man die entsprechenden Contact- und Notification-Optionen in diesem Template (app_weblogic_default) unterbringen kann.
define service { register 0 name app_weblogic_default_SHOP use app_weblogic_default,app_weblogic_SHOP } |
Die eigentlichen Services (eine kleine Auswahl für den Anfang) sehen dann so aus:
define service { service_description app_weblogic_default_SHOP_check_uptime use app_weblogic_default_SHOP check_command check_jmx4perl_alias \ !$_SERVICEAGENTURL$ \ !RUNTIME_UPTIME \ !--warning 120: --critical 60: } define service { service_description app_weblogic_default_SHOP_check_heapused use app_weblogic_default_SHOP check_command check_jmx4perl_alias_base \ !$_SERVICEAGENTURL$ \ !MEMORY_HEAP_USED \ !MEMORY_HEAP_MAX \ !--warning 80 --critical 90 } define service { service_description app_weblogic_default_SHOP_check_threadscreated use app_weblogic_default_SHOP check_command check_jmx4perl_alias_rate \ !$_SERVICEAGENTURL$ \ !THREAD_COUNT_STARTED \ !60 \ !--warning 100 --critical 200 } define service { service_description app_weblogic_default_SHOP_check_threads use app_weblogic_default_SHOP check_command check_jmx4perl_alias \ !$_SERVICEAGENTURL$ \ !THREAD_COUNT \ !--warning 200 --critical 300 } define service { service_description app_weblogic_default_SHOP_check_filedesc use app_weblogic_default_SHOP check_command check_jmx4perl_alias_base \ !$_SERVICEAGENTURL$ \ !OS_FILE_DESC_OPEN \ !OS_FILE_DESC_MAX \ !--warning 80 --critical 90 } ... |
Die Uptime wird mit überwacht, damit der entsprechende Service als Parent in einer Servicedependency zur Verfügung steht. Er sorgt dafür, dass die anderen Checks ausgesetzt werden, solange der Applicationserver nicht verfügbar ist.
define servicedependency { name dependency_bea_SHOP_uptime_uc host_name bea service_description app_weblogic_default_SHOP_check_uptime dependent_service_description app_weblogic_.*_SHOP_.*, \ !app_weblogic_default_SHOP_check_uptime execution_failure_criteria u,c notification_failure_criteria u,c } |
Und so in etwa könnte es in Nagios aussehen:
Tags: check_jmx4perl, Jmx4Perl, Nagios
Filed under Jmx4Perl |
6 Responses to “check_jmx4perl — Einfache Servicedefinitionen”
-
ConSol* Labs » Blog Archive » jmx4perl 0.36 and 0.40_1 released Says:
November 20th, 2009 at 17:33[...] Version 0.40 has been released as a developer release which contains rather big changes concerning the agent servlet. In addition to the usual GET HTTP request, which encodes a JMX request completely within the URL it now allows for POST HTTP requests containing a JSON representation of the JMX request. This way, jmx4perl is now also able to process bulk requests, i.e. multiple requests as one. For pure Perl users, this extension works transparently and is reflected only in a single addition of JMX::Jmx4Perl’s API: my @responses = $jmx4perl->request(@requests); [...]
-
sebg Says:
June 7th, 2010 at 15:30Hi lausser, I’d like to know how you made the pretty inline performance graphs in you screenshot ? Thanks in advance and have a nice day !
[Reply]
-
June 9th, 2010 at 17:49thanks
[Reply]
-
June 9th, 2010 at 17:51thanks a lot for your answer, it’s a great idea ! Even if my german is a little bit rusty, i’ll have a look a your book samples :)
[Reply]
-
check_jmx4perl: New Nagios configuration style – ConSol* Labs Says:
August 23rd, 2010 at 7:35[...] presented in a previous article a well crafted setup of Nagios commands and service definitions for use with [...]
lausser Reply:
June 8th, 2010 at 11:23
I made it with a template “pnp-preview-popup” which i added to the service definitions. You find it at http://www.nagios-das-praxisbuch.de/wp-content/downloads/Kapitel%204%20PNP/templates.cfg
If you can read german, there are sample chapters of my book which describes it in more detail at page 178. http://books.google.de/books?id=UtjBiiAFLjsC&printsec=frontcover&dq=praxisbuch+nagios&cd=2#v=onepage&q&f=false
[Reply]