1 Themenübersicht
Wichtige technische Kennzahlen eines Semiramis-Systems können im Betrieb in der Anwendung Systemcockpit überwacht werden. Beispielsweise liefern die Leitungsinformationen im Systemcockpit wichtige Kennzahlen zur Belastung des Systems. Die Indikatoren sind eine Möglichkeit, technische und betriebswirtschaftliche Kennzahlen im System zu überwachen. Das Überwachen kann sowohl innerhalb von Semiramis als auch mithilfe externer Überwachungs-Tools wie Nagios bzw. JConsole erfolgen. Zum Überwachen des Systems dienen die Indikatoren. In diesem Dokument finden Sie genauere Angaben zu den Indikatoren.
2 Zielgruppe
Systemadministratoren
3 Begriffsbestimmung
Java Management Extensions (JMX)
Die Spezifikation zur Verwaltung und Überwachung von Anwendungen, die in Java ausprogrammiert sind. Diese Spezifikation beschreibt die Architektur aus mehreren Schichten, Design Patterns, eine API, Verwaltungsdienste für Java-Anwendungen und Netzwerke sowie Überwachung-Dienste für Java.
Leistungsinformationen
Die Leistungsinformationen werden im Betrieb eines Application-Servers durch aktive Leistungsmonitore aufgezeichnet. Die Leistungsinformationen enthalten die Information, wie häufig bestimmte Monitoring-Ereignisse mit welcher Laufzeit eingetreten sind. Datenbank-Leistungsmonitore zeichnen die Leistungsinformationen in Business Objects auf der Datenbank auf. Datei-Leistungsmonitore zeichnen die Leistungsinformationen in Dateien auf
MBean
Ein Java-Objekt, das eine zu überwachende Komponente repräsentiert und der JMX-Spezifikation genügt. Ein MBean kann ein Hardware-Gerät oder eine Anwendung oder eine weitere Ressource repräsentieren. Für jeden Indikator erzeugt der Semiramis Application Server ein MBean.
Semiramis Application Server (SAS)
Ein Semiramis Application Server (SAS) verarbeitet über verschiedene Kommunikationskanäle gestellte Anfragen. Zur Laufzeit wird ein Semiramis Application Server durch einen Java-Virtual-Machine-Prozess realisiert, welcher die Semiramis-System-Engine ausführt. Die Definition der zum Start notwendigen Parameter (Name, Datenbankverbindungen, Basis-URL) erfolgt in der Systemkonfigurations-Datenbank.
Session
Eine Session ist ein Speicherbereich, der bei der Anmeldung der Benutzer und damit beim Start eines Systemdienstes reserviert wird. Die Instanzen, die innerhalb einer Session entstehen, sind von Objekten in anderen Sessions isoliert. Hierdurch wird ein Mehrbenutzerbetrieb ermöglicht. Soll ein Stück Programmlogik innerhalb einer Session ausgeführt werden, so wird ein Thread reserviert und diesem die Session für die Dauer der Ausführung als Arbeitsbereich zugeordnet.
4 Kurzbeschreibung
Indikatoren dienen der Überwachung eines Semiramis-Systems. Die Indikatoren können sowohl technische als auch betriebswirtschaftliche Größen anzeigen. Einige Indikatoren sind fest durch Semiramis vorgegeben. Zusätzliche Indikatoren können durch eine Programmierschnittstelle hinzugefügt werden. Alternativ können auch dynamische Indikatoren definiert werden. Dynamische Indikatoren werden mithilfe der Workflow-Aktivitätsdefinitionen berechnet. Nähere Informationen zu den dynamischen Indikatoren finden Sie im Dokument „Dynamische Indikatoren“. Indikatoren können in einer Semiramis-Anwendung und beispielsweise mithilfe der Tools „Nagios“ und „JConsole“ angezeigt werden.
Jeder Indikator verfügt über eine Menge der Attributen, die zu überwachende Parameter abbilden. Ein Indikator ist identifizierbar durch ein Namensraum und einen Namen, der auch außerhalb eines Semiramis-Systems als MBean zur Verfügung steht.
5 Indikatortypen
Im System stehen die folgenden Typen von Indikatoren zur Verfügung:
- Aggregationsindikatoren
- Zählerindikatoren
- Zahlindikatoren
- Zustandsindikatoren
Im Folgenden werden die Indikatortypen beschrieben.
5.1 Aggregationsindikator
Ein Aggregationsindikator zeigt statistische Informationen zu Ereignissen an, die eine addierbare Zahl beinhalten.
Beispiel:
Ein Aggregationsindikator kann die Summe und den Durchschnitt der Bruttobeträge der erzeugten Ausgangsrechnungen der letzten 15 Minuten anzeigen.
Die Attribute des Indikators im Einzelnen:
| Attribut | Datentyp | Erläuterung |
| Avg15m | Zahl | Durchschnitt aller Werte, die innerhalb der letzten 15 Minuten gemessen wurden. Der Durchschnitt ist nicht definiert, wenn der Semiramis Application Server vor weniger als 15 Minuten gestartet wurde. |
| Avg60s | Zahl | Durchschnitt aller Werte, die innerhalb der letzten 60 Sekunden gemessen wurden. Der Durchschnitt ist nicht definiert, wenn der Semiramis Application Server vor weniger als 60 Sekunden gestartet wurde. |
| Count15m | Zahl | Anzahl der Werte, die innerhalb der letzten 15 Minuten gemessen wurden. Die Anzahl ist nicht definiert, wenn der Semiramis Application Server vor weniger als 15 Minuten gestartet wurde. |
| Count60s | Zahl | Anzahl der Werte, die innerhalb der letzten 60 Sekunden gemessen wurden. Die Anzahl ist nicht definiert, wenn der Semiramis Application Server vor weniger als 60 Sekunden gestartet wurde. |
| Max15m | Zahl | Das Maximum der Werte, die innerhalb der letzten 15 Minuten gemessen wurden. Das Maximum ist nicht definiert, wenn der Semiramis Application Server vor weniger als 15 Minuten gestartet wurde. |
| Max60s | Zahl | Das Maximum der Werte, die innerhalb der letzten 60 Sekunden gemessen wurden. Das Maximum ist nicht definiert, wenn der Semiramis Application Server vor weniger als 60 Sekunden gestartet wurde. |
| Min15m | Zahl | Das Minimum der Werte, die innerhalb der letzten 15 Minuten gemessen wurden. Das Minimum ist nicht definiert, wenn der Semiramis Application Server vor weniger als 15 Minuten gestartet wurde. |
| Min60s | Zahl | Das Minimum der Werte, die innerhalb der letzten 60 Sekunden gemessen wurden. Das Minimum ist nicht definiert, wenn der Semiramis Application Server vor weniger als 60 Sekunden gestartet wurde. |
| Sum15m | Zahl | Summe der Werte, die innerhalb der letzten 15 Minuten gemessen wurden. Die Summe ist nicht definiert, wenn der Semiramis Application Server vor weniger als 15 Minuten gestartet wurde. |
| Sum60s | Zahl | Summe der Werte, die innerhalb der letzten 60 Sekunden gemessen wurden. Die Summe ist nicht definiert, wenn der Semiramis Application Server vor weniger als 60 Sekunden gestartet wurde. |
| Total Amount | Zahl | Summe aller Werte seit dem Start des Semiramis Application Servers. |
| Total Count | Zahl | Anzahl aller Werte seit dem Start des Semiramis Application Servers. |
| Unit | Zeichenkette | Die Einheit für den Indikator. |
5.2 Zählerindikator
Ein Zählerindikator zeigt die statistischen Informationen zu Ereignissen an.
Beispiel:
Ein Zählerindikator kann die Anzahl der in der letzten Minute erfassten Vertriebsaufträge anzeigen.
Die Attribute des Indikators im Einzelnen:
| Attribut | Datentyp | Erläuterung |
| Count15m | Zahl | Anzahl der Aufrufe, die innerhalb der letzten 15 Minuten durchgeführt wurden. Die Anzahl ist nicht definiert, wenn der Semiramis Application Server vor weniger als 15 Minuten gestartet wurde. |
| Count60s | Zahl | Anzahl der Aufrufe, die innerhalb der letzten 60 Sekunden durchgeführt wurden. Die Anzahl ist nicht definiert, wenn der Semiramis Application Server vor weniger als 60 Sekunden gestartet wurde. |
| Total | Zahl | Anzahl der Aufrufe seit dem Start des Semiramis Application Servers. |
5.3 Zahlindikator
Ein Zahlindikator zeigt einen Wert als Zahl an. Zahlindikatoren werden durch eine beliebige Logik berechnet.
Beispiel:
Ein Zahlindikator kann die Anzahl der offenen Kommissionen ausgeben.
Die Attribute des Indikators im Einzelnen:
| Attribut | Datentyp | Erläuterung |
| Unit | Zeichenkette | Die Einheit für den Indikator. |
| Value | Zahl | Der Wert des Indikators. |
5.4 Zustandsindikator
Dieser Indikator zeigt Statuswerte an. Zustandsindikatoren werden durch eine beliebige Logik berechnet.
Beispiel:
Ein Zustandsindikator kann den Speicherstatus des Application-Servers ausgeben.
Die Attribute des Indikators im Einzelnen:
| Attribut | Datentyp | Erläuterung |
| state | Zeichenkette | Die technische Identifikation eines Zustandes. |
| stateDescription | Zeichenkette | Die Beschreibung eines Zustandes. |
Hinweis:
Dieser Indikator kann nicht nur die Value-Set-Einträge in Semiramis abbilden (wie etwa „Abgebrochen“ bzw. „In Bearbeitung“). Der Name des Semiramis-Systems wird auch als Zustand abgebildet.
6 Indikatoren in Semiramis
Die Indikatoren in Semiramis beziehen sich auf unterschiedliche Datenbanken. Deshalb stehen Indikatoren für die folgenden Ebenen bereit:
- OLTP-Datenbank
- Repository-Datenbank
- Application-Server
- System
Indikatoren werden durch einen voll qualifizierten Namen identifiziert. Der Namensraum ist abhäng von dem Erstellungssystem, der Ebene und weiteren Kriterien:
- „com“
- Entwicklungspräfix (z. B. „cisag“)
- Entwicklungskategorie „app“ oder „pgm“ („app“ ist für die Anwendungsentwicklung reserviert und „pgm“ für Standard-Systementwicklung).
- Verwendungszweck (z. B. der Datenbankname; alternativ „system“ für das ganze Semiramis-System oder „server“ für den Semiramis-Applicaton-Server, auf dem den Indikator abgefragt wird).
Beispiel:
Für die OLTP-Datenbank „ADV45001“ mit dem Entwicklungspräfix „cisag“ befinden sich die Indikatoren, die für die OLTP-Datenbank zur Verfügung stehen, in folgendem Namensraum:
com.cisag.pgm.ADV45001
Der Namensraum für dynamische Indikatoren beginnt immer mit „com.dynamic“ gefolgt von der Bezugsebene.
Beispiel:
Dynamische Indikatoren für die OLTP-Datenbank „ADV45002“ haben folgenden Namensraum:
com.dynamic.ADV45002
6.1 Indikatoren auf Datenbankebene
Indikatoren mit Bezug zu einer Datenbank haben einen Namensraum nach dem Schema „com.cisag.pgm.<Datenbankname>“. Die Indikatoren für die Repository-Datenbank und jede OLTP-Datenbank stehen folgenden Indikatoren zur Verfügung:
| Name | Typ | Erläuterung |
| ActiveDatabaseConnections | Zahlindikator | Anzahl aktiver Verbindungen zur Datenbank. Eine Verbindung ist aktiv, wenn sie Anfragen, sonstige Befehle oder Daten überträgt. Da Anfragen im Allgemeinen sehr kurz sind, sollten normalerweise nur wenige Verbindungen aktiv sein. |
| ObjectManagerHitRate | Zahlindikator | Anteil der Anfragen an den Persistenzdienst, die aus dem Cache beantwortet werden konnte. |
| OpenDatabaseConnections | Zahlindikator | Anzahl offener Datenbankverbindungen. |
6.2 Indikatoren auf Ebene des Semiramis Application Servers
Für einen Semiramis Application Server stehen folgenden Indikatoren im Namensraum „com.cisag.server“ zur Verfügung:
| Name | Typ | Erläuterung |
| ActiveBatchSessions | Zahlindikator | Anzahl der aktiven Sessions mit dem Typ „Hintergrundverarbeitung“. |
| ActiveCORBASessions | Zahlindikator | Anzahl der aktiven Sessions mit dem Typ „CORBA-Zugriff“. |
| ActiveDialogSessions | Zahlindikator | Anzahl der aktiven Sessions mit dem Typ „Dialogzugriff“. |
| ActiveWebServiceSessions | Zahlindikator | Anzahl der aktiven Sessions mit dem Typ „SOAP-Zugriff“. |
| AllActiveSessions | Zahlindikator | Anzahl aller aktiver Sessions. |
| ApplicationServerMemoryLevel | Zustandsindikator | Die Speicherwarnstufe für den Semiramis Application Server. Mögliche Werte für den Zustand sind:
· „OK“ · „LOW“ In der Bezeichnung wird der zur Verfügung stehende Anwendungsspeicher angezeigt. |
| ApplicationServerName | Zustandsindikator | Der Name des aktuellen Semiramis Application Servers. |
| ApplicationServerRuntime | Zahlindikator | Betriebsdauer des Semiramis Application Servers seit dem letzten Start. |
| ApplicationServerStatus | Zustandsindikator | Zustand des Application-Servers. Mögliche Zustände sind:
· „NEW“: Neu · „STARTING“: Wird gestartet · „RUNNING“: In Betrieb · „RESTARTING“: Wird neu gestartet · „STOPPING“: Wird heruntergefahren · „NOT_CONNECTED“: Nicht in Betrieb · „NOT_RESPONDING“: Antwortet nicht · „HOLDING“: Wird angehalten · „UNKNOWN“: Unbekannt |
| DialogMonitoringInfoAvg | Zahlindikator | Durchschnittliche Ausführungszeiten in Millisekunden, bezogen auf die Anzahl der Ausführungen in den Sessions mit dem Typ „Dialogzugriff“ und die Operation „Roundtrip performAction“. |
| DialogMonitoringInfoStdDev | Zahlindikator | Abschätzung für die Standardabweichung von der mittleren Ausführungszeit in Millisekunden, bezogen auf die Ausführungen in den Sessions mit dem Typ „Dialogzugriff“ und die Operation „Roundtrip performAction“. |
| DialogMonitoringInfox_0x5 | Zahlindikator | Anteil der Ausführungen in Promille für die Operation „Roundtrip performAction“ in den Sessions mit dem Typ „Dialogzugriff“, die zwischen 0 und 500 Millisekunden benötigten. |
| DialogMonitoringInfox0x5_1 | Zahlindikator | Anteil der Ausführungen in Promille für die Operation „Roundtrip performAction“ in den Sessions mit dem Typ „Dialogzugriff“, die zwischen 500 und 1000 Millisekunden benötigten. |
| DialogMonitoringInfox1_2 | Zahlindikator | Anteil der Ausführungen in Promille für die Operation „Roundtrip performAction“ in den Sessions mit dem Typ „Dialogzugriff“, die zwischen 1 und 2 Sekunden benötigten. |
| DialogMonitoringInfox2_5 | Zahlindikator | Anteil der Ausführungen in Promille für die Operation „Roundtrip performAction“ in den Sessions mit dem Typ „Dialogzugriff“, die zwischen 2 und 5 Sekunden benötigten. |
| DialogMonitoringInfox5_ | Zahlindikator | Anteil der Ausführungen in Promille für die Operation „Roundtrip performAction“ in den Sessions mit dem Typ „Dialogzugriff“, die länger als 5 Sekunden benötigten. |
| WebServiceMonitoringInfoAvg | Zahlindikator | Durchschnittliche Ausführungszeiten in Millisekunden, bezogen auf die Anzahl der Ausführungen in den Sessions mit dem Typ „SOAP-Zugriff“ und die Operation „Anwendungsaktion ausführen“. |
| WebServiceMonitoringInfoStdDev | Zahlindikator | Abschätzung für die Standardabweichung von der mittleren Ausführungszeit in Millisekunden, bezogen auf die Ausführungen in den Sessions mit dem Typ „SOAP-Zugriff“ und die Operation „Anwendungsaktion ausführen“. |
| WebServiceMonitoringInfox_0x5 | Zahlindikator | Anteil der Ausführungen in Promille für die Operation „Anwendungsaktion ausführen“ in den Sessions mit dem Typ „SOAP-Zugriff“, die zwischen 0 und 500 Millisekunden benötigten. |
| WebServiceMonitoringInfox0x5_1 | Zahlindikator | Anteil der Ausführungen in Promille für die Operation „Anwendungsaktion ausführen“ in den Sessions mit dem Typ „SOAP-Zugriff“, die zwischen 500 und 1000 Millisekunden benötigten. |
| WebServiceMonitoringInfox1_2 | Zahlindikator | Anteil der Ausführungen in Promille für die Operation „Anwendungsaktion ausführen“ in den Sessions mit dem Typ „SOAP-Zugriff“, die zwischen 1 und 2 Sekunden benötigten. |
| WebServiceMonitoringInfox2_5 | Zahlindikator | Anteil der Ausführungen in Promille für die Operation „Anwendungsaktion ausführen“ in den Sessions mit dem Typ „SOAP-Zugriff“, die zwischen 2 und 5 Sekunden benötigten. |
| WebServiceMonitoringInfox5_ | Zahlindikator | Anteil der Ausführungen in Promille für die Operation „Anwendungsaktion ausführen“ in den Sessions mit dem Typ „SOAP-Zugriff“, die länger als 5 Sekunden benötigten. |
6.3 Indikatoren auf Systemebene
Für ein Semiramis-System stehen alle Indikatoren zur Verfügung, die auf Ebene des Semiramis Application Servers und auf der Datenbankebene zur Verfügung stehen. Auf Systemebene werden die Werte der Indikatoren über alle Semiramis Application Server aggregiert. Nur die Indikatoren, die für den Semiramis Application Server spezifisch sind (ApplicationServerName, ApplicationServerRuntime, ApplicationServerStatus), stehen auf Systemebene nicht zur Verfügung. Alle Indikatoren befinden sich in dem Namensraum „com.cisag.system“.
Zusätzlich gibt es auf Systemebene folgende Indikatoren:
| Name | Typ | Erläuterung |
| BatchJobProcessingTime | Aggregationsindikator | Statische Informationen über die Laufzeit der Verarbeitungsaufträge. |
| CORBARequestRuntime | Aggregationsindikator | Statische Informationen über die Laufzeit der CORBA-Anfragen. |
| CORBASessionRuntime | Aggregationsindikator | Statische Informationen über die Laufzeit der Sessions mit dem Typ „CORBA-Zugriff“. |
| GUIRoundtripRuntime | Aggregationsindikator | Statische Informationen über die Laufzeit der GUI-Roundtrips. |
| SQLStatementRuntime | Aggregationsindikator | Statische Informationen über die Laufzeit der SQL-Abfragen. |
| WebServiceRequestRuntime | Aggregationsindikator | Statische Informationen über die Laufzeit der SOAP-Anfragen. |
| WebServiceSessionRuntime | Aggregationsindikator | Statische Informationen über die Laufzeit der Sessions mit dem Typ „SOAP-Zugriff“. |
| Login | Zählerindikator | Anzahl der Anmeldungen im aktuellen Semiramis-System. |
| Logout | Zählerindikator | Anzahl der Abmeldungen im aktuellen Semiramis-System. |
| Systemname | Zustandsindikator | Der Name des aktuellen Semiramis-Systems wird angezeigt. |
7 Indikatoren abfragen
Die Indikatoren können auf verschiedene Weise abgefragt werden. In der Anwendung „Indikatoren anzeigen“ können Sie sich die Indikatoren anzeigen lassen. Weitere Informationen finden Sie in der Dokumentation „Indikatoren anzeigen“.
Zusätzliche Möglichkeiten bieten externe Tools. Weitere Informationen finden Sie in der Dokumentation „Indikatoren in JConsole anzeigen“.