3.39 TopIOUsers

Use this Knowledge Script to monitor physical reads and writes (I/O) for current user sessions. If the number of physical reads/writes per second (the physical read/write operations rate) exceeds the threshold you set, the job raises an event.

You can specify the number of user sessions with the highest physical read/write operations rate to display in the Event Properties dialog box. Information in the Event Properties dialog box includes the physical reads/writes per second for each of the top N sessions, username, session ID, and program name.

This script requires that the Oracle timed_statistics parameter is turned on for the database you are monitoring.

The account you use to run this script must have SELECT permissions for the following tables:

DBA_USERS
V_$SESSION
V_$SESSTAT
V_$STATNAME
V_$VERSION

3.39.1 Resource Objects

Oracle Database folders. When you drop a script on an Oracle Database folder, a job executes on that database and monitors only that database.

3.39.2 Default Schedule

The default interval for this script is Every 30 minutes.

3.39.3 Setting Parameter Values

Set the following parameters as needed:

Description

How to Set It

Oracle Username

Enter the username that this script needs to access the target databases. If you run this script on more than one database, configure each database with the same username. To use SYSDBA authentication, leave this parameter blank. The default is blank.

Collect data for I/O activity of top N user sessions?

Select Yes to collect data for charts and reports. When you enable data collection, the Knowledge Script returns the total number of physical reads/writes per second for the top N users. The default is unselected.

Number of user sessions to display

Specify the number of top user sessions you want displayed in the Event Properties dialog box. Enter 0 if you want to see information for all user sessions. The default is 10.

Raise event if threshold is exceeded?

Select Yes to raise an event if the physical read/write operations of any single user session exceed the threshold you set. The defaults is Yes.

Threshold - Maximum read/write operations for a user session

Enter a threshold for the maximum number of physical reads/writes per second allowed before the job raises an event. The default is 300.

Severity

Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 10.

Event severity for internal failure

Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 5 (red event indicator).