Anbindung von Jolokia an jadice server

Owned by Former user (Deleted)
Last updated: März 14, 2016

Motiviation

Jolokia ist eine Bibliothek, die JMX über HTTP und JSON exponiert. Ihr Motto lautet "JMX on Capsaicin".

Dieses Tutorial soll zeigen, wie Jolokia im "Agent Mode" in  jadice server eingebunden werden kann, damit externe Monitoring-Werkzeuge jadice server über HTTP überwachen können.

Einbindung von Jolokia

Vorbereitungen

  1. Erstellen Sie in Ihrer Distribution von jadice server einen neuen Ordner jolokia
  2. Erstellen Sie in diesem Ordner eine neue leere Datei mit dem Namen config.properties
    Sie wird nachher für weitere Konfigurationsschritte verwendet
  3. Laden Sie den JVM-Agent von Jolika herunter und kopieren die jar-Datei in den soeben erstellten Ordner

  4. Öffnen Sie die Datei wrapper/wrapper.conf und fügen folgende Zeile hinzu:

    wrapper.java.additional.1=-javaagent:../jolokia/jolokia-jvm-<version>-agent.jar=config=../jolokia/config.properties

    (Die Zahl 1 muss ggf. angepasst werden, um fortlaufend zu bereits bestehenden Einträgen zu sein)

Start und Verifikation

  1. Starten Sie jadice server neu
  2. Öffnen Sie in Ihrem Browser die Seite http://localhost:8778/jolokia/version
  3. Sie sollten ein Ergebnis dieser Form sehen
  4. Jolokia ist erfolgreich installiert worden

Konfiguration

Mit Hilfe der oben erstellen, zunächst leeren Datei config.properties ist es möglich, Jolokia wie im Referenzhandbuch beschrieben, zu konfigurieren.

Ein paar einfache Beispiele:

  • Änderung des Ports: Fügen Sie in der Konfigurationsdatei folgende Zeile hinzu:

    port=8008

    Nach einem Neustart von jadice server erreichen Sie Jolikia nun unter http://localhost:8008/jolokia/version

  • Absicherung über HTTP-Basic-Authentication
    Eine sehr simple Absicherung der Zugriffe über diese Schnittstelle kann über die "HTTP-Basic-Authentication" erfolgen. Dazu fügen Sie in der Konfigurationsdatei folgende Zeilen hinzu:

    authMode=basic
user=admin
password=secret

    Nach einem Neustart von jadice server werden Sie von Jolokia zunächst nach diesen Zugangsdaten gefragt.

Fazit

Dieses Tutorial zeigt nur einen kleinen Ausschnitt der Möglichkeiten, die Jolokia bietet. Weitere Informationen finden Sie auf der offiziellen Seite https://jolokia.org/