Erste Schritte mit Hyperic HQ

In diesem Abschnitt wird die Installation und die ersten Schritte mit Hyperic HQ erlauetert.

Installation

Die Installation ist hinreichend auf der Hyperic Documentation HQ 3.0 Install Guide
Seite beschrieben.

Hyperic HQ Setup

Starten Sie einen Webbrowser und geben Sie als URL http://localhost:7080 bzw die Hostadresse und als Port 7080 ein. Sie sollten den HQ Login Bildschirm sehen. Der vorgegebene Benutzername und Passwort sind hqadmin und hqadmin.
Nach erfolgreichem Login befinden Sie sich auf dem sogenannten HQ Dashboard

Zunaechst sollte das Passwort geaendert werden:
Administration -> List Users -> Username "hqadmin" anklicken -> Password "Change"

Import einer neuen Plattform

Das Dashboard besteht aus verschiedenen Portlets, die unterschiedliche Arten von Informationen darstellen. Ein Portlet ist das sogenannte Auto-Discovery Portlet. Dort werden nach dem Auto Discovery einige Eintraege sichtbar sein, die durch die Installation des HQ Agent erstellt werden. Der Radiobutton neben dem Host ist ausgewaehlt. Werden dort Eintraege angezeigt und der Radio Button ist nicht ausgewaehlt, bitte klicken Sie ihn an. Jetzt klicken Sie auf Import um die Plattform und die Server zu importieren. Die Plattform und Server werden dem HQ Inventar hinzugefuegt und es erfolgt die Datensammlung nach den vorgegebenen Metriken fuer die inventarisierten Ressourcen. Erscheint der Hostname der Plattform im Portlet Recenty Added Resources war der Import erfolgreich.

Plattform Metriken

Die Zeitabstaende fuer die Datensammlung reichen je nach Metrik von einer bis zu zehn Minuten. Nach ein paar Minuten sollten die ersten Daten erfasst sein und Sie koennen auf der Plattform Metrik Seite betrachtet werden.

Um die Metric Data anzusehen gibt es mehere Moeglichkeiten. Der einfachste Weg besteht darin die ensprechende Plattform im Portlet Recenty Added Resources auf dem Dashboarb anzuklicken. Alle neuen oder aktualisierten Plattformen werden dort angezeigt. Alternativ kann es ueber den Link Browse Resources in der oberen Navigation erreicht werden. Dort klickt man die Plattform an ueber die die Informationen angezeigt werden sollen. Dies ist die Platform Indicator Seite.
Hier werden umfangreiche Informationen ueber den Status der Resource (in diesem Fall einer Plattform) sowie Informationen ueber die mit der Plattform verknuepften Resourcen dargestellt.

Auf der Indicator-Seite werden die zusammenhaengenden Indicator Views angezeigt. Zusammenhaengend heisst die verschiedenen Metriken ueber eine gemeinsame Zeitachse. Standardmaessig werden bei einer Platfrom einige Schluessel-Metriken der Maschine angezeigt. Der untere Teil des Indicator-Panels (der schwarze Balken mit den aufgesetzten Punkten) stellt eine anklickbare Zeitachse mit den individuellen Zeitfenstern dar. Jede Indikator-Grafik beinhaltet ein blaues Rechteck, dern Spitzenpunkt und Tiefpunkt jeweils den hoechsten und niedrigsten Wert darstellen der gemessen wurde. Die dunkelblaue Linie stellt den Durchschnittswert dar.

Die Indicator-Views koennen individuell angepasst werden um die Diagnosemoeglichkeiten zu verbessern und die Interaktion zwischen den verschiedenen Ressourcen zu verbessern. So koennen z.B. die Netzwerkschnittstellen Performance mit anderen Metriken der Plattform verglichen werden:

Um das zu tun geht man folgendermassen vor:

Waehlen Sie die Checkbox neben den "Nework Server Interfaces" aus.

Klicken Sie auf den Schalter "View Metrics" um die Liste der verfuegbaren Metriken fuer die Plattform anzuzeigen. Blaettern Sie durch die Liste bis Sie "Packets Transmitted Per Minute" sehen. Klicken Sie auf den Pfeil um die Metric zur derzeiten Ansicht hinzuzufuegen. Ueber die Pfeile rechts koennen Sie bestimmen in welcher Reihenfolge die jeweiligen Indikatoren angezeigt werden.

Um die Konfiguration abszuspeichern klicken Sei das Pfeil-Icon oben rechts in der Indicator View an. Es lassen sich mehrere Ansichten mit unterschiedlichen Namen erstellen. Dies ist nuetzlich, um korrellierende Kombinationen von Metriken und ihre Beziehungen untereinander darzustellen.

Man verfuegt jetzt ueber einen Graphen um sich die 5min-Last im Verhaeltnis zum Netzwerkverkehr auf der Plattform darzustellen.

Um sich spezifische Metrikdaten anzuzeigen oder weitere Metriken der Datensammlung hinzuzufuegen klicken Sie auf die Metric-Schaltflaeche. Dort wird die vollstaendige Liste aller Metriken angezeigt, fuer die HQ Daten erfaesst. Wenn die Datensammlung erst wenige Minuten laeuft werden dort auch nur sehr wenige Daten angezeigt.
Jede Metrik hat ein Icon rechts auf dieser Ansicht. Wird dieses Icon angeklickt oeffnet sich ein Fenster mit spezifischen Informationen ueber die Metrik.

Standardmaessig werden nur "Indikator"-Metriken gesammelt. Um mehr Daten zu erfassen, klickt man den Pfeil-Button neben dem Button Show All Metrics auf dem oberen Teil der Metric Data-Seite an. Jetzt werden alle Metriken anzeigt die fuer den jeweiligen Ressourcen-Typen gesammelt erfasst werden koennen. Waehlt man die Checkbox links neben den Metriken aus, kann man die Datenerfassung aktivieren oder das Intervall fuer die Erfassung der Daten veraendern. Zum Bestaetigen der Einstellungen wird der Pfeil Button rechts vom Feld fuer das Intervall angeklickt.

Import aus Nagios

Nagios ist ein beliebtes Open Source Monitoring Werkzeug. Hyperic bietet Nagios Nutzern die Moeglichkeit,
die bestehende Nagios Konfiguration und Nagios Checks in HQ zu uebernehmen. Wurde Nagios aus den Quellen gebaut,
wird es standardmaessig in /usr/local installiert. HQ findet diese Nagios Installation per Auto-Discovery.
Falls dies nicht der Fall ist, erstellt man den Service manuell. Dazu wird der Pfad zur zentralen Nagios-Konfigurationsdatei
nagios.cfg angegeben.
In diesem Beispiel gehen wir davon aus, das Nagios nicht automatisch entdeckt wird.
Zunaechst navigiert man zu der Plattform auf der Nagios installiert ist. Ueber das "Tools Menu" in der oberen rechten Ecke waehlt man "New Server" aus. Auf dem naechsten Schirm vergibt man einen Namen und waehlt als Service Type "Nagios"
aus.
Im "Install Path" Feld wird der Pfad zur nagios.cfg angegen. Jetzt klickt man auf den OK-Button. Werden weitere
Konfigurationseinstellungen benoetigt, erscheint danach ein Link mit einer entsprechenden Aufforderung.
Nach der Fertigstellung importiert Hyperic HQ automatisch die Nagios Konfiguration und die Nagios Checks.
Um die Nagios Checks zu bearbeiten, klickt man den Server Nagios und waehlt den Check aus den man bearbeiten moechte.
Fuer die Darstellung der Ausgaben aller Checks klickt man zunaechst auf "Resources" in der Top Navigation.
Dort sollte sich ein Eintrag "Nagios Availability" finden. Klickt man diesen Eintrag an, erhaelt man eine Ansicht aehnlich einer Nagios Installation.
Auf der linken Seite sind die Service Namen aufgelistet. In der Ansicht Monitoring View kann man sich die Verfuegbarkeit und Return Codes anzeigen lassen sowie die Konfiguration aendern.

Die Nagios Checks sind in HQ importiert. Aenderungen aus Hyperic HQ veraendern nich die Nagios Konfigurationsdateien, noch haben keine Einfluss wie Nagios die Checks ausfuehrt.