MySQL :: MySQL 8.4 参考手册 :: 29.12.22.2 error_log 表

版本 8.4

9.0
8.0

8.0 日语

MySQL 8.4 参考手册 / ... / error_log 表

29.12.22.2 error_log 表

在 MySQL 服务器维护的日志中，有一个错误日志，它将诊断消息写入该日志（参见第 7.4.2 节，“错误日志”）。通常，服务器会将诊断信息写入服务器主机上的文件或系统日志服务。根据错误日志配置，服务器也可以将最新的错误事件写入 Performance Schema error_log 表。因此，授予 error_log 表的 SELECT 权限可以让客户端和应用程序使用 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.4.0) 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 列之外，所有列都对应于底层错误事件结构的字段，该结构在第 7.4.2.3 节，“错误事件字段” 中进行了描述。

LOGGED
事件时间戳，精确到微秒。 LOGGED 对应于错误事件的 time 字段，尽管存在某些潜在的差异
- time 值在错误日志中根据 log_timestamps 系统变量设置显示；参见早期启动日志输出格式。
- LOGGED 列使用 TIMESTAMP 数据类型存储值，对于该数据类型，值以 UTC 存储，但在检索时以当前会话时区显示；参见第 13.2.2 节，“DATE、DATETIME 和 TIMESTAMP 类型”。
要在与错误日志文件中显示的相同时区中显示 LOGGED 值，首先设置会话时区，如下所示
```
SET @@session.time_zone = @@global.log_timestamps;
```
如果 log_timestamps 值为 UTC 并且您的系统没有安装命名时区支持（参见第 7.1.15 节，“MySQL 服务器时区支持”），请像这样设置时区
```
SET @@session.time_zone = '+00:00';
```
THREAD_ID
MySQL 线程 ID。 THREAD_ID 对应于错误事件的 thread 字段。
在 Performance Schema 中，error_log 表中的 THREAD_ID 列最类似于 threads 表的 PROCESSLIST_ID 列
- 对于前台线程，THREAD_ID 和 PROCESSLIST_ID 代表一个连接标识符。这与在 INFORMATION_SCHEMA 的 PROCESSLIST 表的 ID 列中显示的值相同，也与在 SHOW PROCESSLIST 输出的 Id 列中显示的值相同，以及在该线程内通过 CONNECTION_ID() 函数返回的值相同。
- 对于后台线程，THREAD_ID 为 0，PROCESSLIST_ID 为 NULL。
除 error_log 外的许多 Performance Schema 表都有名为 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 格式的错误事件。（参见第 7.4.2.9 节，“Error Log Output Format”。）
由于错误日志可以重新配置以更改向 error_log 表提供行的日志接收器组件，并且由于不同的接收器产生不同的输出格式，因此在不同时间写入 error_log 表的行可能具有不同的 DATA 格式。

error_log 表具有以下索引

主键为 (LOGGED)
索引为 (THREAD_ID)
索引为 (PRIO)
索引为 (ERROR_CODE)
索引为 (SUBSYSTEM)

对于 error_log 表，不允许使用 TRUNCATE TABLE。

error_log 表的实现和配置

Performance Schema error_log 表由错误日志接收器组件填充，这些组件除了将格式化的错误事件写入错误日志外，还会写入该表。日志接收器对 Performance Schema 的支持分为两个部分

日志接收器可以将新错误事件写入 error_log 表，以事件发生。
日志接收器可以提供一个解析器来提取之前写入的错误消息。这使服务器实例能够读取先前实例写入错误日志文件的消息，并将它们存储在 error_log 表中。先前实例在关闭期间写入的消息可能对诊断关闭原因很有用。

当前，传统格式的 log_sink_internal 和 JSON 格式的 log_sink_json 接收器支持将新事件写入 error_log 表，并提供一个解析器来读取之前写入的错误日志文件。

log_error_services 系统变量控制要为错误日志启用哪些日志组件。它的值是一个日志过滤器和日志接收器组件的管道，当发生错误事件时，这些组件将按从左到右的顺序执行。 log_error_services 值与填充 error_log 表的方式相关，如下所示

在启动时，服务器检查 log_error_services 值，并从中选择最左边的日志接收器，以满足以下条件
- 支持 error_log 表并提供解析器的接收器。
- 如果没有，则支持 error_log 表但不提供解析器的接收器。
如果没有任何日志接收器满足这些条件，则 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`	上次写入该表的时间

PREV HOME UP NEXT