KPI-Verlaufsprotokoll importieren
Mit dem Script 'ImportKpiHistory' kann das KPI-Verlaufsprotokoll zu mindestens einem wesentlichen Leistungsindikator (KPI - Key Performance Indicator) erstellt oder aktualisiert werden. Die Modellversion und der KPI müssen zuvor auf dem Monitor Server implementiert worden sein.
Zweck
Mit dem Script 'ImportKpiHistory' wird das KPI-Verlaufsprotokoll für ein oder mehrere wesentliche Leistungsindikatoren (KPIs) erstellt oder aktualisiert.
Position
monitor_stammverzeichnis/scripts.wbm/kpi/importKpiHistory.jyFormat der Dateien für den Import des KPI-Verlaufsprotokolls
Die Dateien des KPI-Verlaufsprotokolls werden unter Verwendung des im nächsten Abschnitt beschriebenen Jython-Scripts importiert. Vor dem Upload müssen die Dateien des KPI-Verlaufsprotokolls auf den Monitor Server kopiert werden. Falls Datensätze aus der Importdatei des KPI-Verlaufsprotokolls nicht in der Tabelle des KPI-Verlaufsprotokolls vorhanden sind, werden die Zeilen hinzugefügt. Ist ein Datensatz bereits vorhanden, werden der Protokollwert (History Value), der Zeitpunkt der Protokollaktualisierung (History Update Time), die Basiszeit für die Vorhersage (Prediction Basis Time) und der Basiswert für die Vorhersage (Prediction Basis Value) aktualisiert. Vom Dienstprogramm für den Import von KPI-Verlaufsprotokollen wird eine tabulatorbegrenzte Datei im folgenden Format verwendet:
| Feld | Beispiel | Beschreibung |
|---|---|---|
| MODELL-ID | Bestellartikel | Die Monitor-Modell-ID. Nur zum Erstellen, kann nicht aktualisiert werden. |
| KPI-ID | AktuellerDurchschnittspreis | ID eines wesentlichen Leistungsindikators (KPI - Key Performance Indicator). KPIs für die Zeitdauer werden in Millisekunden angegeben. Nur zum Erstellen, kann nicht aktualisiert werden. |
| VERSION | 20080918060000 | Version des Monitor-Modells. Nur zum Erstellen, kann nicht aktualisiert werden. |
| PERIOD_TIMESTAMP (Zeitraumszeitmarke) | 2009-01-01T04:00:00 | Referenzzeitmarke für das KPI-Verlaufsprotokoll. Nur zum Erstellen, kann nicht aktualisiert werden. |
| OBSERVED_TIME (Beobachtete Zeit) | 2009-01-01T04:04:21 | Tatsächlicher Zeitpunkt der Aufzeichnung des KPI-Verlaufsprotokolls. Nur zum Erstellen, kann nicht aktualisiert werden. |
| OBSERVED_VALUE (Beobachteter Wert) | 556.23 | Tatsächlicher Wert des KPI zum Zeitpunkt der Beobachtung. Nur für den Import, kann nicht aktualisiert werden. |
| TARGET (Ziel) | 1000 | Zielwert des KPI. Nur zum Erstellen, kann nicht aktualisiert werden. |
| HISTORY_UPDATE_TIME (Protokollaktualisierungszeit) | 2009-01-01T04:04:21 | Zeitpunkt der letzten Aktualisierung des KPI-Verlaufsprotokollwerts. Dieser Wert kann beim Import aktualisiert werden. |
| HISTORY_VALUE (Protokollwert) | 556.23 | Für das KPI-Verlaufsprotokoll beim REST-Abruf verwendeter Wert. Es handelt sich hierbei um den tatsächlich vom REST-Service für KPI-Verlaufsprotokolle vorgelegten Wert für die grafische Darstellung. Dieser Wert kann beim Import aktualisiert werden. |
| PREDICTION_BASIS_TIME (Basiszeit für Vorhersage) | 2009-01-01T04:04:21 | Zeitpunkt, an dem der KPI-Vorhersagebasiswert zuletzt aktualisiert wurde. Dieser Wert kann beim Import aktualisiert werden. |
| PREDICTION_BASIS_VALUE (Basiswert der Vorhersage) | 556.23 | Für das Dienstprogramm zur KPI-Vorhersage verwendeter Wert. Dieser Wert kann aktualisiert werden, um inkonsistente Daten, die zu irrtümlichen KPI-Vorhersagen führen könnten, auszugleichen. Dieser Wert kann beim Import aktualisiert werden. |
Ergebnisse des KPI-Verlaufsprotokollimports
Vom Dienstprogramm für den Import des KPI-Verlaufsprotokolls wird eine Datei generiert, an deren Ende die Erweiterung .discard angehängt ist. In dieser Datei sind die nicht importierten Datensätze enthalten. Lautet der Name der Importdatei beispielsweise importdata.csv, wird die Datei mit den verworfenen Datensätzen unter der Bezeichnung importdata.csv.discard generiert.
Parameter
| Parameter | Beschreibung | Kommentar |
|---|---|---|
| Name_der_Importdatei | Der Name der zu importierenden Datei. | |
| Hostname | Der Name des Hosts, auf dem IBM® Business Monitor installiert ist. Dieser Name kann localhost lauten. | |
| Portnummer | Der SOAP-Connector-Port des WebSphere Application Server-Servers. Sie finden diese Informationen in der Administrationskonsole von WebSphere Application Server unter . |
Verwendung unter Windows
- Bei einer eigenständigen IBM Business Monitor-Umgebung:
profilstammverzeichnis\bin> wsadmin -wsadmin_classpath "..\..\..\plugins\com.ibm.wbimonitor.lifecycle.spi.jar;..\..\..\plugins\com.ibm.wbimonitor.repository.jar" -lang jython -f "..\..\..\scripts.wbm\kpi\importKpiHistory.jy" Name_der_Importdatei.csv -conntype SOAP -host Hostname -port Portnummer
- Für Rational Application Developer Development Toolkit:
profilstammverzeichnis\bin> wsadmin -wsadmin_classpath "..\..\..\plugins\com.ibm.wbimonitor.lifecycle.spi.jar;..\..\..\plugins\com.ibm.wbimonitor.repository.jar" -lang jython -f "..\..\..\scripts.wbm\kpi\importKpiHistory.jy" Name_der_Importdatei.csv -conntype SOAP -host Hostname -port Portnummer
- Für Integration Designer Development Toolkit:
profilstammverzeichnisbin> wsadmin -wsadmin_classpath "..\..\..\plugins\com.ibm.wbimonitor.lifecycle.spi.jar;..\..\..\plugins\com.ibm.wbimonitor.repository.jar" -lang jython -f "..\..\..\scripts.wbm\kpi\importKpiHistory.jy" Name_der_Importdatei.csv -conntype SOAP -host Hostname -port Portnummer
importKpiHistory.jy "c:\kpiHistoryExport.xml" -conntype SOAP -host localhost -port 8880
Verwendung unter Linux und UNIX
- Bei einer eigenständigen IBM Business Monitor-Umgebung:
profilstammverzeichnis/bin> ./wsadmin.sh -wsadmin_classpath "../../../plugins/com.ibm.wbimonitor.lifecycle.spi.jar:../../../plugins/com.ibm.wbimonitor.repository.jar" -lang jython -f "../../../scripts.wbm/kpi/importKpiHistory.jy" Name_der_Importdatei.csv -conntype SOAP -host Hostname -port Portnummer
importKpiHistory.jy "/kpiHistoryExport.xml" -conntype SOAP -host localhost -port 8880