CA Unified Infrastructure Management Unified Reporter
Werbung
CA Unified Infrastructure Management®Unified Reporter™ Schnellstart-Handbuch 8.0 Revisionsverlauf Document Version Datum Änderungen 1.0 September 2014 Ursprüngliche Version für UR 8.0. CA Nimsoft Monitor-Copyright-Hinweis Dieses Onlinehilfe-System (das "System") dient nur Informationszwecken und kann von CA jederzeit geändert oder entfernt werden. Dieses System darf ohne vorherige schriftliche Genehmigung von CA weder vollständig noch auszugsweise kopiert, übertragen, vervielfältigt, veröffentlicht, geändert oder dupliziert werden. Dieses System besteht aus vertraulichen und proprietären Informationen von CA und ist durch Urheberrechtsgesetze der Vereinigten Staaten und internationale Verträgen geschützt. Sie dürfen das System ausschließlich zu den durch eine separate Vereinbarung bezüglich der Verwendung von vom System verwendeter Software von CA ("CA-Software") erlaubten Zwecken veröffentlichen und nutzen. Dieser Hinweis ersetzt die Bedingungen einer solchen Vereinbarung in keiner Weise. Ungeachtet des Vorangehenden können Sie als Benutzer mit einer Lizenz für CA-Software eine Kopie des Systems für internen Gebrauch Ihrerseits und Ihrer Mitarbeitern anfertigen, vorausgesetzt, alle CA-Copyright-Hinweise und Legenden sind in der Kopie enthalten. Das Recht zum Anfertigen einer Kopie des Systems beschränkt sich auf den Zeitraum der vollen Wirksamkeit der Lizenz für die CA-Software. Sollte die Lizenz aus irgendeinem Grund enden, bestätigt der Lizenznehmer gegenüber CA schriftlich, dass alle Kopien oder Teilkopien der Dokumentation vernichtet worden sind. CA STELLT DIESES SYSTEM GEMÄSS GELTENDEM GESETZ IM VORLIEGENDEN ZUSTAND OHNE JEGLICHE GEWÄHRLEISTUNG ZUR VERFÜ GUNG; DAZU GEHÖ REN, OHNE SICH JEDOCH DARAUF ZU BESCHRÄNKEN, STILLSCHWEIGENDE GEWÄHRLEISTUNGEN DER MARKTTAUGLICHKEIT, DER EIGNUNG FÜ R EINEN BESTIMMTEN ZWECK UND DER NICHTVERLETZUNG VON RECHTEN. IN KEINEM FALL HAFTET CA GEGENÜ BER DEM ENDANWENDER ODER DRITTEN FÜ R VERLUSTE ODER UNMITTELBARE ODER MITTELBARE SCHÄDEN, DIE AUS DER VERWENDUNG DIESES SYSTEMS ENTSTEHEN; DAZU GEHÖ REN, OHNE SICH JEDOCH DARAUF ZU BESCHRÄNKEN, ENTGANGENE GEWINNE, VERLORENE INVESTITIONEN, BETRIEBSUNTERBRECHUNG, VERLUST IDEELLER UNTERNEHMENSWERTE ODER DATENVERLUST, SELBST WENN CA Ü BER DIESEN VERLUST ODER SCHADEN INFORMIERT WURDE. Der Hersteller dieses Systems ist CA. Es gelten "Eingeschränkte Rechte". Die Verwendung, Vervielfältigung oder Veröffentlichung durch die Regierung der Vereinigten Staaten oder deren Nachfolgerin unterliegt den jeweils in den Abschnitten FAR 12.212, 52.227-14 und 52.227-19(c)(1) (2) sowie dem Abschnitt DFARS 252.227-7014(b)(3) festgelegten Einschränkungen. Copyright © 2014 CA. All rights reserved. Alle hierin verwendeten Markenzeichen, Markennamen, Dienstleistungsmarken und Logos sind Eigentum der jeweiligen Unternehmen. Rechtliche Information zu Softwareprodukten von Drittanbietern und freier Software, die in der Nimsoft Monitor-Lösung verwendet werden, sind unter Nimsoft Monitor Third-Party Licenses and Terms of Use (http://docs.nimsoft.com/prodhelp/en_US/Library/Legal.html) dokumentiert. Kontaktaufnahme mit CA Nimsoft Kontaktaufnahme mit CA Support CA Technologies stellt Ihnen eine Site zur Verfügung, von der aus Sie auf alle Informationen, die Sie für Ihre Home Office-, Small Business-, and Enterprise-Produkte von CA Technologies benötigen, zugreifen können. Unter http://ca.com/support finden Sie folgende Ressourcen: ■ Kontaktinformationen für technische Unterstützung und Kundenservice (online oder telefonisch) ■ Informationen zu Benutzer-Communitys und Foren ■ Download von Produkt und Dokumentation ■ CA Support-Grundsätze und -Leitlinien ■ Andere hilfreiche Ressourcen für Ihr Produkt Ihr Feedback zur Produktdokumentation Senden Sie an [email protected] Kommentare oder Fragen zur CA Technologies Nimsoft-Produktdokumentation. Wenn Sie uns Feedback zu CA Technologies-Produktdokumentationen senden möchten, nehmen Sie an unserer kurzen Kundenumfrage teil, die auch auf der CA Support-Website unter http://ca.com/docs zu finden ist. Inhalt Kapitel 1: Einführung 7 So erhalten Sie Unified Reporter .................................................................................................................................. 8 Benutzer und Berechtigungen...................................................................................................................................... 8 Hinzufügen von Benutzern zu UIM ....................................................................................................................... 8 Ordnerstruktur ............................................................................................................................................................. 9 Kapitel 2: Mitgelieferte Berichte 11 Optionen für mitgelieferte Berichte ........................................................................................................................... 11 Bearbeiten der standardmäßigen Wertliste ....................................................................................................... 12 Liste von mitgelieferten Berichten ............................................................................................................................. 12 Kapitel 3: Entwerfen von Ad-hoc-Ansichten 17 Kapitel 4: Einrichten von iReport 19 Einrichten von iReport ............................................................................................................................................... 19 Abfrage-Executer........................................................................................................................................................ 22 Installieren der kommerziellen iReport-Lizenz........................................................................................................... 23 Kapitel 5: Verwenden von benutzerdefinierten Abfragesprachen 25 NimsoftJSONTopN-Abfragesprache ........................................................................................................................... 25 NimsoftJSONTimeSeries-Abfragesprache .................................................................................................................. 27 Inhalt 5 Kapitel 1: Einführung Unified Reporter (UR) ist eine optionale Komponente, die eine erweiterte Berichterstellung für Unicenter Management Portal (UMP) bereitstellt. UR bietet folgende Funktionen: ■ Drag-and-drop der Ad-hoc-Berichterstellung. ■ Drag-and-drop der Dashboard-Erstellung mit Aktualisierung in Echtzeit und Mashups von externem Inhalt. ■ Integrierte Diagrammerstellung mit Kreisdiagrammen, Balkendiagrammen, Liniendiagrammen, Flächendiagrammen, Diagrammen mit mehreren Reihen und vielen anderen Diagrammtypen. ■ Eine Bibliothek mit Standardberichten (out-of-box; OOB), mit denen Sie Zeit und Aufwand sparen. ■ Datenbankabstraktion mithilfe der JSON-Abfrageextrahierung. ■ Parametrierte Webberichterstellung für Self-Service. ■ Berichtsplanung, Verteilung und Verlaufsversionierung. ■ Zugriff auf alle Datenquellen, einschließlich der UIM-Datenbank. Außerdem stellt UR Entwicklern und Power-Benutzern Folgendes bereit: ■ "iReport graphical report designer" für das Erstellen von komplexeren Berichten. ■ Druckfertige und pixelperfekte Produktionsberichterstellung. Dieses Dokument enthält Informationen zur grundlegenden Verwendung von UR und iReport. Zusätzliche UR-Dokumentation ist in der webbasierten Hilfe zu Unified Management Portal verfügbar. Dieses Kapitel enthält folgende Themen: So erhalten Sie Unified Reporter (siehe Seite 8) Benutzer und Berechtigungen (siehe Seite 8) Ordnerstruktur (siehe Seite 9) Kapitel 1: Einführung 7 So erhalten Sie Unified Reporter So erhalten Sie Unified Reporter Für die Verwendung von UR ist keine zusätzliche Lizenzierung erforderlich, doch UR wird nicht automatisch mit UMP installiert. Installieren Sie vor der Installation von UR UMP und holen Sie danach das geeignete UR-Paket für Ihre Umgebung von der Download-Seite unter support.nimsoft.com. Machen Sie sich vor der Installation von UR mit den Inhalten der Versionshinweise zu Unified Reporter und des Installationshandbuchs für Unified Reporter, die beide unter docs.nimsoft.com verfügbar sind, vertraut. Nachdem Sie UR installiert haben, können Sie über die Seite "Berichte" in UMP darauf zugreifen oder UR zu einer Seite Ihrer Wahl hinzufügen. Benutzer und Berechtigungen Um auf UR zugreifen zu können, müssen Benutzer über die ACL-Berechtigung Unified Reports verfügen. Es gibt zwei Typen von UR-Benutzern: Konto-Kontaktbenutzer und UIM-Benutzer. Konto-Kontaktbenutzer können nur den Ordner "Ö ffentlich > Nimsoft" sowie die Ordner, denen sie angehören, sehen. Standardmäßig haben Konto-Kontaktbenutzer schreibgeschützten Zugriff auf das Repository, außer, sie verfügen sie über die Berechtigung Portalverwaltung, mit der sie nur auf ihren eigenen Kontoordner vollen Zugriff haben. UIM-Benutzer mit der Berechtigung Portalverwaltung können die Ordner aller Konten sehen und haben vollem Zugriff auf das Repository. Hinzufügen von Benutzern zu UIM Benutzer von Unified Reporter (UR) müssen mit Infrastructure Manager zu UIM hinzugefügt werden. Die UR-Webanwendung (JasperReports Server Pro) bietet eine Möglichkeit zum Hinzufügen von Benutzern. Die Authentifizierung wird allerdings von UIM gehandhabt. Wenn Sie einen Benutzer in UR hinzufügen und danach versuchen, sich mit diesem Benutzernamen anzumelden, wird dies nicht funktionieren. Fügen Sie den Benutzer in UIM mit Infrastructure Manager hinzu, und melden Sie sich dann bei UR an. 8 Schnellstart-Handbuch Ordnerstruktur Ordnerstruktur Die mitgelieferten Unified Infrastructure Management-Berichte im Repository sind unter dem Ordner "Ö ffentlich > Nimsoft Monitor" zusammengefasst. Ordner für Konten werden automatisch erstellt, wenn sich Konto-Kontaktbenutzer zum ersten Mal anmelden. Wenn Sie ein Upgrade von einer UR-Version vor v6.5 durchführen, werden die mitgelieferten Berichte automatisch unter "Ö ffentlich > Nimsoft Monitor" platziert und vom früheren Speicherort in der Verzeichnisstruktur entfernt. Kapitel 1: Einführung 9 Kapitel 2: Mitgelieferte Berichte Dieser Abschnitt enthält Informationen zu den im Lieferumfang von UR enthaltenen Berichten. Dieses Kapitel enthält folgende Themen: Optionen für mitgelieferte Berichte (siehe Seite 11) Liste von mitgelieferten Berichten (siehe Seite 12) Optionen für mitgelieferte Berichte Wenn Sie einen mitgelieferten Bericht im Repository ausführen, wird der Bereich "Optionen" auf der linken Seite angezeigt. Im Bereich "Optionen" können Sie den Bericht anpassen, indem Sie in folgenden Feldern eine Auswahl treffen: Top Hier können Sie die Anzahl von Ergebnissen auf 5, 10 oder 25 festlegen. Die Standardeinstellung für diesen Wert ist 10. Zeitraum Hier können Sie letzte Stunde, letzter Tag, letzte Woche, letzten Monat oder letztes Jahr festlegen. Die Standardeinstellung für diesen Wert ist letzter Tag. Paginierung ignorieren Dieses Kontrollkästchen ermöglicht es Ihnen, einen Bericht vollständig auf einer Seite anzuzeigen, durch den nach unten gescrollt werden kann, anstatt ihn über mehrere Seiten aufzuteilen. Diese Option kann hilfreich sein, wenn Berichte einen grißen Datenumfang enthalten oder wenn Sie planen, den Bericht zu drucken. Standardmäßig ist die Paginierung aktiviert. Hinweis: Für Berichte aus Zeitreihendaten wie beispielsweise CO2-Emissionswert wird im Bereich "Optionen" nur das Feld "Zeitraum" angezeigt. Kapitel 2: Mitgelieferte Berichte 11 Liste von mitgelieferten Berichten Bearbeiten der standardmäßigen Wertliste UIM-Benutzer mit der ACL-Berechtigung Portalverwaltung können die Werte bearbeiten, die im Bereich "Optionen" in den Listen Top und Zeitraum angezeigt werden. Alle mitgelieferten Berichte übernehmen die Optionen aus den Listen "Top" und "Zeitraum". Wenn Sie die standardmäßige Wertliste bearbeiten, werden die Änderungen demnach für alle mitgelieferten Berichte angewendet. Gehen Sie wie folgt vor: 1. Blenden Sie in der Repository-Ansicht "Ö ffentlich > Nimsoft Monitor > Ressourcen > Listen" ein. 2. Wählen Sie "Zeitraum" oder "Top" aus, und klicken Sie in der Symbolleiste auf Bearbeiten. 3. Fügen Sie in der Drop-down-Liste im Bereich "Wertliste bearbeiten" Werte hinzu, oder entfernen Sie welche daraus. Hinweis: Die Werte, die Sie für "Zeitraum" angeben, müssen mit Ihrem Datenbankanbieter konsistent sein. Liste von mitgelieferten Berichten In der folgenden Tabelle sind die Berichte aufgelistet, die im Lieferumfang von UR enthalten sind. Sie enthält auch die Probes und QoS-Messungen, die im Probe aktiviert sein müssen, damit für den jeweiligen Bericht Daten abgerufen werden. Berichtskategori Berichtsname e QoS erforderlich Probe (Sensor) Anwendungen Active Directory Replication Age QOS_AD_REPLICATION_AGE ad_response Anwendungen End to End User Transactions QOS_E2E_EXECUTION e2e_appmon Anwendungen Remedy Response Time QOS_REMEDY_REPONSE remedy_response Anwendungen/A Apache Busy Workers pache QOS_APACHE_BUSYWORKERS apache Anwendungen/A Apache Bytes per Request pache QOS_APACHE_BYTESPERREQ apache Anwendungen/A Apache HTTP Response Time pache QOS_APACHE_HTTPRESTIME apache Anwendungen/A Apache Idle Workers pache QOS_APACHE_IDLEWORKERS apache Anwendungen/A Apache Requests Average Time pache QOS_APACHE_REQAVETIME apache 12 Schnellstart-Handbuch Liste von mitgelieferten Berichten Anwendungen/A Apache Requests Per Second pache QOS_APACHE_REQPERSEC Databases/MyS QL QOS_MYSQL_CONNECTION_USAGE_ mysql RATE MySQL % of Maximum Allowed Connections apache Databases/Oracl Oracle % Table Space Free e QOS_ORACLE_TABLESPACE_FREE oracle Databases/Oracl Oracle Databases by Size e QOS_ORACLE_DATABASE_SIZE oracle Databases/Oracl Oracle SGA Memory Free e QOS_ORACLE_SGA_MEMORY_FREE oracle Databases/Oracl Oracle Table Space Allocated Free QOS_ORACLE_TABLESPACE_ALLOC_F oracle e REE Databases/SQL Server SQL Server Free Allocated Space QOS_SQLSERVER_ALLOC_SPACE sql_server Databases/SQL Server SQL Server Response Time QOS_SQL_RESPONSE sql_response Databases/SQL Server SQL Server Transactions QOS_SQLSERVER_TRANSACTIONS sql_server Databases/SQL Server SQL Server Users QOS_SQLSERVER_ACTIVE_USERS sql_server Netzwerk DHCP Response Time QOS_DHCP_RESPONSE dhcp_response Netzwerk DNS Response Time QOS_DNS_RESPONSE dns_response Netzwerk Hosts by Response Time QOS_NET_CONNECT net_connect Netzwerk Interfaces by Bandwidth Inbound QOS_INTERFACE_TRAFFIC_PERC interface_traffic Netzwerk Interfaces by Bandwidth Outbound QOS_INTERFACE_TRAFFIC_PERC interface_traffic Netzwerk Interfaces by Discards QOS_INTERFACE_DISCARDS interface_traffic Netzwerk Interfaces by Errors QOS_INTERFACE_ERRORS interface_traffic Netzwerk Interfaces by Queue Length QOS_INTERFACE_QLEN interface_traffic Netzwerk LDAP Response Time QOS_LDAP_RESPONSE_TIME ldap_response Netzwerk NTP Response Time QOS_NTP_RESPONSE_TIME ntp_response Netzwerk URLs by Response Time QOS_URL_RESPONSE url_response QOS_MEMORY_USAGE cisco_monitor Network/Cisco Cisco by Memory Free (Netzwerk/Telek ommunikation) Kapitel 2: Mitgelieferte Berichte 13 Liste von mitgelieferten Berichten Network/Cisco Cisco by Memory Used (Netzwerk/Telek ommunikation) QOS_MEMORY_USAGE cisco_monitor Network/Cisco Cisco CallManager CPU Usage (Netzwerk/Telek ommunikation) QOS_CPU_USAGE ccm_monitor Network/Cisco Cisco CallManager Memory Used (Netzwerk/Telek (%) ommunikation) QOS_CCM_PERFORMANCE ccm_monitor Network/Cisco Cisco CPU Usage (Netzwerk/Telek ommunikation) QOS_CPU_USAGE cisco_monitor Network/Cisco Cisco QoS Drop Bitrate (Netzwerk/Telek ommunikation) QOS_CISCO_DROP_BITRATE cisco_qos Network/Cisco Cisco QoS Post Policy Bitrate (Netzwerk/Telek ommunikation) QOS_CISCO_POST_POLICY_BITRATE cisco_qos Network/Cisco Cisco QoS Post Policy Bytes (Netzwerk/Telek ommunikation) QOS_CISCO_POST_POLICY_BYTE cisco_qos Network/Cisco Cisco QoS Pre Policy Bitrate (Netzwerk/Telek ommunikation) QOS_CISCO_PRE_POLICY_BITRATE cisco_qos Server Servers By CPU Usage QOS_CPU_USAGE cdm (local) or rsp (remote) Server Servers by Disk Capacity QOS_DISK_USAGE_PERC cdm (local) or rsp (remote) Server Servers by Physical Memory QOS_MEMORY_PHYSICAL_PERC cdm (local) or rsp (remote) Server Servers by Processor Queue Length QOS_PROC_QUEUE_LEN Prozesse Servers/Process es Processes by CPU Usage QOS_PROCESS_CPU Prozesse Servers/Process es Processes by Memory Usage QOS_PROCESS_MEMORY Prozesse Servers/Process es Processes by Thread Count QOS_PROCESS_THREADS Prozesse ServiceDesk Accounts (UIM) by Events 14 Schnellstart-Handbuch nsdgtw Liste von mitgelieferten Berichten ServiceDesk Accounts (ServiceDesk) by Incidents nsdgtw ServiceDesk Applications by Events and Incidents nsdgtw ServiceDesk Devices by Mean Time to Repair vs Service Quality nsdgtw ServiceDesk Network Events and Incidents nsdgtw ServiceDesk Servers by Events and Incidents nsdgtw Virtualization/V Mware VMware Guests by CPU MHz QOS_CPU_USAGE_MHZ vmware Virtualization/V Mware VMware Guests by CPU Usage QOS_CPU_USAGE vmware Virtualization/V Mware VMware Hosts by CPU Usage QOS_CPU_USAGE vmware Virtualization/V Mware VMware Hosts by Disk Free QOS_DISK_FREE vmware Virtualization/V Mware VMware Hosts by Memory Usage QOS_MEMORY_PERC_USAGE vmware Virtualization/V Mware VMware Hosts by VM Count QOS_COUNTER vmware Kapitel 2: Mitgelieferte Berichte 15 Kapitel 3: Entwerfen von Ad-hoc-Ansichten In diesem Abschnitt wird beschrieben, wie Sie eine Ad-hoc-Ansicht in UR entwerfen. Nachdem Sie eine Ad-hoc-Ansicht erstellt haben, können Sie die Ad-hoc-Ansicht speichern und als Bericht öffnen. Hinweis: Um einen Bericht zu entwerfen, müssen Sie zusätzlich zur erforderlichen ACL-Berechtigung Unified Reporter über die ACL-Berechtigung Portalverwaltung verfügen. Gehen Sie wie folgt vor: 1. Melden Sie sich bei UMP an, und gehen Sie zu Unified Reporter. 2. Klicken Sie auf der angezeigten Seite auf Erstellen > Ad-hoc-Ansicht. Der Datenauswahl-Assistent wird geöffnet. 3. In der Datenauswahl: a. Wählen Sie oben in der Datenauswahl Themen aus. b. Blenden Sie den Ordner Ö ffentlich ein, und navigieren Sie zu Ad Hoc Components (Ad-hoc-Komponenten) > Themen > Nimsoft Monitor Topic (Nimsoft Monitor-Thema). c. Wählen Sie aus den Ansichtstypen unten in der Datenauswahl Tabelle, Diagramm oder Kreuztabelle aus. Das Dialogfeld "Eingabesteuerungen" wird geöffnet. Hinweis: Wenn das Dialogfeld "Eingabesteuerungen" nicht geöffnet wird, klicken Sie in der Symbolleiste des Ad-hoc-Editor auf das Symbol für Eingabesteuerungen. Kapitel 3: Entwerfen von Ad-hoc-Ansichten 17 Liste von mitgelieferten Berichten 4. Im Dialogfeld "Eingabesteuerungen": a. Geben Sie einen Zeitraum für die Ad-hoc-Ansicht an. b. Wählen Sie aus den Listen "QoS", "Quelle" und "Ziel" die gewünschten Eingabesteuerungselemente aus. c. Klicken Sie auf OK. 5. Ziehen Sie Felder und Messungen per Drag-and-drop oder doppelklicken Sie darauf, um Sie zur Ad-hoc-Ansicht hinzuzufügen. 6. Wenn Sie mit der Ad-hoc-Ansicht zufrieden sind, klicken Sie auf das Speichersymbol. a. Geben Sie einen Namen für den Bericht ein. b. Navigieren Sie zu einem Speicherort im Repository, und klicken Sie auf Speichern. Die Ad-hoc-Ansicht und der entsprechende Bericht werden nun im Repository angezeigt. Sie können den Bericht ausführen oder die Ad-hoc-Ansicht weiter bearbeiten. 18 Schnellstart-Handbuch Kapitel 4: Einrichten von iReport Nachdem Sie Unified Reporter (UR) installiert haben, befolgen Sie die Schritte in diesem Abschnitt, um iReport einzurichten. Sie können iReport auf einem beliebigen System mit Netzwerkzugriff auf das System, auf dem Sie UR installiert haben, installieren. Hinweis: Die iReport-Anwendung muss ordnungsgemäß konfiguriert sein, damit Sie Berichte, die eine Abfrageausführungssprache verwenden, ändern, kopieren und ausführen können. Sie können mitgelieferte Berichte in UR anzeigen. Zum Bearbeiten und Kopieren von mitgelieferten Berichten benötigen Sie jedoch iReport. Dieses Kapitel enthält folgende Themen: Einrichten von iReport (siehe Seite 19) Abfrage-Executer (siehe Seite 22) Installieren der kommerziellen iReport-Lizenz (siehe Seite 23) Einrichten von iReport Gehen Sie wie folgt vor: 1. Laden Sie die geeignete Version von iReport von der Download-Seite unter support.nimsoft.com herunter. 2. Installieren Sie iReport auf einem beliebigen System mit Netzwerkzugriff auf das System, auf dem Sie UR installiert haben. 3. Holen Sie Bibliotheken von der UR-Bereitstellung: 4. a. Geben Sie folgende URL in einen Browser ein: http://<UMP-Server>/jasperserver-pro/ireport-config.jar. b. Speichern Sie die JAR-Datei an einen Speicherort Ihrer Wahl. c. Starten Sie iReport. d. Fügen Sie die JAR-Datei zum Klassenpfad "iReport" hinzu: ■ Wählen Sie in der Menüleiste in iReport Tools > Options > Classpath aus. ■ Klicken Sie auf Add JAR, und navigieren Sie zum Speicherort, unter dem Sie die JAR-Datei gespeichert haben. Klicken Sie auf "Ö ffnen". Fügen Sie Abfrage-Executer hinzu: a. Wählen Sie in der Menüleiste in iReport Tools > Options > Query Executers aus. b. Fügen Sie Abfrage-Executer (siehe Seite 22) hinzu. Kapitel 4: Einrichten von iReport 19 Einrichten von iReport 5. Verbinden Sie iReport mit Ihrem UMP-Server: a. Klicken Sie in der Menüleiste in iReport auf Window > JasperReports Server Repository. Der Bereich "Repository Navigator" wird geöffnet. b. Klicken Sie auf das Symbol zum Hinzufügen eines neuen Servers, um eine Verbindung mit der UR-Instanz herzustellen. Das Dialogfeld des JasperServer-Plug-in wird geöffnet. 6. c. Geben Sie im Feld ID einen Namen für Ihren UMP-Server an. Geben Sie zum Beispiel Unified Reporter ein. d. Bearbeiten Sie im Feld JasperReports Server URL localhost:8080 so, dass er auf Ihren UMP-Server verweist. e. Geben Sie gültige Eingaben für UIM-Benutzernamen und -Kennwort ein. Legen Sie die Datenquelle fest: a. Klicken Sie auf das Symbol für die Berichtsdatenbank. Das Dialogfeld für Verbindungen / Datenquellen wird geöffnet. b. Wählen Sie New > Database JDBC connection aus. Klicken Sie auf "Weiter". Das Dialogfeld "Database JDBC connection " wird geöffnet. c. 20 Schnellstart-Handbuch Geben Sie einen Namen wie beispielsweise UIM für die Datenbank-JDBC-Verbindung an. Einrichten von iReport d. Klicken Sie auf das Drop-down-Menü im Feld JDBC Driver, und wählen Sie den geeigneten JBDC-Treiber für Ihre Datenbank aus. Das Feld "JDBC URL " wird aktualisiert und zeigt eine URL-Vorlage für den spezifischen JBDC-Treiber, den Sie ausgewählt haben, an. Wenn Sie beispielsweise MS SQLServer (2005) (com.microsoft.sqlserver.jdbc.SQLServerDriver) ausgewählt haben, wird im Feld "JDBC URL" "jdbc:sqlserver://localhost:1433;databaseName=DatabaseName" angezeigt. Hinweis: Verfügbare JBDC-Treiber werden in schwarzer Schrift angezeigt, nicht verfügbare in Rot. Wenn der geeignete JBDC-Treiber nicht verfügbar ist, stellen Sie sicher, dass Sie die JAR-Datei wie in Schritt 3 beschrieben zum Klassenpfad hinzugefügt haben. e. Geben Sie im Feld JDBC URL die IP-Adresse (oder den Hostnamen) des Datenbankservers und den Datenbanknamen ein. Wenn Sie beispielsweise MS SQLServer (2005) (com.microsoft.sqlserver.jdbc.SQLServerDriver) ausgewählt haben, geben Sie jdbc:sqlserver://<IP-Adresse>:1433;databaseName=<CA_UIM> ein. Hinweis: In den meisten Fällen werden für die JDBC-Verbindung dieselben Informationen wie für die Datenbankkonfiguration für data_engine verwendet. f. Geben Sie einen Benutzernamen und ein Kennwort ein. Kapitel 4: Einrichten von iReport 21 Abfrage-Executer g. Klicken Sie auf die Schaltfläche Test. Wenn die Verbindung erfolgreich hergestellt wurde, klicken Sie auf Save. Wenn die Verbindung nicht erfolgreich hergestellt wurde, überprüfen Sie folgende Elemente: ■ Sie haben einen geeigneten JBDC-Treiber für Ihre Datenbank ausgewählt. ■ Sie haben gültige Informationen für die JDBC-URL und gültige Anmeldeinformationen eingegeben. ■ Das System, auf dem Sie iReport installiert haben, verfügt über Netzwerkzugriff auf die Datenbank. iReport ist nun installiert und kann verwendet werden, um Berichte zu ändern, zu kopieren oder auszuführen. Abfrage-Executer In der folgenden Tabelle sind die Abfrage-Executer aufgeführt, die Sie in iReport hinzufügen können. Sprache Abfrage-Executer-Factory Feldanbieterklasse NimsoftJSONTopN com.nimsoft.ur.jrs.executer.NimsoftJSONTop com.nimsoft.ur.ireport.fieldsprovider.Nims NFactory oftJSONTopNFP NimsoftJSONTimeSe com.nimsoft.ur.jrs.executer.NimsoftJSONTim com.nimsoft.ur.ireport.fieldsprovider.Nims ries eSeriesFactory oftJSONTimeSeriesFP nimsoft com.nimsoft.ur.jrs.executer.NimsoftFactory com.nimsoft.ur.ireport.fieldsprovider.Nims oftFP ServiceDesk com.nimsoft.ur.jrs.executer.ServiceDeskFact ory com.nimsoft.ur.ireport.fieldsprovider.Servic eDeskFP ServiceDeskNMS com.nimsoft.ur.jrs.executer.ServiceDeskNMS com.nimsoft.ur.ireport.fieldsprovider.Servic Factory eDeskNMSFP NMS com.nimsoft.ur.jrs.executer.NMSFactory 22 Schnellstart-Handbuch com.nimsoft.ur.ireport.fieldsprovider.NMSF P Installieren der kommerziellen iReport-Lizenz Installieren der kommerziellen iReport-Lizenz iReport verwendet anfänglich eine Testlizenz, die nach der Installation 30 Tage lang die Funktionalitäten einer kommerziellen Lizenz bietet. iReport kann nach Ablauf der Testlizenz weiterhin verwendet werden, bestimmte Funktionen sind jedoch nicht mehr verfügbar. Sie können die kommerzielle Lizenz installieren, die mit den UR-Installationsdateien mitgeliefert wird, um weiterhin die vollständige Funktionalität von iReport zu verwenden. Gehen Sie wie folgt vor: 1. Ö ffnen Sie iReport. 2. Wählen Sie in der Symbolleiste Help > License Manager aus. Klicken Sie auf Install License, und durchsuchen Sie das System nach der Lizenzdatei in nimsoft\probes\service\wasp\conf\jasperserver.license. Kapitel 4: Einrichten von iReport 23 Kapitel 5: Verwenden von benutzerdefinierten Abfragesprachen Die mit UR installierten mitgelieferten Berichte verwenden die benutzerdefinierten Abfragesprachen NimsoftJSONTopN und NimsoftJSONTimeSeries, die in der Web-App von Unified Reporter installiert werden. Dieser Abschnitt enthält Informationen zur Verwendung der Abfragesprachen NimsoftJSONTopN und NimsoftJSONTimeSeries. Hinweis: Die iReport-Anwendung muss ordnungsgemäß konfiguriert sein, damit Sie Berichte mithilfe einer benutzerdefinierten Nimsoft-Abfragesprache ändern, kopieren und ausführen können. Beachten Sie den Abschnitt Einrichten von iReport (siehe Seite 19). Dieses Kapitel enthält folgende Themen: NimsoftJSONTopN-Abfragesprache (siehe Seite 25) NimsoftJSONTimeSeries-Abfragesprache (siehe Seite 27) NimsoftJSONTopN-Abfragesprache Dieser Abschnitt enthält Informationen zur Verwendung der Abfragesprache NimsoftJSONTopN. Die NimsoftJSONTopN-Sprache erwartet ein JSON-Objekt in Form einer Zeichenfolge. Außerdem: ■ Das JSON-Objekt muss ein topNReportDefinition-Objekt enthalten. ■ Das topNReportDefinition-Objekt muss den QoS-Schlüssel enthalten. Bei dessen Wert handelt es sich um eine Zeichenfolge der QoS-Kennzahl für den gewünschten Bericht. Zum Beispiel gibt die folgende Syntax für jede Quelle, die diese Daten erfasst, einen Bericht zum Durchschnittswert von QOS_MEMORY_PHYSICAL_PERC für die letzten 24 Stunden zurück. NimsoftJSONTopN-Beispiel 1 {"topNReportDefinition": { "qos":"QOS_MEMORY_PHYSICAL_PERC" } } Kapitel 5: Verwenden von benutzerdefinierten Abfragesprachen 25 NimsoftJSONTopN-Abfragesprache Im nächsten Beispiel gibt die Syntax die Top 5-, Durchschnitts-, Mindest- und Höchstwerte für QOS_PROCESS_CPU auf dem Rechner cadev.dev.fco für die letzten 30 Minuten zurück. NimsoftJSONTopN-Beispiel 2 {"topNReportDefinition": { "numberOfBars":5, "statistics":["avg", "max", "min"], "qos":"QOS_PROCESS_CPU", "source":"cadev.dev.fco", "period":30, "periodUnits":"minute", "groupFirstBy": "target" } } In der Tabelle unten finden Sie zusätzliche Werte, die Sie optional im topNReportDefinition-Objekt angeben können, um weitere Berichtsdetails zu definieren. Schlüssel Description Wertdatentyp Standardwert statistics Definiert die Statistik, die für den Bericht zu erfasst werden soll. Optionen: avg, min, max JSONArray "statistics":["avg"] numberOfBars Schränkt den Bericht auf eine Ganzzahl Höchstanzahl von Ergebnissen ein "numberOfBars":10 Quelle Schränkt den Bericht auf eine bestimmte Quelle ein Beliebige Quelle target Schränkt den Bericht auf ein Zeichenfolge bestimmtes Ziel ein. Es kann auch ein spezielles Token "{source}" verwendet werden, um target=source darzustellen. Beliebiges Ziel period Schränkt den Bericht auf eine bestimmte Intervalllänge ein "period":24 periodUnits Definiert die Einheiten für den Zeichenfolge Zeitraum. Optionen: minute, hour, day, month "periodUnits":"hour" groupFirstBy Quelle oder Ziel "groupFirstBy":"source" 26 Schnellstart-Handbuch Zeichenfolge Long Zeichenfolge NimsoftJSONTimeSeries-Abfragesprache NimsoftJSONTimeSeries-Abfragesprache Dieser Abschnitt enthält Informationen zur Verwendung der Abfragesprache NimsoftJSONTimeSeries. Die NimsoftJSONTimeSeries-Sprache erwartet ein JSON-Objekt in Form einer Zeichenfolge. Außerdem: ■ Das JSON-Objekt muss ein timeSeriesReportDefinition-Objekt enthalten. ■ Das timeSeriesReportDefinition-Objekt muss den Qos-Schlüssel enthalten. Bei dessen Wert handelt es sich um eine Zeichenfolge der QoS-Kennzahl für den gewünschten Bericht. Zum Beispiel gibt die folgende Syntax für jede Quelle, die diese Daten erfasst, einen Bericht zum Durchschnittswert von QOS_MEMORY_PHYSICAL_PERC für die letzten 24 Stunden zurück. NimsoftJSONTimeSeries-Beispiel 1 {"timeSeriesReportDefinition": { "qos":"QOS_MEMORY_PHYSICAL_PERC" } } In der Tabelle unten finden Sie zusätzliche Werte, die Sie optional im timeSeriesReportDefinition-Objekt angeben können, um weitere Berichtsdetails zu definieren. Schlüssel Description Wertdatentyp Standardwert Quelle Schränkt den Bericht auf eine bestimmte Quelle ein Zeichenfolge Beliebige Quelle target Schränkt den Bericht auf ein bestimmtes Ziel ein. Es kann auch ein spezielles Token "{source}" verwendet werden, um target=source darzustellen. Zeichenfolge Beliebiges Ziel period Schränkt den Bericht auf Long eine bestimmte Intervalllänge ein "period":24 Kapitel 5: Verwenden von benutzerdefinierten Abfragesprachen 27 NimsoftJSONTimeSeries-Abfragesprache periodUnits Definiert die Einheiten Zeichenfolge für den Zeitraum. ["minute", "hour", "day", "month"] "periodUnits":"hour" measurementScale Skaliert die von diesem Wert zurückgegebenen Messwerte Doppelt "measurementScale":1 measurementOffset Versetzt die von diesem Wert zurückgegebenen Messwerte Doppelt "measurementOffset":0 percentileLine Gibt eine zum Zeitpunkt der Berichtsausführung berechnete horizontale Perzentilzeile an [true, false] Boolean "percentileLine":false percentileValue Der Wert für die Perzentilzeile [0-100] Doppelt "percentileValue":95.0 28 Schnellstart-Handbuch
