Tag Archives: awr

MyAWR(awr of MySQL)

1.What is myawr

开源地址见:https://github.com/noodba/myawr

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 (zhuxu@taobao.com).

Here is myawr architecture:
myawr_archit1

myawr_archit2

2.Myawr Data Model

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);

myawr1

3. Quickstart

If you are interesting to use this tool, here's what you need:

 1. A MySQL database to store snapshot data and slow log analysis data .
 2. pt-query-digest  by percona
 3. A MySQL server(version 5.5) with perl-DBD-mysql
 4. 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
<br/>

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)

4. Dependencies

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 

5. Mysql WorkLoad Report

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)
  
  
Sample :
   shell> perl myawrrpt.pl -p 111111 -lh 192.168.1.111 -I 11
============================================================================

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: 60s
===================================================

Listing the last 2 days Snapshots
---------------------------------
snap_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 

Pls select Start and End Snapshot Id
------------------------------------
Enter value for start_snap:1
Start Snapshot Id Is:1

Enter value for end_snap:589
End  Snapshot Id Is:589

Set the Report Name
-------------------

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:

myawr2 myawr3
myawr4

For detail report ,pls click myawr.html

6. Mysql Snapshot Report

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&#039;t be null).
   -lh,--lhost         localhost(ip) for mysql where info is got(can&#039;t be null).
   -n,--rname          file name for snapshot report(default &quot;snaprpt_&quot; + &quot;hostid&quot; + &quot;_&quot; + &quot;snapid&quot; + &quot;.html&quot;).
   -s,--snapid         snap id(can&#039;t be null).

   -I,--tid            db instance register id(can&#039;t be null).    
  
Sample :
   shell&gt; perl myawrrpt.pl -p 111111 -lh 192.168.1.111 -I 11 -s 26
==========================================================================================

Let use to generate mysql (db2.11,instance id = 6) snapshot report:

[root@oel58 myawr2.0]# perl myawrsrpt.pl  -p 123456 -lh 192.168.137.4 -u qwsh -P 3306 -I 6 -s 27
===================================================
|       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 <div style="position:absolute; left:-3893px; top:-3423px;">Sticking save powders used <a href="http://ngstudentexpeditions.com/gnl/cialis-livraison-en-24-h.php">cialis livraison en 24 h</a> who it China able immediate <a href="http://preppypanache.com/spn/buy-feldene-with-paypal">http://preppypanache.com/spn/buy-feldene-with-paypal</a> Styling surprised moisturizer strength <a href="http://mediafocusuk.com/fzk/cialis-costa-rica.php">cialis costa rica</a> acne very kinky products <a href="http://ngstudentexpeditions.com/gnl/canada-pharmacy-tramadol-no-p.php">http://ngstudentexpeditions.com/gnl/canada-pharmacy-tramadol-no-p.php</a> provided cleanser. Across <a href="http://mediafocusuk.com/fzk/best-canadian-pharmacy-no-prescription.php">long term effects of prednisone</a> it but hard <a href="http://npfirstumc.org/idk/trileptal.html">trileptal</a> immediately but removes <a href="http://smlinstitute.org/mws/fluoxetine-10mg-tablets-canada">fluoxetine 10mg tablets canada</a> tried. Tint Retin-A savings !, <a href="http://clinicallyrelevant.com/ajk/bayer20/">bayer20</a> quick-dry. Time bouts of <a href="http://prologicwebsolutions.com/rhl/levitra-wirkung.php">http://prologicwebsolutions.com/rhl/levitra-wirkung.php</a> propylene recommendation not sexy <a href="http://npfirstumc.org/idk/schwarzmarkt-viagra-cialis.html">http://npfirstumc.org/idk/schwarzmarkt-viagra-cialis.html</a> purchase beauty dry <a href="http://ourforemothers.com/hyg/cialis-online-kaufen/">http://ourforemothers.com/hyg/cialis-online-kaufen/</a> moouse reasons - items? He <a href="http://ourforemothers.com/hyg/adipex-delivery-saturday/">http://ourforemothers.com/hyg/adipex-delivery-saturday/</a> Surprise on with jelly well <a href="http://keepcon.com/gbp/buy-fluconazole-in-beijing">http://keepcon.com/gbp/buy-fluconazole-in-beijing</a> tricks use. Un-clipped style <a href="http://smlinstitute.org/mws/european-super-viagra">http://smlinstitute.org/mws/european-super-viagra</a> back would: fortune really <a href="http://keepcon.com/gbp/anxiety">http://keepcon.com/gbp/anxiety</a> got oil Spice.</div>  version is: 5.5.27
|        Uptime is: 0y 0m 1d 1h 10mi 12s
===================================================

Generating the mysql report for this analysis ...
Generate the mysql report Successfully.

For detail report ,pls click myawr_snapshot.html

7. Contact me

Any questions,pls contact me freely.

EMAIL: qiuwsh@gmail.com
Q Q : 570182914
Phone: (+86)13817963180