ASH-Viewer for Oracle rewrited for PostgreSQL

ASH-Viewer for Oracle rewrited for PostgreSQL

Author: dbacvetkov

README

@@ -1,81 +1,52 @@
-				ASH Viewer
+				PASH Viewer
 
   What is it?
   -----------
-  ASH Viewer provides graphical view of active session history data within the Oracle instance. 
-
-  Active Session History (ASH) is a view in Oracle that maps a circular buffer in the SGA.
-  The name of the view is V$ACTIVE_SESSION_HISTORY. This view is populated every second
-  and will only contain data for 'active' sessions, which are defined as sessions
-  waiting on a non-idle event or on a CPU.
-
-  ASH Viewer provides graphical Top Activity, similar Top Activity analysis and Drilldown
-  of Oracle Enterprise Manager performance page. ASH Viewer store ASH data locally using
-  embedded database Oracle Berkeley DB Java Edition. The default capture rate is one snapshot
-  every 30 seconds. ASH Viewer support 10g, 11g version of Oracle DB. Use SYSTEM database user
-  to connect to Oracle DB. Please note that v$active_session_history is a part of the Oracle Diagnostic Pack
-  and requires a purchase of the ODP license.
-  
-  For Oracle 9i(8i) DB, ASH Viewer emulate ASH, storing active session data on local storage.
-  The default capture rate is one snapshot every 1 second. For Oracle 9i(8i) DB,
-  user SYSTEM must have access rights to the views sys.x_$ksuse, sys.x_$ksusecst
-  
-  	create view x_$ksuse as select * from x$ksuse;
-	create view x_$ksusecst as select * from x$ksusecst;
-	
-	grant select on sys.x_$ksuse to system;
-	grant select on sys.x_$ksusecst to system;
+  PosetgreSQL ASH Viewer (PASH Viewer) provides graphical view of active session history data within the PostgreSQL database.
+
+  PASH Viewer provides graphical Top Activity, similar Top Activity analysis of Oracle Enterprise Manager performance page.
+  PASH Viewer store ASH data locally using embedded database Oracle Berkeley DB Java Edition.
+  The default capture rate is one snapshot every 1 seconds.
+  PASH Viewer support PostgreSQL 10 (and 9.4 - 9.6 with limited functions).
+
+  Use superuser (postgres) to connect to DB, if you want to see query plans.
+  Or use your special user for monitoring:
+
+    CREATE USER pgmonuser WITH password 'pgmonuser';
+    GRANT pg_monitor TO pgmonuser;
+
 
   System Requirements
   -------------------
-  JDK:
-    1.5u11 or above.
-  Memory:
-    Minimum 128 Mb. Recommended 192 Mb.
-  Disk:
-    It depends on Oracle workload.
-  Operating System:
-    No minimum requirement.
-
-  Building ASH Viewer
+  JDK 1.7+
+
+
+  Building PASH Viewer
   ----------------
-  1) Download JDBC driver ojdbc6.jar from http://otn.oracle.com and put it to ashv-<<version>>-bin/lib directory.
+  1) Run ./gradlew assembleDist (gradlew.bat for Windows)
 
-  2) Run ./gradlew assembleDist (gradlew.bat for Windows)
+  2) Binary archive will be created in build/distributions directory
 
-  3) Binary archive will be created in build/distributions directory
 
-  Running ASH Viewer
+  Running PASH Viewer
   ----------------
   1) Unpack the archive, eg:
-      unzip ashv-<<version>>-bin.zip
+      unzip PASH-Viewer-0.3.zip
 
-  2) A directory called "ashv-<<version>>-bin" will be created.
+  2) A directory called "PASH-Viewer-0.3" will be created.
 
-  3) Download JDBC driver ojdbc6.jar from http://otn.oracle.com and put it to ashv-<<version>>-bin/lib directory.
-
-  4) Make sure JAVA_HOME is set to the location of your JDK, 
+  3) Make sure JAVA_HOME is set to the location of your JDK, 
   	  see run.cmd/run.sh (on Windows/Unix platform).
 
-  5) Create monitor user in Oracle DB and grant select and execute priviliges using user_privs.sql file.
+  4) Run bin/PASH-Viewer.bat or bin/PASH-Viewer (on Window/Unix).
 
-  6) Run bin/ASH-Viewer.bat or bin/ASH-Viewer (on Window/Unix).
 
-   Known issues
-  --------------
-   Problem: When running ASH Viewer on JRE6, dragging window slider on Top Activity is too slow
-   Workaround: use JDK5+ or JRE5 to run ASH Viewer
-   
-   Problem: On Oracle 9i, select from v$sql_plan, cause extreme library cache latch contention 
-   Workaround: collect statistics on fixed table x$kqlfxpl to resolve this issue:
-   				SQL> exec dbms_stats.gather_table_stats('SYS','X$KQLFXPL');
-   
    Licensing
-  ---------
+   ---------
    Please see the file called LICENSE
 
-   ASH Viewer URL
-  ----------
-   http://ashv.sourceforge.net
-   https://github.com/akardapolov/ASH-Viewer
-   
+
+   PASH Viewer URL
+   ----------
+   https://sourceforge.net/projects/pash-viewer/
+   https://github.com/dbacvetkov/PASH-Viewer

build.gradle

@@ -10,17 +10,17 @@
 apply plugin: 'application'
 apply plugin: 'java'
 
-version = '3.5.1'
-sourceCompatibility = 1.5
-targetCompatibility = 1.5
+version = '0.3'
+sourceCompatibility = 1.7
+targetCompatibility = 1.7
 
 mainClassName = "org.ash.MainApp"
 applicationDefaultJvmArgs = ["-Xmx512m"]
 
 //create a single Jar with all dependencies
 task fatJar(type: Jar) {
     manifest {
-        attributes 'Implementation-Title': 'ASH Viewer',
+        attributes 'Implementation-Title': 'PASH Viewer',
                 'Implementation-Version': version,
                 'Main-Class': mainClassName
     }

build.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
-<project default="run" name="ASHV">
+<project default="run" name="PASHV">
     <description>
-        ASH Viewer build file
+        PASH Viewer build file
     </description>
 
     <property name="main.class" value="org.ash.MainApp"/>
@@ -32,8 +32,8 @@
                destdir="${build.dir}"
                debug="on"
                deprecation="false"
-               source="1.5"
-               target="1.5"
+               source="1.7"
+               target="1.7"
                classpath="${build.classpath}"
                includeantruntime="false">
             <include name="org/jfree/**"/>

lib/postgresql-42.2.2.jre7.jar

@@ -1,2 +1,2 @@
-rootProject.name = 'ASH-Viewer'
+rootProject.name = 'PASH-Viewer'
 

settings.gradle

@@ -65,20 +65,17 @@ public GradientColorContext()
     public static final GraphicsContext blue;
     public static final GraphicsContext BLUE;
 
-    public static final GraphicsContext OTHER0;
-    public static final GraphicsContext CLUSTER11;
-    public static final GraphicsContext QUEUEING12;
-    public static final GraphicsContext NETWORK7;
-    public static final GraphicsContext ADMINISTRATIVE3;
-    public static final GraphicsContext CONFIGURATION2;
-    public static final GraphicsContext COMMIT5;
-    public static final GraphicsContext APPLICATION1;
-    public static final GraphicsContext CONCURRENCY4;
-    public static final GraphicsContext SYSTEMIO9;
-    public static final GraphicsContext USERIO8;
-    public static final GraphicsContext SCHEDULER10;
-    public static final GraphicsContext CPU;
-    
+    public static final GraphicsContext CPU0;
+    public static final GraphicsContext IO1;
+    public static final GraphicsContext LOCK2;
+    public static final GraphicsContext LWLOCK3;
+    public static final GraphicsContext BUFFERPIN4;
+    public static final GraphicsContext ACTIVITY5;
+    public static final GraphicsContext EXTENSION6;
+    public static final GraphicsContext CLIENT7;
+    public static final GraphicsContext IPC8;
+    public static final GraphicsContext TIMEOUT9;
+
     static 
     {
         WHITE = new LocalColorContext(Color.white);
@@ -105,19 +102,16 @@ public GradientColorContext()
         CYAN = cyan;
         blue = new LocalColorContext(Color.blue);
         BLUE = blue;
-        
-        OTHER0 = new LocalColorContext(new Color(255,87,143));        
-        CLUSTER11 = new LocalColorContext(new Color(117,117,117));
-        QUEUEING12 = new LocalColorContext(new Color(232,232,232));        
-        NETWORK7 = new LocalColorContext(new Color(156,157,108));
-       	ADMINISTRATIVE3 = new LocalColorContext(new Color(84,84,29));
-   		CONFIGURATION2 = new LocalColorContext(new Color(84,56,28));
-   		COMMIT5 = new LocalColorContext(new Color(194,133,71));
-   		APPLICATION1 = new LocalColorContext(new Color(194,71,71));
-   		CONCURRENCY4 = new LocalColorContext(new Color(153,51,51));
-   		SYSTEMIO9 = new LocalColorContext(new Color(0,161,230));
-   		USERIO8 = new LocalColorContext(new Color(0,46,230));
-   		SCHEDULER10 = new LocalColorContext(new Color(133,255,133));
-   		CPU = new LocalColorContext(new Color(0,179,0));
+
+        CPU0 = new LocalColorContext(new Color(0,204,0));
+        IO1 = new LocalColorContext(new Color(0,74,231));
+        LOCK2 = new LocalColorContext(new Color(192,40,0));
+        LWLOCK3 = new LocalColorContext(new Color(139,26,0));
+        BUFFERPIN4 = new LocalColorContext(new Color(0,161,230));
+        ACTIVITY5 = new LocalColorContext(new Color(255,165,0));
+        EXTENSION6 = new LocalColorContext(new Color(0,123,20));
+        CLIENT7 = new LocalColorContext(new Color(159,147,113));
+        IPC8 = new LocalColorContext(new Color(240,110,170));
+        TIMEOUT9 = new LocalColorContext(new Color(84,56,28));
     }
 }