在 MySQL 服务器维护的日志中,一个是错误日志,它将诊断消息写入其中(请参阅
第 5.4.2 节,“错误日志”)。通常,服务器将诊断信息写入服务器主机上的文件或系统日志服务。从 MySQL 8.0.22 开始,根据错误日志配置,服务器还可以将最近的错误事件写入 Performance Schema
error_log
表。因此,授予
SELECT
该表的权限
error_log
使客户端和应用程序可以使用 SQL 查询访问错误日志内容,从而使 DBA 能够提供对日志的访问权限,而无需允许在服务器主机上直接访问文件系统。
该error_log
表支持基于其更结构化的列的集中查询。它还包括错误消息的全文,以支持更自由形式的分析。
表实现使用固定大小的内存环形缓冲区,并在必要时自动丢弃旧事件以为新事件腾出空间。
示例error_log
内容:
mysql> SELECT * FROM performance_schema.error_log\G
*************************** 1. row ***************************
LOGGED: 2020-08-06 09:25:00.338624
THREAD_ID: 0
PRIO: System
ERROR_CODE: MY-010116
SUBSYSTEM: Server
DATA: mysqld (mysqld 8.0.23) starting as process 96344
*************************** 2. row ***************************
LOGGED: 2020-08-06 09:25:00.363521
THREAD_ID: 1
PRIO: System
ERROR_CODE: MY-013576
SUBSYSTEM: InnoDB
DATA: InnoDB initialization has started.
...
*************************** 65. row ***************************
LOGGED: 2020-08-06 09:25:02.936146
THREAD_ID: 0
PRIO: Warning
ERROR_CODE: MY-010068
SUBSYSTEM: Server
DATA: CA certificate /var/mysql/sslinfo/cacert.pem is self signed.
...
*************************** 89. row ***************************
LOGGED: 2020-08-06 09:25:03.112801
THREAD_ID: 0
PRIO: System
ERROR_CODE: MY-013292
SUBSYSTEM: Server
DATA: Admin interface ready for connections, address: '127.0.0.1' port: 33062
该error_log
表包含以下列。如描述中所示,除了DATA
列之外的所有字段都对应于底层错误事件结构的字段,这在
第 5.4.2.3 节“错误事件字段”中进行了描述。
LOGGED
事件时间戳,精度为微秒。
LOGGED
对应于time
错误事件的领域,尽管有一定的潜在差异:time
错误日志中的值根据log_timestamps
系统变量设置显示;请参阅 早期启动日志记录输出格式。该
LOGGED
列使用TIMESTAMP
数据类型存储值,其值以 UTC 格式存储,但在当前会话时区中检索时显示;参见第 11.2.2 节,“DATE、DATETIME 和 TIMESTAMP 类型”。
要
LOGGED
以错误日志文件中显示的相同时区显示值,请首先按如下方式设置会话时区:SET @@session.time_zone = @@global.log_timestamps;
如果
log_timestamps
值是UTC
并且您的系统没有安装命名时区支持(请参阅 第 5.1.15 节,“MySQL 服务器时区支持”),请像这样设置时区:SET @@session.time_zone = '+00:00';
THREAD_ID
MySQL 线程 ID。
THREAD_ID
对应于thread
错误事件的字段。在 Performance Schema 中, 表中的
THREAD_ID
列与 表的列error_log
最相似:PROCESSLIST_ID
threads
对于前台线程,
THREAD_ID
代表PROCESSLIST_ID
一个连接标识符。这与表ID
列中 显示的值、输出列中 显示的值 以及线程内函数 返回的 值相同。INFORMATION_SCHEMA
PROCESSLIST
Id
SHOW PROCESSLIST
CONNECTION_ID()
对于后台线程,是
THREAD_ID
0 和.PROCESSLIST_ID
NULL
许多 Performance Schema 表
error_log
都有一个名为 的列THREAD_ID
,但在这些表中,该THREAD_ID
列是由 Performance Schema 内部分配的值。PRIO
事件优先级。允许的值为
System
,Error
,Warning
,Note
。该PRIO
列基于label
错误事件字段,而错误事件字段本身基于基础数字prio
字段值。ERROR_CODE
数字事件错误代码。
ERROR_CODE
对应于error_code
错误事件的字段。SUBSYSTEM
事件发生的子系统。
SUBSYSTEM
对应于subsystem
错误事件的字段。DATA
错误事件的文本表示。该值的格式取决于生成该
error_log
行的日志接收器组件生成的格式。例如,如果日志接收器是log_sink_internal
或log_sink_json
,则DATA
值分别表示传统格式或 JSON 格式的错误事件。(参见 第 5.4.2.9 节,“错误日志输出格式”。)因为可以重新配置错误日志以更改向
error_log
表提供行的日志接收器组件,并且因为不同的接收器产生不同的输出格式,所以在不同时间写入error_log
表的行可能具有不同的DATA
格式。
该error_log
表具有以下索引:
LOGGED
( ) 上的主键索引 (
THREAD_ID
)索引 (
PRIO
)索引 (
ERROR_CODE
)索引 (
SUBSYSTEM
)
TRUNCATE TABLE
不允许用于error_log
表。
Performance Schema
error_log
表由写入表的错误日志接收器组件填充,除了将格式化的错误事件写入错误日志之外。日志接收器的性能模式支持有两个部分:
目前,传统格式
log_sink_internal
和 JSON 格式的
接收器log_sink_json
支持将新事件写入error_log
表,并提供解析器来读取以前写入的错误日志文件。
系统log_error_services
变量控制启用哪些日志组件进行错误记录。它的值是日志过滤器和日志接收器组件的管道,当错误事件发生时,它们将按从左到右的顺序执行。该
log_error_services
值与填充
error_log
表有关,如下所示:
在启动时,服务器检查该
log_error_services
值并从中选择满足这些条件的最左边的日志接收器:如果没有日志接收器满足这些条件,则
error_log
表保持为空。否则,如果接收器提供解析器并且日志配置允许找到以前写入的错误日志文件,则服务器使用接收器解析器读取文件的最后部分并将其包含的旧事件写入表。接收器然后在新错误事件发生时将其写入表。在运行时,如果值发生
log_error_services
变化,服务器再次检查它,这次寻找支持该error_log
表的最左边启用的日志接收器,而不管它是否提供解析器。如果不存在这样的日志接收器,则不会将其他错误事件写入
error_log
表中。否则,新配置的接收器会在新错误事件发生时将其写入表中。
任何影响写入错误日志的输出的配置都会影响error_log
表内容。这包括诸如冗长、消息抑制和消息过滤等设置。它还适用于在启动时从以前的日志文件中读取的信息。例如,如果文件被配置为较高详细程度的当前实例读取,则在先前配置为低详细程度的服务器实例期间未写入的消息将不可用。
该error_log
表是固定大小的内存环形缓冲区的视图,其中会根据需要自动丢弃旧事件以为新事件腾出空间。如下表所示,几个状态变量提供有关正在进行的
error_log
操作的信息。
状态变量 | 意义 |
---|---|
Error_log_buffered_bytes |
表中使用的字节 |
Error_log_buffered_events |
表中存在的事件 |
Error_log_expired_events |
从表中丢弃的事件 |
Error_log_latest_write |
最后一次写入表的时间 |