Grafiken

Die in dem Tool vorhandenen grafischen Skripte erzeugen grafische Reports für die Daten von Statspack und von AWR (Automatic Workload Repository).

Um das AWR nützen zu dürfen braucht man eine Lizenz für das Diagnostic Pack. Sogar die Abfragen der Tabellen und der Views von AWR sind lizenzpflichtig. Man nützt die im Tool vorhandenen Skripte für AWR auf Eigenverantwortung.

Alle grafischen Skripte unterteilen sich in den folgenden 2 Kategorien:

- grundlegende (basic) Skripte,
- vorgezogene (advanced) Skripte.

Zu den grundlegenden gehören Skripte, die SQL-Zugriffe auf die jeweiligen Datenbank-Tabellen oder Views enthalten. Diese SQL-Zugriffe lassen sich parametrisieren, sodass man eingeben kann, welche Statistiken und für welchen Zeitraum zu ermitteln sind. In solchen Skripten kann man auch flexibel das grafische Layout konfigurieren: Titel, Unterschriften, Bildbereiche usw. Diese Flexibilität hat aber auch einen gewissen Nachteil: bei jedem Aufruf muss man ziemlich viel parametrisieren (z.B. die Namen von Statistiken, grafische Parameter ). Aus diesem Grund wurden vorgezogene grafische Skripte eingeführt.

Diese Skripte basieren auf den grundlegenden grafischen Skripten, und einige Eingabe-Parameter sind da vordefiniert. Das ermöglicht zu einem eine Spezialisierung der Skripte und zu anderem erleichtert die Aufrufe.

Die grundlegenden Skripte sind nach bestimmten Regeln programmiert und gehören zur Basis dieses Tools. Es ist nicht vorgesehen, dass ein Benutzer des Tools selbst weitere grundlegende grafische Skripte entwickelt. Im Gegenteil zu den grundlegenden lassen sich die vorgezogenen Skripte selbst programmieren. Die im Tool bestehenden vorgezogenen Skripte kann man dabei als Muster nehmen. Es ist geplant, diesen Prozess in kommenden Versionen zu automatisieren.

Falls vorhandene vorgezogene grafische Skripte nicht alle Ihrer Wünsche decken, so können Sie entsprechende grundlegende Skripte benutzen. Jedes grundlegende Skript stellt grafisch einen einzigen Datenbankstatistiktyp dar. Das Tool bietet Möglichkeit, 2 Datenbankstatistiktypen auf einer Grafik dynamisch darzustellen, indem man 2 grundlegende Skripte zusammenführt (s. Menü-Punkte "Merge SP Graphics" und "Merge AWR Graphics").

Jedes Skript (grundlegendes oder vorgezogenes) kann höchstens 7 Statistiken grafisch darstellen.

Herunter folgt eine Zusammenfassung von Eingabeparametern der grafischen Skripten:

begin_time - der Anfang des Zeitintervalls in Form von "dd.mm.yyyy hh24:mi:ss". Der Default-Wert ist SYSDATE -1,

end_time - das Ende des Zeitintervalls in Form von "dd.mm.yyyy hh24:mi:ss". Der Default-Wert ist SYSDATE,

group - Verdichtung (Gruppierung) der Daten (S - per Snap_Id, H - stündlich, D - täglich). Bei "S" werden die Daten nicht verdichtet, bei "H" werden die Daten zu voller Stunde umgerechnet. Bei "D" werden die Daten auf Tagesbasis verdichtet (das ermöglicht die Tendenzen über mehrere Tage zu erkennen). Der Default-Wert ist "S",

gr_title - Titel der Grafik,

gr_abs_or_rel_<stat_type> - definiert, ob die Datenbankstatistik absolut oder relativ auf der Grafik dargestellt wird. Der Typ der Statistik <stat_type> wird in dem jeweiligen grundlegenden Skript hart codiert (z.B. wait_event für Wait Events). Dieser Parameter kann die Werte "ABS" (für absolut) und "REL" (für relativ) annehmen. Der Default-Wert ist "REL",

gr_y_or_y2_<stat_type> - definiert, welche Achse (linke oder rechte) als Y-Achse benutzt wird. Falls man "Y" eingibt, so wird die linke benutzt, bei "Y2" wird die rechte benutzt. Der Default-Wert ist "Y",

gr_yrange_<stat_type> - definiert vertikale Größe der Grafik. Dieser Parameter wird als "<number1>:<number2> eingegeben, wobei number1 - die untere Ordinate und number2 - die obere Ordinate ist. Dieser Parameter erleichtert den Vergleich mit einer schon bestehenden Grafik. Man kann eine neue Grafik in der selben Größe wie die alte ausgeben lassen. Per Default wird vertikale Größe automatisch berechnet,

gr_top_<stat_type> - Anzahl der Top-Statistiken. Diese Anzahl soll 7 nicht überschreiten. Der Default-Wert ist 0,

gr_stat_name_<N> - Statistikname (der Default-Wert ist NULL). N = 1, 2, 3, 4, 5, 6, 7.

Als Ergebnis eines grafischen Skriptes bekommt man eine Datei in der folgenden Form (als Beispiel):

-------------------------------------------------------------------------------------------------------
-- Oracle Server Version : 9.2.0.1.0
-- Script sp_wait_events_bgraph9i.sql (Product TuTool 4.2.8 : www.tutool.de)
-- Start Time : 08.01.07 17:17:03
-- Input Parameters :
-- begin_time='01.01.2000 00:00:00'
-- end_time=''
-- group=''
-- only_non_idle_events=''
-- gr_title='test'
-- gr_abs_or_rel_wait_event=''
-- gr_y_or_y2_wait_event=''
-- gr_yrange_wait_event=''
-- gr_top_wait_event='5'
-- gr_stat_name_1=''
-- gr_stat_name_2=''
-- gr_stat_name_3=''
-- gr_stat_name_4=''
-- gr_stat_name_5=''
-- gr_stat_name_6=''
-- gr_stat_name_7=''

Show Offline Graphics
Show Online Graphics
--------------------------------------------------------------------------------------------------------

In diesem Beispiel wird eine Grafik für Statspack-Daten auf Snapshot-Basis für 5 Top Wait Events erzeugt.

Unter dem HTML-Link "Show Offline Graphics" verbirgt sich eine grafische Datei im PNG-Format. Diese Datei kann man nicht ändern, man kann sie in Dokumenten benutzen.

Falls man den HTML-Link "Show Online Graphics" anklickt, so wird GNUPLOT gestartet und die Grafik kann bearbeitet werden. In diesem Modus kann man Koordinate mit dem Cursor ablesen, man kann auch einzelne Grafikteile vergrößern, indem man entsprechende Fenster aus der Grafick ausschneidet. Bei Bedarf kann man die Grafik ändern, falls man sich gut mit GNUPLOT auskennt.