Probe-Handbuch für Überwachung von JDBC
Werbung
CA Nimsoft Monitor Probe-Handbuch für Überwachung von JDBC-Antworten jdbc_response v1.1 Serie 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: Übersicht 7 Informationen zu diesem Handbuch ............................................................................................................................ 7 Verknüpfte Dokumentation ......................................................................................................................................... 7 Voraussetzungen vor der Konfiguration ...................................................................................................................... 8 Unterstützte Plattformen ...................................................................................................................................... 8 Kapitel 2: Konfigurationsdetails 9 Knoten jdbc_response .................................................................................................................................................. 9 Knoten "Verbindung-<Verbindungsname>" ......................................................................................................... 9 Konfigurieren von Knoten .......................................................................................................................................... 14 So konfigurieren Sie Alarmschwellenwerte: .............................................................................................................. 14 Hinzufügen einer neuen Verbindung ......................................................................................................................... 14 Hinzufügen einer neuen Abfrage ............................................................................................................................... 15 Löschen von Verbindungen ........................................................................................................................................ 15 Abfrage löschen .......................................................................................................................................................... 15 Kapitel 3: Kennzahlen für QoS-Grenzwerte 17 QoS-Kennzahlen für jdbc_response ........................................................................................................................... 17 Standardeinstellungen der Kennzahlen für jdbc_response-Alerts ............................................................................. 17 Inhalt 5 Änderungen in der Dokumentation Diese Tabelle enthält den Versionsverlauf für dieses Dokument. Version Datum Was ist neu? 1.1 Dezember 2013 Dokumentation zur ersten webbasierten GUI-Version des Ü berwachung von JDBC-Antworten-Probe. (Vorgängerversionen dieses Probe werden über den Infrastrukturmanager konfiguriert). 6 Probe-Handbuch für Überwachung von JDBC-Antworten Kapitel 1: Übersicht Das Ü berwachung von JDBC-Antworten-Probe gibt benutzerdefinierte SQL-Abfragen über die JDBC-Client-Schnittstelle an den Datenbankserver aus. Das Probe misst die Antwortzeit der JDBC-Verbindung und die Zeit, die für das Erfassen von Daten erforderlich ist. Dieses Kapitel enthält folgende Themen: Informationen zu diesem Handbuch (siehe Seite 7) Verknüpfte Dokumentation (siehe Seite 7) Voraussetzungen vor der Konfiguration (siehe Seite 8) Informationen zu diesem Handbuch Dieses Handbuch richtet sich an CA Nimsoft Monitor-Administratoren. Es beschreibt die Konfiguration des Probe für Ü berwachung von JDBC-Antworten und enthält folgende Informationen: ■ Ü bersicht über die Dokumentation zum Probe für Ü berwachung von JDBC-Antworten für frühere Versionen des Probe. ■ Details zur Konfiguration des Probe. ■ Informationen zu Feldern und häufige Vorgänge für das Konfigurieren des Probe. Wichtig! Das Dokument enthält keine Beschreibungen für intuitive Felder der Benutzeroberfläche. Verknüpfte Dokumentation Beachten Sie das folgende Material mit möglicherweise relevanten Informationen: Verknüpfte Dokumentation Dokumentation für andere Versionen des jdbc_response-Probe Die Versionshinweise für das jdbc_response-Probe Benutzerdokumentation für die Admin-Konsole Referenzinformationen zu Ü berwachungskennzahlen für CA Nimsoft-Probes (http://docs.nimsoft.com/prodhelp/en_US/Probes/ProbeReference/index.htm) Kapitel 1: Übersicht 7 Voraussetzungen vor der Konfiguration Voraussetzungen vor der Konfiguration Das Ü berwachung von JDBC-Antworten-Probe benötigt den JBDC-Treiber, um eine Verbindung zum DBMS herzustellen. Standardmäßig enthält das Probe die JBDC-Treiber (JAR-Dateien) für Microsoft SQL Server- und Oracle-Datenbanken. Sie können die entsprechenden JAR-Dateien des JBDC-Treibers in das Probe-Installationsverzeichnis einfügen, um MySQL-DBMS zu unterstützen. Der Standardspeicherort der JAR-Datei des JBDC-Treibers ist der Ordner "\Nimsoft\probes\database\jdbc_response\jar" im Installationsverzeichnis. Unterstützte Plattformen Aktuelle Informationen zu unterstützten Plattformen finden Sie in der Nimsoft-Matrix für Kompatibilitätsunterstützung. Informationen zum Probe für Ü berwachung von JDBC-Antworten finden Sie auch in der Support-Matrix für Nimsoft-Probes. 8 Probe-Handbuch für Überwachung von JDBC-Antworten Kapitel 2: Konfigurationsdetails Das Ü berwachung von JDBC-Antworten-Probe wird konfiguriert, um die Antwortzeit der JDBC-Datenbankverbindung zu überwachen. Das Ü berwachung von JDBC-Antworten-Probe ermöglicht es Ihnen, eine Verbindung zur Datenbank einzurichten. Sie können ein Profil konfigurieren, um SQL-Abfragen auf der Datenbank zu definieren, um beispielsweise Zeilenanzahl und Werte zu messen. Dieses Kapitel enthält folgende Themen: Knoten jdbc_response (siehe Seite 9) Konfigurieren von Knoten (siehe Seite 14) So konfigurieren Sie Alarmschwellenwerte: (siehe Seite 14) Hinzufügen einer neuen Verbindung (siehe Seite 14) Hinzufügen einer neuen Abfrage (siehe Seite 15) Löschen von Verbindungen (siehe Seite 15) Abfrage löschen (siehe Seite 15) Knoten jdbc_response In diesem Knoten können Sie Probe-Informationen anzeigen und die Protokolleigenschaften des Probe für Ü berwachung von JDBC-Antworten konfigurieren. Navigation: jdbc_response Legen Sie die folgenden Werte bedarfsgerecht fest bzw. ändern Sie sie: jdbc_response > Probe-Informationen Dieser Abschnitt enthält Informationen zu Namen, Version, Startzeit und Anbieter des Probe. jdbc_response > Allgemeine Konfiguration In diesem Abschnitt können Sie die Protokolleigenschaften des Ü berwachung von JDBC-Antworten-Probe konfigurieren. ■ Protokolldatei: Definiert die Datei, die die Probe-Informationen speichert. ■ Protokollebene: Gibt die Detailebene der Probe-Informationen an. Standard: 3-Info Knoten "Verbindung-<Verbindungsname>" Dieser Knoten ermöglicht es Ihnen, eine neue Verbindung mit der Datenbank einzurichten und die Attribute der Datenbankverbindungsdefinition zu konfigurieren. Kapitel 2: Konfigurationsdetails 9 Knoten jdbc_response Hinweis: Dieser Knoten kann vom Benutzer konfiguriert werden und wird in diesem Dokument als Verbindung-Verbindungsname bezeichnet. Navigation: jdbc_response > Verbindung-Verbindungsname Legen Sie die folgenden Werte bedarfsgerecht fest bzw. ändern Sie sie: Verbindung-Verbindungsname > Verbindungseinrichtung In diesem Abschnitt können Sie die Attribute der Datenbankverbindungsdefinition aktualisieren. Hinweis: Die Felder dieses Abschnitts sind mit den Feldern im Abschnitt "Informationen zur Verbindungseinrichtung" des Knotens "Verbindungsname" identisch. Knoten <Verbindungsname>" Dieser Knoten ermöglicht es Ihnen, eine Verbindung zu testen, die mit der Datenbank eingerichtet wird. Sie können auch Alarmeigenschaften konfigurieren, wenn ein Verbindungsfehler auftritt oder wenn eine Verbindung eingerichtet wird. Hinweis: Dieser Knoten kann vom Benutzer konfiguriert werden und wird in diesem Dokument als Verbindungsname bezeichnet. Navigation: jdbc_response > Verbindung-Verbindungsname > Verbindungsname 10 Probe-Handbuch für Überwachung von JDBC-Antworten Knoten jdbc_response Legen Sie die folgenden Werte bedarfsgerecht fest bzw. ändern Sie sie: Verbindungsname > Informationen zur Verbindungseinrichtung In diesem Abschnitt können Sie Eigenschaften für das Erstellen einer JDBC-Verbindung zur Datenbank anzeigen und konfigurieren. Sie können auch Informationen zum Typ der Datenbankautorisierung angeben. ■ ■ Datenbank-URL: Definiert die JDBC-URL, die für die Herstellung der Verbindung zur Datenbank erforderlich ist. Einige Beispiele sind: ■ MS SQL Server: jdbc:sqlserver://HOSTNAME:Port Number; DatabaseName=DATABASE ■ Oracle: jdbc:oracle:thin:@HOSTNAME:Port Number:DATABASE ■ MySQL: jdbc:mysql://HOSTNAME:Port Number/mysql Treibername: Definiert den Java-Klassennamen des JBDC-Treibers. Standard: com.microsoft.sqlserver.jdbc.SQLServerDriver Hinweis: Der standardmäßige Treibername wird für MS SQL verwendet. Aktualisieren Sie ihn für Oracle und MySQL. ■ Treiberpfad: Definiert den absoluten Pfad des JBDC-Treibers im Dateisystem. Hinweis: Die Treiber für MS SQL und Oracle werden automatisch installiert. Daher können Sie dieses Feld für MS SQL und Oracle leer lassen. Geben Sie den absoluten Ordnerpfad der JAR-Datei des JBDC-Treibers für die Unterstützung von MySQL an. ■ Benutzer-ID: Definiert den Benutzernamen, der erforderlich ist, um auf die JDBC-Verbindung zuzugreifen und die Abfrage auszuführen. ■ Kennwort: Definiert das Kennwort für den Anwendernamen. ■ Zeitüberschreitung (Wert): Definiert das Zeitlimit, das für einen Verbindungsversuch festgelegt ist. Standard: 30 ■ Zeitüberschreitung (Einheit): Definiert die Einheit für das Messen des Wertes der Zeitüberschreitung. Standard: Sek. Verbindungsname > Verbindungsfehler In diesem Abschnitt können Sie die Alarmeigenschaften anzeigen und konfigurieren, wenn die Verbindung zur Datenbank fehlschlägt. Verbindungsname > Verbindungsherstellung In diesem Abschnitt können Sie die Alarmeigenschaften anzeigen und konfigurieren, wenn die Verbindung zur Datenbank hergestellt ist. Kapitel 2: Konfigurationsdetails 11 Knoten jdbc_response Knoten "<Abfragename>" Der Knote "Abfragename" wird für jede Abfrage angezeigt, die Sie auf dem Knoten "Verbindungsname" der übergeordneten Datenbank ausführen und überwachen möchten. Sie können die Antwortzeit, die Anzahl der Zeilen und den Rückgabewert der Abfrage überwachen. Hinweis: Dieser Knoten kann vom Benutzer konfiguriert werden und wird in diesem Dokument als Abfragename bezeichnet. Navigation: jdbc_response > Verbindung-Verbindungsname > Verbindungsname > Abfragename 12 Probe-Handbuch für Überwachung von JDBC-Antworten Knoten jdbc_response Legen Sie die folgenden Werte bedarfsgerecht fest bzw. ändern Sie sie: Abfragename > Allgemein In diesem Abschnitt können Sie die SQL-Abfrage und die entsprechenden Zeitüberschreitungseigenschaften definieren. ■ Alarmquelle: Definiert den Hostnamen oder die IP-Adresse des Systems, das den Alarm generiert. ■ Ausführungsintervall (Wert): Gibt das Zeitintervall zwischen den Ausführungen der Abfrage an. ■ Einfache Abfrage: Definiert den Test der SQL-Abfrage. Verwenden Sie die Option "Testen" für die Validierung der Abfrageausführung. ■ Abfrage-Zeitüberschreitung (Wert): Gibt die Zeit an, die verstreichen muss, bevor der SQL-Abfrage-Zeitüberschreitungsalarm generiert wird. ■ Zeitüberschreitungsfehler: Gibt den Schweregrad des SQL-Abfrage-Zeitüberschreitungsalarms an. Abfragename > Abfrageantwortzeit In diesem Abschnitt können Sie die Eigenschaften für die Ü berwachung der Antwortzeit der Abfrage konfigurieren. Sie können "Hoher Schwellenwert", "Niedriger Schwellenwert" konfigurieren und Alarmnachrichten löschen. Ü blicherweise generiert der niedrige Schwellenwert Warnungsalarme und der hohe Schwellenwert Fehleralarme. Abfragename > Zeilenanzahl In diesem Abschnitt können Sie die Eigenschaften für die Ü berwachung der Zeilenanzahl konfigurieren, die von der SQL-Abfrage zurückgegeben werden. Sie können "Hoher Schwellenwert", "Niedriger Schwellenwert" konfigurieren und Alarmnachrichten löschen. Ü blicherweise generiert der niedrige Schwellenwert Warnungsalarme und der hohe Schwellenwert Fehleralarme. Abfragename > Wert In diesem Abschnitt können Sie die Eigenschaften konfigurieren, um die Werte in einer bestimmten Spalte der Zeilen, die von der SQL-Abfrage zurückgegeben werden, zu überwachen. Sie können "Hoher Schwellenwert", "Niedriger Schwellenwert" konfigurieren und Alarmnachrichten löschen. Ü blicherweise generiert der niedrige Schwellenwert Warnungsalarme und der hohe Schwellenwert Fehleralarme. ■ Vergleich: Gibt den Vergleichstyp an, um die zurückgegebenen Werte zu validieren. Der Vergleichstyp kann aus Nummern, Zeichen oder einem regulären Ausdruck bestehen. ■ Spalte: Gibt die Spalte der Zeilen an, die die SQL-Abfrage zurückgibt. ■ Operator: Gibt den Vergleichsoperator an, der verwendet wird, um die Anzahl der gegen den Schwellenwert zurückgegebenen Zeilen zu validieren. Kapitel 2: Konfigurationsdetails 13 Konfigurieren von Knoten Konfigurieren von Knoten Dieser Knoten enthält die Informationen zum Konfigurieren eines Abschnitts innerhalb eines Knotens. Sie können die Eigenschaften des Ü berwachung von JDBC-Antworten- Probe in jedem Abschnitt innerhalb des Knoten konfigurieren. So konfigurieren Sie Alarmschwellenwerte: Mit einigen QoS-Messprobes können Sie verschiedene Arten von Alarmschwellenwerten festlegen.. Diese Schwellenwertoptionen ermöglichen Ihnen eine breitere Steuerung, wenn Alarmnachrichten an das jeweilige QoS-Probe gesendet werden. Weitere Informationen zu den verschiedenen Alarmschwellenwerten und deren Konfigurationsvoraussetzungen finden Sie im Bereich Allgemeine Probe-Konfiguration der Admin-Konsolen-Hilfe. Wichtig! Alarm-Schwellenwerteinstellungen sind abhängig von der baseline_engine-Probe. Wenn Sie nicht die richtige baseline_engine-Version konfiguriert haben lassen, werden Sie die zusätzlichen Schwellenwertoptionen nicht sehen. Hinzufügen einer neuen Verbindung Sie können eine Datenbankverbindung hinzufügen, die als untergeordneter Knoten unter dem jdbc_response-Knoten angezeigt wird. Führen Sie diese Schritte aus: 1. Klicken Sie auf das Optionssymbol neben dem Knoten jdbc_response. 2. Klicken Sie auf "Neue Verbindung hinzufügen". 3. Geben Sie Details der Datenbankverbindung im Dialogfeld "Neue Verbindung hinzufügen" an, und klicken Sie auf "Senden". Im Abschnitt "Informationen zur Verbindungseinrichtung" des Knotens "Verbindungsname" finden Sie Feldbeschreibungen. Die Verbindungsdetails werden gespeichert, und Sie können die SQL-Abfragen für die Ü berwachung definieren. 14 Probe-Handbuch für Überwachung von JDBC-Antworten Hinzufügen einer neuen Abfrage Hinzufügen einer neuen Abfrage Sie können ein Ü berwachungsprofil hinzufügen, die als untergeordneter Knoten unter dem Knoten "Verbindungsname" angezeigt wird. Führen Sie diese Schritte aus: 1. Klicken Sie auf das Optionssymbol neben dem Knoten "Verbindungsname". 2. Klicken Sie auf die Option Neue Abfrage hinzufügen. 3. Aktualisieren Sie die Feldinformationen, und klicken Sie auf Senden. Das Profil ist gespeichert, und Sie können die Antwortzeitkriterien für das Ü berwachung von JDBC-Antworten-Probe konfigurieren. Löschen von Verbindungen Wenn das Probe die Datenbankantwortzeit nicht mehr überwachen soll, dann können Sie die Verbindung löschen. Führen Sie folgende Schritte aus: 1. Klicken Sie auf das Optionssymbol neben dem Knoten "Verbindungsname". 2. Klicken Sie auf Löschen. Die Verbindung wird gelöscht. Abfrage löschen Wenn Sie nicht möchten, dass das Profil die SQL-Abfrage ausführt, dann können Sie das Abfrageprofil löschen. Führen Sie folgende Schritte aus: 1. Klicken Sie auf das Optionssymbol neben dem Knoten "Abfragename". 2. Klicken Sie auf Abfrage löschen. 3. Klicken Sie auf Speichern. Das Abfrageprofil wird gelöscht. Kapitel 2: Konfigurationsdetails 15 Kapitel 3: Kennzahlen für QoS-Grenzwerte CA Nimsoft Monitor-Probes werden mit standardmäßigen QoS-Grenzwerten geliefert. Die standardmäßigen Grenzwerte geben Anhaltspunkte für die Art von Werten, die in die Kennzahlenfelder eingegeben werden können. In diesem Abschnitt werden die QoS-Kennzahlen und die standardmäßigen QoS-Grenzwerte beschrieben, um Sie bei der Feinabstimmung von Grenzwerten zu unterstützen und obsolete Alarme zu reduzieren. Dieses Kapitel enthält folgende Themen: QoS-Kennzahlen für jdbc_response (siehe Seite 17) Standardeinstellungen der Kennzahlen für jdbc_response-Alerts (siehe Seite 17) QoS-Kennzahlen für jdbc_response In der folgenden Tabelle werden die Kennzahlen für Prüfpunkte beschrieben, die mit dem Probe für Ü berwachung von JDBC-Antworten konfiguriert werden können. Monitorname Units Beschreibung QOS_JDBC_RESPONSE Millisekunden JDBC-Abfrageantwort QOS_JDBC_ROWS Zeilen JDBC-Abfragezeilen QOS_JDBC_VALUE Wert JDBC-Abfragewert Standardeinstellungen der Kennzahlen für jdbc_response-Alerts Dieser Abschnitt enthält die Standardeinstellungen der Kennzahlen für das jdbc_response-Probe. Warnungs QoS – Metrik grenzwert Antwortzeit NV Schweregr Schweregrad Fehlergrenz ad des der Warnung wert Fehlers Beschreibung Warning (Warnung) NV Ü berwacht den Alarmwert, der gesendet wird, wenn die Antwortzeit des Profils Schwerwie die Einstellung "Wert" in Millisekunden gend überschreitet Kapitel 3: Kennzahlen für QoS-Grenzwerte 17 Standardeinstellungen der Kennzahlen für jdbc_response-Alerts Warnungs QoS – Metrik grenzwert Antwortzeit Zeilenanzahl Wert NV Schweregr Schweregrad Fehlergrenz ad des der Warnung wert Fehlers Beschreibung Warning (Warnung) NV Warning (Warnung) NV Warning (Warnung) NV Ü berwacht den Alarmwert, der gesendet wird, wenn die Antwortzeit des Profils Schwerwie die Einstellung "Wert" in Millisekunden gend überschreitet NV Ü berwacht den Alarmwert, der gesendet wird, wenn die Zeilenanzahl des Profils Schwerwie die Einstellungen "Bedingung" und gend "Wert" überschreitet NV Ü berwacht den Alarmwert, der gesendet Schwerwie wird, wenn der Wert den Schwellenwert gend überschreitet 18 Probe-Handbuch für Überwachung von JDBC-Antworten
