Myawr is a tool for collecting and analyzing performance data for MySQL database (including os info ,mysql status info and Slow Query Log all of details). The idea comes from Oracle awr. Myawr periodic collect data and save to the database as snapshots. Myawr was designed as CS architecture.Myawr depends on (but not necessary) performance schema of MySQL database. Myawr consists of three parts: myawr.pl--------a perl script for collecting mysql performance data myawrrpt.pl-----a perl script for analyzing mysql performance data myawrsrpt.pl-----a perl script for analyzing mysql peak time data Myawr relies on the Percona Toolkit to do the slow query log collection. Specifically you can run pt-query-digest. To parse your slow logs and insert them into your server database for reporting and analyzing. Thanks to orzdba.pl ([email protected]).
Here is myawr architecture:
myawr db include tables list: mysql> show tables; +----------------------------------------------------------+ | Tables_in_myawr | +----------------------------------------------------------+ | myawr_active_session | | myawr_cpu_info | | myawr_engine_innodb_status | | myawr_host | | myawr_innodb_info | | myawr_innodb_lock_waits | | myawr_innodb_locks | | myawr_innodb_trx | | myawr_io_info | | myawr_isam_info | | myawr_load_info | | myawr_mysql_info | | myawr_query_review | | myawr_query_review_history | | myawr_snapshot | | myawr_snapshot_events_waits_summary_global_by_event_name | | myawr_snapshot_file_summary_by_event_name | | myawr_swap_net_disk_info | +----------------------------------------------------------+ 18 rows in set (0.00 sec)some key tables: myawr_host-- mysql instance config table myawr_snapshot -- snapshot table,exec myawr.pl a time as a shapshot myawr_query_review_history -- The table in which to store historical values for review trend analysis about slow log.
myawr data model: myawr_snapshot.host_id reference myawr_host.id; myawr_query_review_history.hostid_max reference myawr_host.id; myawr_innodb_info.(host_id,snap_id) reference myawr_snapshot.(host_id,snap_id);
If you are interesting to use this tool, here's what you need:
- A MySQL database to store snapshot data and slow log analysis data .
- pt-query-digest by percona
- A MySQL server(version 5.5) with perl-DBD-mysql
- slow query logs named like slow_20130521.log,you can switch slow logs every day.
3.1 install db(where you store shapshot data,perl-DBD-MySQL is required) Connect to the MySQL database where store the performance data and issue the following command in myawr.sql: grant all on myawr.* to 'myuser'@'localhost' identified by "111111"; grant all on myawr.* to 'myuser'@'%' identified by "111111"; then create tables.
3.2 initialize myawr_host(where you store shapshot data) Insert a config record about your mysql instacne,just like: INSERT INTO
myawr_host(id,host_name,ip_addr,port,db_role,version, running_thread_threshold,times_per_hour) VALUES (6, 'db2.11', '192.168.2.11', 3306, 'master', '5.5.27',10000,0);Running_thread_threshold and times_per_hour control whether collect peak time information or not. Running_thread_threshold is a trigger for status Threads_running. Times_per_hour control the times of collection in lasted a hour. If you want to collect peak time infomation ,They have to : running_thread_threshold<=now_running_threads and times_saved<times_per_hour
3.3 add two jobs in crontab(That mysql instance you want to watch,perl-DBD-MySQL is required)
grant all on . to 'superuser'@'localhost' identified by "111111";
-
-
-
-
- perl /data/mysql/sh/myawr.pl -u user -p 111111 -lh 192.168.2.11 -P 3306 -tu user -tp 111111 -TP 3306 -th 192.168.1.92 -n eth0 -d sdb1 -I 6 >> /data/mysql/sh/myawr_pl.log 2>&1
-
-
-
15 14 * * * /data/mysql/sh/pt-query-digest --user=user --password=111111 --review h=192.168.1.92,D=myawr,t=myawr_query_review --review-history h=192.168.1.92,D=myawr,t=myawr_query_review_history --no-report --limit=100% --filter="$event->{add_column} = length($event->{arg}) and $event->{hostid}=6" /data/mysql/sh/slow_date -d "-1 day" +"\%Y\%m\%d".log >> /data/mysql/sh/pt-query_run.log 2>&1
myawr.pl Parameters:
-h,--help Print Help Info.
-i,--interval Time(second) Interval(default 1).
-d,--disk Disk Info(can't be null,default sda1).
-n,--net Net Info(default eth0).
-P,--port Port number to use for local mysql connection(default 3306).
-u,--user user name for local mysql(default user).
-p,--pswd user password for local mysql(can't be null).
-lh,--lhost localhost(ip) for mysql where info is got(can't be null).
-TP,--tport Port number to use formysql where info is saved (default 3306)
-tu,--tuser user name for mysql where info is saved(default user).
-tp,--pswd user password for mysql where info is saved(can't be null).
-th,--thost host(ip) for mysql where info is saved(can't be null).
-I,--tid db instance register id(can't be null,Reference myawr_host.id)
pt-query-digest Parameters: --user user name for mysql where info is saved --password user password for mysql where info is saved --review Store a sample of each class of query in this DSN h host(ip) for mysql where info is saved D database t table name --review-history The table in which to store historical values for review trend analysis. h host(ip) for mysql where info is saved D database t table name $event->{hostid}=6 db instance register id(Reference myawr_host.id)
The pt-query-digest only support mechanism for switching a slow log file every day just now, named like slow_20130521.log(slow_date -d "-1 day" +"%Y%m%d".log)
perl-DBD-mysql you can install it two way: yum install perl-DBD-MySQL or install manually like : mkdir /tmp/mysqldbd-install cp /usr/lib64/mysql/*.a /tmp/mysqldbd-install perl Makefile.PL --libs="-L/tmp/mysqldbd-install -lmysqlclient" make make test make install
We can use myawrrpt.pl to generate mysql workload report.You can execute the script on MySQL database machine where store the performance data,but perl-DBD-MySQL is required.We also can execute the script in any linux machine with perl-DBD-MySQL installed.You can execute it for help Info: perl myawrrpt.pl -h
Info : Created By noodba (www.noodba.com). References: Oracle awr Usage : Command line options :
-h,--help Print Help Info.
-P,--port Port number to use for local mysql connection(default 3306). -u,--user user name for local mysql(default user). -p,--pswd user password for local mysql(can't be null). -lh,--lhost localhost(ip) for mysql where info is got(can't be null).
-I,--tid db instance register id(can't be null,Ref myawr_host.id)Let use to generate mysql (db2.11,instance id = 6) workload report: perl myawrrpt.pl -u user -p 111111 -P 3306 -lh 192.168.1.92 -I 6
| Welcome to use the myawrrpt tool !
| Date: 2013-05-22 | | Hostname is: db2.11 | Ip addr is: 192.168.2.11 | Port is: 3306 | Db role is: master |Server version is: 5.5.27 | Uptime is: 0y 2m 2d 7h 55mi 33s | | Min snap_id is: 1 | Min snap_time is: 2013-05-21 14:12:02 | Max snap_id is: 1147 | Max snap_time is: 2013-05-22 09:29:02 | snap interval is: 60ssnap_id: 19 snap_time : 2013-05-21 14:30:02 snap_id: 38 snap_time : 2013-05-21 14:49:02 snap_id: 57 snap_time : 2013-05-21 15:08:02 snap_id: 76 snap_time : 2013-05-21 15:27:02 snap_id: 95 snap_time : 2013-05-21 15:46:02
.....................................................
snap_id: 1102 snap_time : 2013-05-22 08:44:02 snap_id: 1121 snap_time : 2013-05-22 09:03:02 snap_id: 1140 snap_time : 2013-05-22 09:22:02 snap_id: 1147 snap_time : 2013-05-22 09:29:02
Enter value for start_snap:1 Start Snapshot Id Is:1
Enter value for end_snap:589 End Snapshot Id Is:589
Enter value for report_name:myawr.html
Using the report name :myawr.html
Generating the mysql report for this analysis ... Generate the mysql report Successfully.
[mysql@test2 myawr]$ ls -al total 976 drwxrwxr-x 2 mysql mysql 4096 May 22 09:30 . drwx------ 19 mysql mysql 4096 May 13 10:42 .. -rw-rw-r-- 1 mysql mysql 73074 May 22 09:30 myawr.html -rw-rw-r-- 1 mysql mysql 53621 May 11 16:23 myawrrpt.pl
Mysql WorkLoad Report
Ok,let me show some pictures which come from my test db report:
For detail report ,pls click myawr.html
We can use myawrsrpt.pl to generate mysql snapshot report. You can execute the script on MySQL database machine where store the performance data,but perl-DBD-MySQL is required.We also can execute the script in any linux machine with perl-DBD-MySQL installed.You can execute it for help Info: [root@oel58 myawr2.0]# perl myawrsrpt.pl
========================================================================================== Info : Created By noodba (www.noodba.com).
Usage : Command line options :
-h,--help Print Help Info.
-P,--port Port number to use for local mysql connection(default 3306). -u,--user user name for local mysql(default user). -p,--pswd user password for local mysql(can't be null). -lh,--lhost localhost(ip) for mysql where info is got(can't be null). -n,--rname file name for snapshot report(default "snaprpt_" + "hostid" + "_" + "snapid" + ".html"). -s,--snapid snap id(can't be null).
-I,--tid db instance register id(can't be null).
Let use to generate mysql (db2.11,instance id = 6) snapshot report:
| Welcome to use the myawrrpt tool !
| Date: 2013-06-18 | | Hostname is: db2.11 | Ip addr is: 192.168.2.11 | Port is: 3306 | Db role is: master |Server version is: 5.5.27 | Uptime is: 0y 0m 1d 1h 10mi 12sGenerating the mysql report for this analysis ... Generate the mysql report Successfully.
For detail report ,pls click myawr_snapshot.html
Any questions,pls contact me freely.EMAIL: [email protected] Q Q : 570182914 Phone: (+86)13817963180 weibo: weibo.com/noodba blog: www.noodba.com