OBTM: Mandantenfähigkeit konfigurieren

Da Dienste im Unternehmen hoffentlich Abteilungs- oder Bereichsübergreifend eingesetzt werden, macht es Sinn das Monitoring mandantenfähig aufzusetzen. Dieses wird in OBTM durch die sog. Consumers umgesetzt. Letztendlich werden Consumers durch speziell gekennzeichnete Properties unterschieden.

Um die Mandantenfähigkeit zu aktivieren, wird also zunächst für einen Service eine neue Property angelegt über 'Create|Message Property on sayHello'

Dann wieder 'Pick from Message...' auswählen...

... und in dem sich öffnenden Dialog wieder arg0 auswählen. Beenden mit OK.

Dann wird der Haken gesetzt bei 'Map to customer through attribute'. Damit wird OBTM mitgeteilt, dass es sich um eine spezielle Property handelt, welchen den Consumer beinhaltet. Beenden mit OK.

Auch diese Property wird mit der bereits bestehenden 'Name'-Property im Properties-Tab dargestellt. Durch das Personen-Symbol vor der Property wird gekennzeichnet, dass es sich hierbei um einen Property handelt die einen Consumer identifiziert.

Ebenso wird die Consumer-Property im Properties-Tab der Transaction angezeigt.

Damit die Consumer-Property für die Greeting-Transaktion auch greift, muss in den Einstellungen der Transaction (Modify|Edit Greeting) auf dem Tab 'Segmentation' noch der Haken bei 'Enable consumer segmentation' gesetzt werden.

Um die Consumer jetzt zu erfassen, starten wir wieder den WebLogic Test Client und rufen den HelloProxy-Service ein paar Mal jeweils mit 'Bereich-1' und 'Bereich-2' auf.

Die Segmentierung der Transaktion nach Consumer lässt sich dann auf dem Tab Analysis, sub-Tab Consumer Usage anzeigen. Die 'Unknown'-Einträge sind alte Einträge aus der Zeit bevor die Segmentierung eingeschaltet war.

Auch im Bereich Consumers werden nach kurzer Zeit die beiden Bereiche angezeigt (ggf. ca. 5min. warten). Dabei werden für die beiden Mandanten unterschiedliche Laufzeiten für die Services angezeigt, nämlich für jeden Mandanten die bei der Bearbeitung seiner spezifischen Anfragen angefallenen Werte.

Verursacht man absichtlich eine Störung, z.B. indem man den SOA-Server herunterfährt und startet während der Downtime nur Anfragen für einen Mandanten (z.B. Bereich-1), dann wird auch nur für diesen das Problem angezeigt. Im Bild oben sieht man, dass die Kurven für gestartete und erfolgreich abgeschlossene Transaktionen deutlich auseinander gehen. Startet man während der Downtime keine Transaktionen für den anderen Mandanten, wird diesem auch kein Problem angezeigt.

Somit lassen sich über das Consumers-Feature von OBTM auch mandantenspezifische Auswertungen durchführen.

---> Alerting

OBTM: Arbeiten mit Properties

Properties dienen hauptsächlich dazu, um bestimmte Eigenschaften einer Transaktion hervorzuheben. So kann z.B. bei einer Bestellung schnell die Kunden- oder Auftragsnummer eingesehen werden, ohne dass die kompletten SOAP-Nachrichten untersucht werden müssen.

Dadurch, dass wir bei der Erstellung der Business Transaction gleich eine Property mit angelegt haben, kann diese auch im folgenden Beispiel direkt benutzt werden.

Sofern noch keine Property angelegt wurde, kann dies auch einfach nachgeholt werden, indem man in einer beliebigen Darstellung einen Service auswählt und dann 'Create|Message Property on ...' auswählt.

Für die folgende Übung sollte der HelloProxy Service ein paar Mal mit unterschiedlichen Parametern aufgerufen werden.

Die Properties werden dann z.B. angezeigt bei der Transaktion unter Instances.

Auch im Message Log werden die Properties in separaten Spalten aufgeführt. Über den 'Choose Content...'-Link kann die Ausgabe gefiltert werden.

Die Auswahlbox hinter 'Name' wird auf 'matching' gestellt.

Dann wird ein Suchtext eingegeben, weiter mit OK.

Dann auf 'Search' klicken (und auf den Zeitrahmen links) achten, und es werden nur noch Einträge im Message Log angezeigt, die dem Suchbegriff entsprechen.

Eine weitere Möglichkeit, die Nachrichten zu durchsuchen, bietet der Menüpunkt 'View|Search Message Log'.

In einem separaten Fenster öffnet sich das Search Message Log Tool. Hier kann die Suche wieder über den 'Choose Content ...'-Link eingegrenzt werden.

Mit entsprechender Eingrenzung werden wieder nur die Messages angezeigt, bei denen ein Property einen bestimmten Wert enthält, in diesem Fall Name=Arne. In der Detail Pane werden hier zusätzlich die Details der jeweiligen Nachricht angezeigt.

Der 'View XML'-Link macht genau das: das Ergebnis in XML anzeigen.

Die Properties können also genutzt werden, um die für den jeweiligen Anwender relevanten Informationen hervorzuheben. In Real-World Szenarien wären das z.B. Kunden-, Auftrags- oder Vorgangsnummern, auf die schnell zugegriffen werden kann ohne dass die kompletten Nachrichten untersucht werden.

Ruft beispielsweise ein Kunde im Call-Center an und fragt nach seiner Bestellung, kann auf diese Weise schnell herausgefunden werden, ob die Verarbeitung des Auftrags mit der entsprechenden Nummer irgendwo hängt.

---> Mandantenfähigkeit konfigurieren

OBTM: Business Transaction definieren

Nachdem nun das Setup des Szenarios abgeschlossen ist, kann eine erste Business-Transaction definiert werden. Hierzu wird wieder die BTMUI gestartet.

Unter dem Menüpunkt 'Create' geht es los mit 'Transaction'

Jetzt muss eine Operation gewählt werden, mit der die Transaktion startet. In diesem Fall wird sayHello unter sayHelloProxyService ausgewählt.

Die weiteren Operationen werden aufgrund der bereits erfolgten Discovery automatisch gefunden.

Das Instance- und Message Logging wird auf dem Tab 'Logging' eingeschaltet. Für das Message Logging müssen unten die Operationen ausgewählt werden.

Auf dem Tab 'Message Keys' können noch die Properties definiert werden. Properties werden auch protokolliert, wenn nicht die gesamte Nachricht abgespeichert wird. 

Hierzu wird das Dropdown Menu mit dem Titel 'Message Fingerprint' aufgeklappt und 'New Property...' ausgewählt.

In den sich öffnenden Dialog gibt es mehrere Möglichkeiten, die Property zu definieren. In diesem Beispiel geht es weiter via 'Pick from Message...'.

Die Auswahl fällt in diesem Fall leicht, arg0 auswählen und weiter mit OK.

Anstelle von 'Pick from Message...' wird nun request.sayHello.arg0 angezeigt. Die Property bekommt noch einen Namen wie hier z.B. 'Name'. Dann den Dialog mit OK schliessen.

Der Vorgang wird für alle vier Keys wiederholt. Beim Start key von bpelprocess1_client_ep.process wird 'Name' bereits als Alternative angeboten und kann direkt ausgewählt werden.

Auf dem letzten Tab sind die Speicher-Einstellungen. Hier sollte der Haken 'Text index message content' per default gesetzt sein. Der Dialog wird mit OK geschlossen.

Die neue Transaction wird nun unter Transactions angezeigt. Weiter geht es in der WLS Console der Domain, in welcher der sayHelloProxyService läuft.

Wie im vorherigen Kapitel wird der Service jetzt wieder mehrfach ausgeführt. Dann geht es wieder zurück in die BTM UI.

Unter Transactions werden jetzt die ermittelten Informationen angezeigt. Über das Plus (+) vor Greeting werden die beteiligten Operations angezeigt. Im Detail-Fenster wird unten das Transaction Summary Dashboard angezeigt. In der schematischen Darstellung werden jetzt auch die durchschnittlichen Antwortzeiten dargestellt.

Im Tab 'Analysis' werden weitere Informationen angezeigt wie Started Transactions sowie Max und Average Response Time.

Unter 'Instances' werden - je nach Filter - die bisherigen Instanzen angezeigt. Per Klick auf eine eine Instanz öffnet sich das Fenster mit den protokollierten Messages.

Neben einer schematischen Darstellung der Transaction werden hier alle protokollierten Messages aufgeführt. Per Klick auf das Lupensymbol links lassen sich diese anzeigen.

In einem neuen Fenster wird die gespeicherte Nachricht angezeigt. Über einen der beiden 'View XML'-Links lässt sich die jeweilige Nachricht vollständig anzeigen.

Die Nachricht wird in einem neuen Browser-Fenster geöffnet. Anschliessend können die beiden extra-Fenster wieder geschlossen werden, so dass nur noch die BTM-UI geöffnet ist.

Die Messages können auch über den Tab 'Message Log' eingesehen werden.

Im Tab 'Properties' werden alle definierten Properties angezeigt.

Damit ist die erste Business Transaction definiert und kann im weiteren genutzt werden.

---> Arbeiten mit Properties