Skip to main content

Multiple Instance Monitoring

Home > Select Project > Dashboard > Monitoring Multiple Instances

While you can monitor only one instance in Monitoring a Database Instance, Monitoring Multiple Instances allows you to see and compare the metrics for multiple instances on a screen. You can quickly see the status of instances through grouped values of instance metrics such as running agent count, total number of active sessions, and transaction information. Graph charts make it easy to see how instances' metric values are trending and which instances have higher metric values. It provides information of the longest lasting active session.

Multi-instance Monitoring

Tip

If you select an agent to compare in Dashboard > Instance List, and then select Multi view, the Monitoring Multiple Instances menu appears.

Viewing the past data

The dashboard basically provides real-time monitoring features in which you can view the past data.

Real-time modeNon-real-time mode
Real-time modeNon-real-time mode
  1. Select Pause icon in the time selector at the upper left of the screen.

  2. Click the date and time to set the desired time zone.

    Configure manual time

  3. Select Apply.

It updates the data in widgets placed on the dashboard based on the set time. To switch to the Realtime mode, select Playback icon.

Checking the agent

Checking the agent connection status

On the upper left of the screen, the right area of the time selector provides information that allows you to check the status of agents connected to the project. This allows you to immediately check whether the target application server is running.

  • Total: Number of all agents connected to the project

  • Active: Number of active agents

  • Inactive: Number of inactive agents

  • Agent display icon: Can display or hide inactive agents.

Agent-based monitoring

Selecting the agent

By default, the dashboard displays the metrics collected from all agents in charts and you can also view the data by agent. Select one or more agents under the time selector. The data of the widgets on the dashboard is updated with the metrics of the selected agent(s).

Tip

To select all agents again while one or more agents is selected, deselect them or select Total.

Note

If there are numerous agents connected to the project, it is efficient to set the agent names to be short. For more information about the agent name setting, see the following.

Editing a dashboard widget

The widgets on the dashboard can be adjusted to the desired size and placed in the desired positions. You can also delete unnecessary widgets or add them again.

Resizing a widget

Resizing a widget

Click and hold the mouse on the Resize icon element at the lower right of the widget, and then drag it to the desired size. Grids with a uniform horizontal-to-vertical ratio appear and the size of the widget can be adjusted in each grid.

Moving a widget

Moving a widget

When you move the mouse cursor to the top of the widget, the cursor shape changes to Move icon. At this time, you can move the widget by dragging with your left mouse button and move to the desired position.

Deleting a widget

Deleting a widget

Right-click on a widget to delete. If you select Delete, the widget is deleted from the dashboard.

Adding a widget

Adding widget

Move the mouse cursor to an empty space on the dashboard and then right-click on it. Select a widget to add from the pop-up menu. Place the widget to the desired position and then resize it.

Note
  • For more information about the widgets that can be placed on the dashboard, see the following.

  • The widgets that can be added are fixed, but we plan to increase supports through future updates.

Using the widget options

The icons displayed on the widget function as follows:

  • Information icon: You can see the features and information for major widgets. (multilingual support planned)

  • Up arrow icon or Down arrow icon: You can enlarge or reduce the range of the vertical axis.

  • Fullscreen icon: You can view the widget's data on a wider screen.

  • Detail icon : A modal window appears where you can search the data of the widgets separately by agent.

Note

The provided options may differ depending on the widget.

Preset

You can save and load the settings and layouts for widgets on the dashboard. The default preset (Default) cannot be changed, but you can create a new preset by resizing and placing widgets in the desired format.

Preset

  • Default: This preset consists of XOS metrics, AWS RDS CloudWatch metrics, and major DB metrics.

  • Default(xos): This preset consists of XOS metrics and major DB metrics.

  • Default(rds): This preset consists of AWS RDS CloudWatch metrics and major DB metrics.

Creating a new preset

  1. Place the widgets in the desired format on the dashboard. You can also resize and place only the widgets to be frequently checked.

  2. On the upper right of the screen, select Save icon.

  3. Enter a new preset name.

    Save Preset

    To save the selected agent data, select Include agent selection history.

  4. Select Save.

You can see the newly saved preset from the preset list.

Note
  • If any changes are made to the newly created preset, save the preset again. Select Save icon and then save the preset with the same name. Any changes are overwritten in the existing preset.

  • If you go to another menu without saving changes on the dashboard, the changes are not saved.

  • Presets are saved in your user account and cannot be shared with other users. We plan to update it for better features.

Deleting presets

If you have unused presets, you can delete them from the preset list. Select Delete icon on the right of the item to delete from the preset list.

Learning about the main widgets

The types of widgets that can be placed on the dashboard are as follows.

XOS widgets

  • [XOS] CPU

    You can see the CPU usages for each agent in real time.

  • [XOS] Memory

    You can see the memory usages for each agent in real time.

  • XOS Disk Usage

    Displays the disk utilizations, free sizes, and total sizes for each agent. If you select Icon on the upper right of the widget, you can see them on a wider screen.

    Tip

    If there is no data displayed, add the following settings to the xos.conf file.

    xos.conf
    # Off if the disk usage is 0; unit: second
    disk_usage_interval=60

AWS RDS CloudWatch widgets

  • [RDS] CPUUtilization

    You can see the CPU usages for each RDS DB instance in real time.

  • [RDS] FreeableMemory

    You can see the memory usages for each RDS DB instance in real time.

  • [RDS] FreeStorageSpace

    You can see the free storage space in the RDS database in real time.

Note

For information on how to configure the agent for inquiry of AWS CloudWatch metrics, see the following.

Database widgets

  • Active Sessions

    Displays a real-time chart for the number of sessions running queries.

  • Questions

    Number of commands executed by the MySQL server. It differs from the Queries in that it does not count commands executed in a stored program.

  • Slow Query

    Displays a real-time chart for slow queries for each time zone. If you drag a specific part of the chart, the Slow Query List appears. You can enlarge or reduce the range of the vertical axis by selecting Up arrow icon or Down arrow icon.

  • Logical I/O

    It displays the number of logical read requests including physical reads on the real-time chart. You can calculate the Innodb buffer pool hit percentage as follows, and 90% or higher is recommended. If Hit Ratio is low, consider increasing the Innodb_buffer_pool_size.

    Buffer Hit Ratio = (1 - (Innodb_buffer_pool_reads/Innodb_buffer_pool_read_requests)) * 100

  • SQL Elapse Map

    Displays a real-time chart for the elapsed times of running queries. If you drag a specific part of the chart, the Query List appears. You can enlarge or reduce the range of the vertical axis by selecting Up arrow icon or Down arrow icon.

    Note

    The execution times of queries are calculated after collecting active sessions. Therefore, depending on the active session collection cycle, there may be a margin of error. See the following figure. The execution times of SQL queries that have ended within the collection cycle are not calculated. A shorter collection cycle may decrease the margin of error, but considering the database load, it is typically set to 5 seconds. It is useful for monitoring long-running queries. The same is true for the data in SQL statistics.

  • Lock Wait Sessions

    Displays a real-time chart for queued counts to acquire the row lock.

  • Commit

    Displays a real-time chart for the counts of committed transactions.

  • Replication Delay

    Displays a real-time chart for the delayed times that are reflected in the replication DB in case of the replication structure.

  • Physical I/O

    Displays a real-time chart for the data read counts in the physical disks.

  • Select Full Join

    When joining one or more tables (JOIN), the number of full scans for driven tables without using any index appears in a real-time chart.

  • Tmp Tables

    Displays a real-time chart for internal temporary table counts created by the server during command execution for each instance.

Session Table widget

You can view real-time active sessions and lock trees in the Session Table widget at the bottom of the screen.

  • Active sessions

    You can view active sessions and queries. If you select an item in the rightmost 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.

Note

In the table list, the text colors are changed black → orangeRed, which means that the performance of the session is getting slower.

Checking the session information details

If you select a session in the Active sessions tab, the Session detail window appears. You can see the information details about the selected session.

Session detail

  • The session information is viewed in real time by default. If you select Pause icon in the time selector, you can stop a real-time view and see the data based on the paused time. To refresh data while pausing a real-time view, select Refresh icon.

  • Kill Session: You can stop the selected session. If the Session kill window appears, enter the password (Parameter Key) and then select Apply.

    Note

    This feature is only available in real-time viewing mode.

  • Session Info: You can see the information details of the selected session.

  • Wait Info: If the backend process is waiting, you can see the wait event name (wait_event) and wait event type (wait_event_type).

  • Process_Info: You can see the process information details of the selected session.

  • SQL Text / Plan: You can see the SQL query statements and plans of the selected session. For more information, see the following.

See query details

To check the SQL query information of the current running session, select the query column in the Active sessions section. The SQL details window appears. You can check the SQL query statements and plan information.

SQL details

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

  • Default Bind: You can bind the part set as a variable in the query sentence to the default value.

  • Reset Bind: You can release the bound default value and check the variable.

  • Formatting: You can improve readability by applying indentation and formatting to a SQL query statement.

  • Plan: To check plan information, enter DB Name, User Name, and Password, and then select Search icon.

    • Text: You can check plan information in text format.

    • JSON: By viewing the plan information in Json format, you can quickly find the points where bottlenecks occur.

    Note

    The function to view plan information in JSON format is supported only in DBX agent 1.6.15 or later.

Tip

If you select a table or index while viewing the plan information in JSON format, the Object detail window appears where you can see the configurations for columns and index items in the table.

Object detail

This function is supported in DBX agent 1.6.15 or later. For more information about the database roles and related settings, see the following.

Filtering the table data

Filter

  1. Select Filter icon on the upper right of the table.

  2. Select a column header and a condition in the table.

  3. Enter a desired value in the Enter conditions field.

  4. Select Save.

Configuring the table columns

You can hide the table header columns or add any of them. You can also change the column order. Select Column icon.

Column Settings

Note
  • After configuration, select OK to apply the settings in the table.

  • In the number 3 search bar, enter text to search the desired columns. Only the columns that meet the entered text are displayed.

Adding columns

From the Number 1 list, select the items to add as table header columns. To select all items, select Select All.

Deleting columns

From the number 1 list, unselect the columns to delete. Alternatively, select Delete icon on the right of the item to delete from the number 2 list.

Changing the column order

Drag an item to reposition from the number 2 list, and then move it to the desired position.

Initializing the configuration

To cancel all changes and reset them, select Reset icon Reset.

Column information guide

ItemDescription
Instance NameInstance Name
idConnection identifier
userSQL execution account
hostHostname that this thread is connected to.
dbDefault database name. If nothing, it is NULL.
commandRunning command type (Query/Sleep/Daemon, etc.)
timeExecution time of the current command (sec)
stateCurrent thread status (executing, updating, sending data, etc.)
queryRunning statement. It displays the literal value SQL separated from Processlist.info.
query_paramLiteral value separated from query
typeThread type. FOREGROUND/BACKGROUND, etc.
connection_typeThe protocol used to establish a connection. TCP/IP, SSL/TLS

Downloading the view list

You can download the current Session Table list in CSV format. Select Download icon on the upper right of the Session Table section.

The naming format of the downloaded file is as follows:

  • Active sessions: activeSession_HH_MM_SS.csv

  • Lock tree: lockTree_HH_MM_SS.csv

Viewing in a new window

You can see the Session Table list on a new wider screen. Select New window icon on the upper right of the Session Table section.