MySQL is one of the most popular open-source relational database management systems (RDBMS). Configure this plugin and ensure an efficient database monitoring experience through vital actionable information.
This document details the following:
Performance Monitoring Metrics
threads_running metric counts the total number of threads that are currently running in the database and not sleeping.
reads identifies the total number of reads done in a MySQL server. Technically, it is the number of selected queries and number of query cache hits.
writes identifies the total number of writes done in a MySQL server. It is the sum of inserted queries, replaced queries, updated queries and deleted queries.
Number of slow queries running on the MySQL server is recorded using the metric slow_queries. Slow queries generate excessive disk reads, memory and CPU usage.
Temporary Tables Created on the Disk
Record the total number of internal on-disk temporary tables created by the server while executing statements with the metric
Use the metric
aborted_clients to get the total number of connections that were aborted because the client died without closing the connection properly. If a client is unable to connect, the server increments the Aborted Connects status variable.
Use the metric
aborted_connections to get the total number of failed attempts to connect to the MySQL server. If this counter is increasing, your clients are trying and failing to connect to the database.
connection_usage shows the total connection count with respect to the percentage of maximum connections in the database. This information can be used to tune database connections for better performance.
Maximum Used Connections
Maximum number of connections at a given time, since the start of the server is represented by the metric
max_used_connections. If your server reaches the maximum connections limit, it will start to refuse additional connection requests.
threads_connected metric counts the total number of currently open connections. It can also refer to the number of clients currently connected. If the value is zero or too high, something is wrong.
Temporary Tables Created
Record the total number of internal temporary tables created by the MySQL server with the metric
created_tmp_tables. If the value is high, you may want to increase the thread cache size value.
Get the count of the total number of files that are open with
open_files. This count includes regular files opened by the server. It does not include other types of files such as sockets or pipes. Also, the count does not include files that storage engines open using their own internal functions rather than asking the server level to do so.
- Our Linux server monitoring agent should be installed in the network or on the specific host where the MySQL instance is running.
- While adding a plugin, the plugin name and its folder name should be identical.
- The MySQL plugin will automatically verify, download and install the 'pymysql' module required for monitoring your MySQL servers. This can be viewed in the mysql.py file. In case the 'pymysql' module is not installed, follow the instructions given below to manually install it.
- Execute the following command in your server to install pymysql
pip install pymysql
- Use "pip" to install pymysql module
Note: pip is a package management system that is used to install and manage software packages written in Python.
- For CentOS, Fedora, RHEL:
yum install python-develyum install python-pip (or)easy_install pip
- For Debian, Ubuntu:
apt-get -y install python-pip
- Download and install the latest version of the Site24x7 Linux agent in the server where you plan to run the plugin. If it is installed successfully, you will see a Linux server monitor in the Site24x7 Control Panel. This confirms that the agent is able to communicate with our data center.
- Download the mysql.py file from our GitHub repository.
- By default, the plugin will use the below configuration to connect to the MySQL instance. To change the existing configuration, edit the '#Config Section' in the 'mysql.py' file.
#Config Section:MYSQL_HOST = "localhost"MYSQL_PORT="3306"MYSQL_USERNAME="username"MYSQL_PASSWORD="your password"
- Create a folder with the name 'mysql', under the Site24x7 Linux agent plugin directory '/opt/site24x7/monagent/plugins/' and place the 'mysql.py' under '/opt/site24x7/monagent/plugins/mysql/'
The agent will automatically execute the plugin within five minutes and send performance data to the Site24x7 data center.
Manually execute the plugin script using the following command and verify its output:
View Data in the Site24x7 Web Client
- Log in to Site24x7 and go to Server > Plugins > Name of Plugin Monitor.
- You will be able to view the performance charts on the various metrics for your MySQL server.
Customize your Plugin
To add/delete an attribute, or change its unit, edit the mysql.py file, make the desired changes, and increment the plugin version. From the next consecutive data collection, the changes would be reflected.
For eg., to add the metric "Flush_commands" for monitoring,
Append the following to the method metricCollector() data['flush_commands'] = global_metrics['Flush_commands']
- Increment the plugin version value in the file "mysql.py" from PLUGIN_VERSION = "1" to "PLUGIN_VERSION = "2"
- Save the changes. In the next data collection, this metric would be added for monitoring.
Feel free to contribute to our existing plugin and come up with suggestions or feedback on our Community.