Monitoring a Database Instance

Home > Select Project > Dashboard > Monitoring a Database Instance

In Monitoring a Database Instance, you can monitor the key metrics of the database server, information details on active sessions, lock tree, PQ tree, and process information in real time. You can also see the alerts that could be problematic warnings. By default, the collected data for the last 10 minutes is retrieved in real time. Collected data is updated every 5 seconds.

Basic screen guide

• Selecting a lookup target

• Graph chart section

  The horizontal axis of each widget is time, and the vertical axis is the metric number. If you select a specific time period in each widget, Analysis > Counts Trend appears.

• Active sessions | Lock tree | Process Info

  You can view the active session, lock tree, and process information.

  • Active sessions

    You can view active sessions and queries. If you select an item in the rightmost sql_text or query column in the table, the SQL details window appears. You can see the full text and plan information for the selected query. For more information, see the following.

  • Lock tree

    You can see the lock session information, and holder and waiter information in real time. For more information about the table columns, see the following.

  • Process Info

    You can query the resource usage of the database server in real time.

Note

• Colors in the database correspond to the ones in the graph chart.

• For more information about Counts Trend, see the following.

• For more information about each metric, see the following.

• For more information about the columns, see the following.

• The Process Info can be viewed by additionally configuring the XOS agent. For more information, see the following.

Selecting a metric

You can change the metric of the graph chart widget placed on the screen to another one.

1. Select on the upper right of the widget to change the metrics.

2. If the Count selector window appears, select a desired metric.

   

3. Select Save.

The metric of the selected widget is changed.

Note

For more information about each metric, see the following.

Layout setting

To set the layout on the metrics chart, on the upper right of the screen, select . Nine (3x3) metrics charts are set on the default layout, and you can change the number of charts on a page.

Using the active session section

Through Active sessions at the bottom of the screen, you can see the real-time active sessions. The following provides the guide for the button on the upper right of the table.

• : You can stop changing the data collected in real time. To restart it again, select .

• : The list of tables is refreshed.

• : The column header entries in the table can be displayed or hidden.

• : You can filter the list based on the column header entries in the table. After selecting the button, you can set the conditions in each header column such as Includes, Excludes, Equal, and Unequal.

  Note

  Adjust the column width if the text field for filter condition options is invisible.

• : You can download the content of the table as a CSV file.

Stopping an active session

You can stop a session(s) that has been running for a long time.

1. In the Active sessions list, move your mouse cursor to the session to terminate.

2. Select the that appears on the utmost right.

3. If the Session kill window appears, enter the password.

4. Select Apply.

The session is stopped.

Note

• Through the paramkey.txt file in the DBX agent installation path, you can find the password.

• This feature is only available to the members with Edit role. For more information about member roles, see the following.

Zooming in the graph chart section

If the current screen is small and difficult to see the widget, you can check the graph chart widget in a wider screen. Select in the Active sessions section at the bottom of the screen. The Active sessions section is collapsed and the graph chart widget section is enlarged.

To zoom out the graph chart widget, select at the bottom of the Active sessions section.

See query details

To check the SQL query information of the executing session, select the query (or sql_text) column in the Active sessions section. The SQL details window appears. You can check the SQL query statements and plan information.

• View SQL Statistics: You can go to the SQL statistics menu where you can check statistical information related to the SQL query statement.

Changing the table columns

You can display or hide the column entries in the table, and change their order.

1. Select on the upper right of the table.

2. When the Column Setting window appears, hide, add, or change the order of items to be displayed in the table columns.

   • Select a column, and then , , or . Go to Visible or Invisible.
   • You can move the position by dragging the column while it is selected.

3. After all settings are finished, select Save.

Note

The setting is saved as a browser cookie value to maintain the state even after refreshing the page. If an error occurs between settings due to cookie deletion or other reasons, it is initialized.

Column information guide

Active session

Item	Description
instance	Agent or instance name.
pid	PID of the database process.
dbname	Name of the connected database.
user	User name connected to the database.
query_time	Query execution time.
transtatus	Current state of the transaction.
query	Executed SQL query.
query_hash	Hash value of the query.
query_param	Parameters used for a query.
program	Program information executed by the client.
tranindex	Unique number that identifies the running transaction.
tran_time	Time elapsed since the transaction began.
sql_id	Unique ID for the running SQL query.
time	Task operation time
lock_holder	Session that has locked the resources in the current transaction.

Lock tree

Item	Description
instance	Agent or instance name.
pid	PID of the database process.
tranindex	Unique number that identifies the running transaction.
user	User name connected to the database.
query_time	Query execution time.
transtatus	Current state of the transaction.
query	Executed SQL query.
query_hash	Hash value of the query.
query_param	Parameters used for a query.
lock_holder	Session that has locked the resources in the current transaction.

Process information

The following items are the metrics collected if the XOS agent has been installed.

Item	Description
cputime	CPU usage time
cpuusage	CPU Utilization
elapse	Elapsed time of CPU usage
vsize	Virtual memory size (Kb)
rss	Resident Set Size (RSS) that is the number of physical pages associated with the process.
state	Process status
ioread	Actual time spent reading the block (milliseconds)
iowrite	Actual time spent writing the block (milliseconds)
pss	Process specific memory usage + Percentage of shared memory occupied by one process
uid	user id
cmd	Executing command
longcmd	Full path of cmd

Note

WhaTap basically stores the client-related information.