Azure Database for MySQL 中的慢查询日志

备注

将要查看的是 Azure Database for MySQL 的新服务。 若要查看经典 MySQL Database for Azure 的文档,请访问此页

在 Azure Database for MySQL 中,慢查询日志可供用户使用。 不支持访问事务日志。 可以使用慢查询日志来查明性能瓶颈以进行故障排除。

有关 MySQL 慢查询日志的详细信息,请参阅 MySQL 参考手册中的慢查询日志部分

在服务器上启用查询存储时,你可能会看到记录在慢查询日志中的类似“CALL mysql.az_procedure_collect_wait_stats (900, 30);”的查询。 此行为是预期的行为,因为查询存储功能会收集有关查询的统计信息。

配置慢查询日志记录

默认情况下,慢查询日志被禁用。 若要启用它,请将 slow_query_log 设置为 ON。 可以使用 Azure 门户或 Azure CLI 启用此功能。

可以调整的其他参数包括:

  • long_query_time:如果某个查询花费的时间超过了 long_query_time(以秒为单位),则会记录该查询。 默认为 10 秒。
  • log_slow_admin_statements:如果为 ON,则会在写入到 slow_query_log 的语句中包括管理性语句,例如 ALTER_TABLE 和 ANALYZE_TABLE。
  • log_queries_not_using_indexes:确定是否将未使用索引的查询记录到 slow_query_log 中
  • log_throttle_queries_not_using_indexes:此参数限制可以写入到慢查询日志的非索引查询的数目。 当 log_queries_not_using_indexes 设置为 ON 时,此参数生效。
  • log_output:如果设置为“文件”,则允许将慢查询日志写入本地服务器存储和 Azure Monitor 诊断日志。 如果设置为“无”,则仅将慢查询日志写入 Azure Monitor 诊断日志。

重要

如果表未编制索引,则将 log_queries_not_using_indexeslog_throttle_queries_not_using_indexes 参数设置为 ON 可能会影响 MySQL 性能,因为对这些非索引表运行的所有查询都将写入到慢速查询日志。

如果计划在较长一段时间内记录慢速查询,建议将 log_output 设置为“None”。 如果设置为“File”,则这些日志将写入到本地服务器存储,并且可能会影响 MySQL 性能。

有关慢查询日志参数的完整说明,请参阅 MySQL 慢查询日志文档

访问慢查询日志

可以通过两种方法访问 Azure Database for MySQL 中的慢查询日志:本地服务器存储或 Azure Monitor 诊断日志。 此项使用 log_output 参数进行设置。

对于本地服务器存储,可以使用 Azure 门户或 Azure CLI 列出并下载慢查询日志。 在 Azure 门户中导航到你的服务器。 在“监视”标题下,选择“服务器日志”页面。 有关 Azure CLI 的详细信息,请参阅使用 Azure CLI 配置和访问慢查询日志

使用 Azure Monitor 诊断日志可以通过管道将慢查询日志传输到 Azure Monitor 日志 (Log Analytics)、Azure 存储或事件中心。 有关详细信息,请参阅下文

本地服务器存储日志保留期

将日志记录到服务器的本地存储时,日志在创建后的七天内可用。 如果可用日志的总大小超过了 7 GB,则会删除最旧的文件,直到有空间可用。 服务器日志的 7 GB 存储空间限制是免费提供的,无法扩展。

日志每 24 小时或每 7 GB 轮换一次(以先达到的条件为准)。

备注

上述日志保留期不适用于使用 Azure Monitor 诊断日志通过管道传输的日志。 可以更改日志所发送到的数据接收器(例如 Azure 存储)的保留期。

诊断日志

Azure Database for MySQL 集成了 Azure Monitor 诊断日志。 在 MySQL 服务器上启用慢查询日志后,可以选择将它们发送到 Azure Monitor 日志、事件中心或 Azure 存储。 若要详细了解如何启用诊断日志,请参阅诊断日志文档中的操作说明部分。

下表介绍了每个日志中的内容。 根据输出方法,包含的字段以及这些字段出现的顺序可能会有所不同。

属性 说明
TenantId 租户 ID
SourceSystem Azure
TimeGenerated [UTC] 记录日志时的时间戳 (UTC)
Type 日志的类型。 始终是 AzureDiagnostics
SubscriptionId 服务器所属的订阅的 GUID
ResourceGroup 服务器所属的资源组的名称
ResourceProvider 资源提供程序的名称。 始终是 MICROSOFT.DBFORMYSQL
ResourceType Servers
ResourceId 资源 URI
Resource 服务器的名称
Category MySqlSlowLogs
OperationName LogEvent
Logical_server_name_s 服务器的名称
start_time_t [UTC] 查询开始时间
query_time_s 执行查询所需的总时间(秒)
lock_time_s 锁定查询的总时间(秒)
user_host_s 用户名
rows_sent_s 发送的行数
rows_examined_s 检查的行数
last_insert_id_s last_insert_id
insert_id_s 插入 ID
sql_text_s 完整查询
server_id_s 服务器 ID
thread_id_s 线程 ID
\_ResourceId 资源 URI

备注

对于 sql_text,如果日志超过 2048 个字符,则会截断日志。

分析 Azure Monitor 日志中的日志

通过诊断日志将慢速查询日志传输到 Azure Monitor 日志后,可以进一步分析慢速查询。 下面是一些可帮助你入门的示例查询。 请确保使用你的服务器名称更新下面的内容。

  • 特定服务器上超过 10 秒的查询

    AzureDiagnostics
    | where LogicalServerName_s == '<your server name>'
    | where Category == 'MySqlSlowLogs'
    | project TimeGenerated, LogicalServerName_s, event_class_s, start_time_t , query_time_d, sql_text_s 
    | where query_time_d > 10
    
  • 列出特定服务器上最长的 5 个查询

    AzureDiagnostics
    | where LogicalServerName_s == '<your server name>'
    | where Category == 'MySqlSlowLogs'
    | project TimeGenerated, LogicalServerName_s, event_class_s, start_time_t , query_time_d, sql_text_s 
    | order by query_time_d desc
    | take 5
    
  • 按最小、最大、平均和标准偏差查询时间汇总特定服务器上的慢速查询

    AzureDiagnostics
    | where LogicalServerName_s == '<your server name>'
    | where Category == 'MySqlSlowLogs'
    | project TimeGenerated, LogicalServerName_s, event_class_s, start_time_t , query_time_d, sql_text_s 
    | summarize count(), min(query_time_d), max(query_time_d), avg(query_time_d), stdev(query_time_d), percentile(query_time_d, 95) by LogicalServerName_s
    
  • 绘制特定服务器上的慢速查询的分布图

    AzureDiagnostics
    | where LogicalServerName_s == '<your server name>'
    | where Category == 'MySqlSlowLogs'
    | project TimeGenerated, LogicalServerName_s, event_class_s, start_time_t , query_time_d, sql_text_s 
    | summarize count() by LogicalServerName_s, bin(TimeGenerated, 5m)
    | render timechart
    
  • 显示启用了诊断日志的所有 MySQL 服务器上超过 10 秒的查询

    AzureDiagnostics
    | where Category == 'MySqlSlowLogs'
    | project TimeGenerated, LogicalServerName_s, event_class_s, start_time_t , query_time_d, sql_text_s 
    | where query_time_d > 10
    

后续步骤