假如你是一名 web 开发人员，如果你想调试你的应用或提升其性能的话，那你需要去参考各种日志文件。日志是开始故障排除最好的选择。就著名的 MySql 数据库服务器而言，你需要参考以下日志文件：
错误日志：它包含了服务器运行时(当然也包括服务启动和停止时)所发生的错误信息普通查询日志：这是一个记录 mysqld 在做什么(连接，断开，查询)的通用日志慢查询日志：正如其名，它记录了 "慢" 的查询 SQL 语句本文未涉及到二进制日志。二进制日志要求非常高的服务器硬件配置，而且只是在特定场景下(比如，主从复制，主从安装，某些数据的恢复操作)有用。否则的话，它就是一名实实在在的 "性能杀手"。

通过 MySql 配置启用日志

日志相关参数位于 [mysqld] 部分。
编辑 MySql 配置文件：
nano /etc/mysql/my.cnf
以上是 Debian 下的默认安装目录，其他 Linux 发布版可能不太一样，这个文件中 MySql 服务器的参数如下：
# * Logging and Replication
#
# Both location gets rotated by the cronjob.
# Be aware that this log type is a performance killer.
# As of 5.1 you can enable the log at runtime!
#general_log_file = /var/log/mysql/mysql.log
#general_log = 1
#
# Error logging goes to syslog due to /etc/mysql/conf.d/mysqld_safe_syslog.cnf.
#
# Here you can see queries with especially long duration
#log_slow_queries = /var/log/mysql/mysql-slow.log
#long_query_time = 2
#log-queries-not-using-indexes
#
# The following can be used as easy to replay backup logs or for replication.
# note: if you are setting up a replication slave, see README.Debian about
# other settings you may need to change.
#server-id = 1
#log_bin = /var/log/mysql/mysql-bin.log
expire_logs_days = 10
max_binlog_size = 100M
#binlog_do_db = include_database_name
#binlog_ignore_db = include_database_name
MySql 安装默认是不启用所有日志文件的(Windows 平台下的 error 日志除外)。Debian 安装 MySql 默认是将 error 日志发送给 syslog。

error 日志

根据 /etc/mysql/conf.d/mysqld_safe_syslog.cnf 配置，error 日志推送给 syslog：
[mysqld_safe]
syslog
这是推荐的做法。如果你由于某种原因，不想讲 error 日志推给 syslog，将 /etc/mysql/conf.d/mysqld_safe_syslog.cnf 文件中的上述行注掉，或者直接删除掉这个文件，然后在 /etc/mysql/my.cnf 中添加以下行：
[mysqld_safe]
log_error=/var/log/mysql/mysql_error.log

[mysqld]
log_error=/var/log/mysql/mysql_error.log

一般查询日志

要启用一般查询日志，将相关行取消注释(或者添加)即可：
general_log_file = /var/log/mysql/mysql.log
general_log = 1

慢查询日志

要启用慢查询日志，将相关行取消注释(或者添加)即可：
log_slow_queries = /var/log/mysql/mysql-slow.log
long_query_time = 2
log-queries-not-using-indexes

配置修改后重启 MySql 服务器

以上方法要求服务重启才能生效：
service mysql restart
或者使用 systemd：

systemctl restart mysql.service

 

运行时启用日志

MySql 5.1 之后我们可以在运行时启用或者禁用日志。
运行时启用日志，登录 MySql 客户端(mysql -u root -p)然后执行：
SET GLOBAL general_log = 'ON';
SET GLOBAL slow_query_log = 'ON';
运行时禁用日志，登录 Mysql 客户端(mysql -u root -p)后执行：
SET GLOBAL general_log = 'OFF';
SET GLOBAL slow_query_log = 'OFF';

这种方式适用于所有平台并且不需要重启服务。

 

显示日志结果

error 日志

按以上办法设置以后，你可以通过以下命令显示 error 日志：
tail -f /var/log/syslog
备注：如果你没有配置 error 日志文件，MySql 将把 error 日志保存在数据目录(通常是 /var/lib/mysql)下的一个名为 {host_name}.err 的文件中。

普通查询日志

按以上办法设置以后，你可以通过使用以下命令来显示普通日志：
tail -f /var/log/mysql/mysql.log
备注：如果你没有配置普通日志文件，MySql 将把普通日志保存在数据目录(通常是 /var/lib/mysql)下的一个名为 {host_name}.log 的文件中。

慢查询日志

按以上办法设置以后，你可以通过使用以下命令来显示慢查询日志：
tail -f /var/log/mysql/mysql-slow.log

备注：如果你没有配置慢查询日志文件，MySql 将把普通日志保存在数据目录(通常是 /var/lib/mysql)下的一个名为 {host_name}-slow.log 的文件中。

 

循环日志

别忘了滚动日志，否则的话日志文件可能会变得很庞大。
在 Debian(以及 Debian 派生系列诸如 Ubuntu 等)系统，MySql 初始安装之后，循环日志就已经使用了 logrotate：
nano /etc/logrotate.d/mysql-server
对于其他 Linux 发行版，可能需要做一些改动：

# - I put everything in one block and added sharedscripts, so that mysql gets
#   flush-logs'd only once.
#   Else the binary logs would automatically increase by n times every day.
# - The error log is obsolete, messages go to syslog now.
/var/log/mysql.log /var/log/mysql/mysql.log /var/log/mysql/mysql-slow.log {
        daily
        rotate 7
        missingok
        create 640 mysql adm
        compress
        sharedscripts
        postrotate
                test -x /usr/bin/mysqladmin || exit 0
                # If this fails, check debian.conf!
                MYADMIN="/usr/bin/mysqladmin --defaults-file=/etc/mysql/debian.cnf"
                if [ -z "`$MYADMIN ping 2>/dev/null`" ]; then
                  # Really no mysqld or rather a missing debian-sys-maint user?
                  # If this occurs and is not a error please report a bug.
                  #if ps cax | grep -q mysqld; then
                  if killall -q -s0 -umysql mysqld; then
                    exit 1
                  fi
                else
                  $MYADMIN flush-logs
                fi
        endscript
}

 

检验服务器配置

使用 show variables like '%log%'; 来检查服务器和日志文件相关的变量：
root@cosmos ~ # mysql -uroot -p
Enter password:
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 144332
Server version: 5.5.31-0+wheezy1 (Debian)

Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> show variables like '%log%';
+-----------------------------------------+--------------------------------+
| Variable_name | Value |
+-----------------------------------------+--------------------------------+
| back_log | 50 |
| binlog_cache_size | 32768 |
| binlog_direct_non_transactional_updates | OFF |
| binlog_format | STATEMENT |
| binlog_stmt_cache_size | 32768 |
| expire_logs_days | 10 |
| general_log | OFF |
| general_log_file | /var/lib/mysql/cosmos.log |
| innodb_flush_log_at_trx_commit | 1 |
| innodb_locks_unsafe_for_binlog | OFF |
| innodb_log_buffer_size | 8388608 |
| innodb_log_file_size | 5242880 |
| innodb_log_files_in_group | 2 |
| innodb_log_group_home_dir | ./ |
| innodb_mirrored_log_groups | 1 |
| log | OFF |
| log_bin | OFF |
| log_bin_trust_function_creators | OFF |
| log_error | |
| log_output | FILE |
| log_queries_not_using_indexes | OFF |
| log_slave_updates | OFF |
| log_slow_queries | OFF |
| log_warnings | 1 |
| max_binlog_cache_size | 18446744073709547520 |
| max_binlog_size | 104857600 |
| max_binlog_stmt_cache_size | 18446744073709547520 |
| max_relay_log_size | 0 |
| relay_log | |
| relay_log_index | |
| relay_log_info_file | relay-log.info |
| relay_log_purge | ON |
| relay_log_recovery | OFF |
| relay_log_space_limit | 0 |
| slow_query_log | OFF |
| slow_query_log_file | /var/lib/mysql/cosmos-slow.log |
| sql_log_bin | ON |
| sql_log_off | OFF |
| sync_binlog | 0 |
| sync_relay_log | 0 |
| sync_relay_log_info | 0 |
+-----------------------------------------+--------------------------------+
41 rows in set (0.00 sec)

服务器变量相关官方文档参考 http://dev.mysql.com/doc/refman/5.7/en/server-options.html。

 

何时启用日志

MySql 默认安装的话，所有的日志文件都不会被启用的(除了 Windows 平台上的 error 日志)。Debian 上安装默认将 error 日志发给 syslog。
实际上，在很多情况下日志文件都可以提供关键问题的解决办法：
总是启用 error 日志在这些情况下开启普通查询日志(最好在运行时)：检查你的应用是否正确处理了 MySql 数据库连接(一个常见的错误就是从一个单一脚本多次连接到 MySql)；监控来自你的应用的查询的执行情况；测试 memcached(或者类似的软件)，检查某查询是被 db 执行还是被 memcached 处理当你的应用由于某些原因造成性能下降而你想找到这些慢查询时，启用慢查询日志(MySql 最好是在短期内这样配置，比如 2-3 天)

 

示例

以下是一个 MySql 普通日志的示例：
131021 17:43:50 43 Connect root@localhost as anonymous on pnet_blog
43 Init DB pnet_blog
43 Query SELECT count(id) as total_posts FROM posts WHERE date_published is not null AND date_published 43 Query SELECT * FROM posts WHERE date_published is not null AND date_published 44 Connect root@localhost as anonymous on pnet_blog
44 Query SELECT id, title, impressions FROM tips WHERE date_published IS NOT NULL AND date_published 44 Quit
43 Quit
131021 17:44:28 45 Connect root@localhost as anonymous on pnet_blog
45 Init DB pnet_blog
45 Query SELECT * FROM posts WHERE url='how-and-when-to-enable-mysql-logs'
45 Query UPDATE posts SET impressions=impressions+1 WHERE id='41'
45 Query SELECT url, post_title FROM posts WHERE date_published IS NOT NULL AND date_published 45 Query SELECT url, post_title FROM posts WHERE date_published IS NOT NULL AND date_published > '20131020150000' ORDER BY date_published ASC LIMIT 0,1
45 Query SELECT * FROM posts WHERE date_published is not null AND date_published = '20130421144428' ORDER BY impressions DESC LIMIT 0,10
46 Connect root@localhost as anonymous on pnet_blog
46 Query SELECT id, title, impressions FROM tips WHERE date_published IS NOT NULL AND date_published 46 Quit
45 Quit