MySQL database monitoring will require SiteScope to be deployed acting as a bridging collector before it can be displayed in LoadRunner. The connection is illustrated in the following.

The specified statistics retrieval mechanism utilizes Database Query monitor in SiteScope. This is done by logging into MySQL database via SiteScope Database Query monitor and issuing a SHOW STATUS command to retrieve the statistics. Example of the command is as followed:

show status where variable_name like ’innodb_buffer_pool_pages_total’

Therefore, prior this monitor setup, SiteScope should already be deployed or considered in the deployment. Refer to SiteScope setup for more information. The ports between LoadRunner and SiteScope, SiteScope and MySQL should be opened on TCP 8888 and TCP 3306 respectively by default. On top of this basic requirement, monitoring a MySQL database requires the use of JDBC Driver, which SiteScope uses to interact with the MySQL database.

In summary, what you need before the setup is as followed.

1. SiteScope to be deployed.
2. Sufficient license points for Database Query monitor.
3. TCP 8888 (default) opened two-way for LoadRunner to SiteScope.
4. TCP 3306 (default) opened two-way for SiteScope to MySQL.
5. Monitoring privileges for SiteScope to monitor MySQL.
6. JDBC driver to be installed on SiteScope.
7. Have knowledge of the counter you want to monitor.

Let’s go into the details!

1. Download the JDBC driver from MySQL Download Connectors page.
2. Uncompress the distribution file.
3. Among all the other files, find and extract a file with .jar extension to Sitescope/java/lib/ext directory. (Source: SiteScope Monitor Guide)
4. Gather information about the hostname of the server and the database instance prior this step. In SiteScope console, add Database Query monitor to the existing monitoring group for the server (refer to SiteScope User Guide for more information). You should have the Name the monitor as mysql-{status_variable} to standardize the monitors (e.g. mysql-innodb_buffer_pool_pages_total).
5. In the settings enter the following:

Fig. 2 SiteScope Settings

Frequencies

What SiteScope documentation proposes is:

- For most critical and common query 2-5min.
- Database statistics that change less frequently can be monitored every 30 or 60min.

(Source: SiteScope Monitor Guide)

As for me, what I feel is to run the query at about 15-30secs interval as typical LoadRunner monitoring, it is defaulted at 15 secs. However by doing so, it may create additional overhead for making the query.

Database Connection

• Enter in the following format: Jdbc:mysql://{database hostname}[:{tcp port}]/{database}
• E.g. jdbc:mysql://DB-MySQL01:3306/mysql

Database Driver

• Enter following: org.gjt.mm.mysql.Driver (This Database Driver only applies for MySQL JDBC driver)

Query

• Enter the Command Line for Query to Database
• E.g. show status where variable_name like ’innodb_buffer_pool_pages_total’
• You can also run queries that directly execute on table based on your needs!

Advanced Settings

• Enter Database User Name and Database Password for logging in of MySQL Database. I’m using root account to execute the query. I’m not too sure if there is any possibility of knowing the correct privilege needed to monitor. If you do, please let us know.

Upon successful connection, you will prompt with ‘Successful Connection’ and the time Sitescope took to Query MySQL Database.

If you need to monitor another MySQL counter, a new monitor needs to be created. Example, if you want to monitor the Qcache_hits, you will have to perform step 4 to step 5 again for this new counter. Do ensure you have sufficient SiteScope license points for another monitor!

This concludes the monitoring for MySQL database server. Point to note that the queries executed may cause overhead to the database server which may required you to balance the pros and cons to implement this monitor.

Anyway, the definition of the counters can be found in “MySQL 6.0 Reference Manual :: 5 MySQL Server Administration :: 5.1 The MySQL Server :: 5.1.5 Status Variables” which you should refer to when in doubt.

List of MySQL counters

Let’s go through a technical overview of what you need to do for it to work!

1. Get and install the database driver to connect to the database
2. Get the database connection string
3. Get the SQL statement for query
4. Create a new parameter using Database Query Wizard
5. Enter the connection string and the SQL statement

Now, let’s go through the details here with some screenshots to make it easier to understand.

[1] Download driver

I’ve obtained my MySQL-ODBC driver from MySQL website. You will need to find out what is the driver required to connect your database accordingly.

[2] Get the database connection string

In the context of MySQL database, I referred to ConnectionStrings. The string that I used was for 3.51 driver and I was trying out on a localhost MySQL which will looked like the below

Driver={MySQL ODBC 3.51 Driver};Server=localhost;Database=myDatabase; User=root;Password=rootpassword;Option=3;

Of course, you can refer to other type of connection string in ConnectionStrings.com as well! If you have tried out with other database, please let us know and we can compile them into a single source of reference point!

[3] Get the SQL statement

The SQL statement that I used was show status, which actually queries the status of MySQL database. Take note, I’m just using it for example purposes, you can use conventional statements like SELECT field FROM table.

[4] Create a new parameter using Database Query Wizard

In the script and create a new parameter using Database Query Wizard (Open Parameter list > New > Data Wizard > Select “Specify SQL statement manually” > click “Next”)

Database Query Wizard

[5] Enter the Connection String and SQL statement

Enter the Connection String and SQL statement, and click “Finish”. If the connection string and SQL statement are valid, after you clicked “Finish” the parameter should be populated accordingly.

Enter Connection String and SQL statement

Connection and query successful!

That’s it and done! Hope it helps you when you are using the Database Query Wizard! Do share with us if you have tried other databases with the Database Query Wizard!