Oracle Management Agent Metric Browser
Ralf Durben, 03.02.2009

Oracle Enterprise Manager Grid Control arbeitet mit Agenten auf den verschiedenen Zielplattformen. Diese Agenten (Oracle Management Agent) sind unter Anderem für das Monitoring, also das Erfassen von Metriken zuständig. Es gibt Situationen, in denen die Metriken nicht im Repository von Grid Control ankommen und man sich auf die Suche nach der Ursache begeben muss. Auch bei der Erstellung eigener Plug-ins ist eine derartige Fehlersuche nicht unüblich.

Der erste Schritt dieser Fehlersuche sollte darin bestehen, zu schauen, ob der Oracle Management Agent die Metriken überhaupt erfassen kann. Dazu gibt es den Metrik Browser. Damit kann man sehen, welche Metriken der Agent zuletzt erfasst hat und welche Werte dabei erfasst wurden. Man sieht also immer den letzten Zustand - keine Zeitreihen.

Die Aktivierung und Nutzung des Metrik Browsers ist sehr einfach:

Schritt 1: Die Aktivierung


Auf der Agentenseite muss die Datei "$AGENT_HOME/sysman/config/emd.properties" editiert werden. In der Datei gibt es die folgende Zeile:
#enableMetricBrowser=true
Diese Zeile ist demnach auskommentiert. Entfernen Sie das Zeichen ”#” und damit wird die Einstellung aktiv. Der Agent muss noch neu gestartet
$AGENT_HOME/bin/emctl stop agent
$AGENT_HOME/bin/emctl start agent
oder die neue Einstellung einfach nur neu geladen werden
$AGENT_HOME/bin/emctl reload agent
Zum Deaktivieren des Metric Browsers fügt man einfach das Kommentarzeichen wieder ein und aktualisiert den Agenten.

Schritt 2: Die Nutzung


Der Agent kann immer über seine URL aufgerufen werden. Sie können die URL des jeweiligen Agenten in Grid Control ablesen. Navigieren Sie dazu über Setup->Agents auf die Übersicht aller Agenten.



Der Name des Agenten sollte schon der URL entsprechen. In meinem Beispiel soll der Metrik Browser des Agenten rdurben-gc.de.oracle.com:3872 aufgerufen werden. Dazu geben Sie in Ihrem Browser nun folgende URL ein:
https://hostname:3872/emd/browser/main
In diesem Fall ist die Kommunikation zwischen Agent und OMS per SSL gesichert, was der heutige Default ist und auch so betrieben werden sollte. Das Ergebnis sieht dann folgendermaßen aus:



Sie sehen eine Übersicht über alle von diesem Agenten überwachten Zieltypen. In meinem Beispiel werden auch Zieltypen angezeigt, die es so nicht von Oracle gibt und die ich per Plug-in selbst erstellt habe, wie zum Beispiel "popcorn_cluster" oder "popcorn_pipeline". Klicken Sie auf einen Zieltyp (in diesem Beispiel den Host):



sehen Sie alle Metriken, die für diesen Zieltyp erfasst werden. Ein Klick auf eine Metrik (in diesem Beispiel CPUUsage)



zeigt die zuletzt erfassten Werte.

Mit dem Metrik Browser des Oracle Management Agents können Sie schnell sehen, ob der Agent die Metriken erfassen kann. Ein Fehler auf Agentenseite kann so schnell gefunden werden. Der Metrik Browser sollte aber nicht dauerhaft eingeschaltet bleiben, da man ohne Authentifizierung Zugang zu Monitoring Daten hätte, denn die Kenntnis der Agenten-URL reicht zum Aufruf.

Impressum