YashanDB日志管理

本文内容来自YashanDB官网，原文内容请见 https://doc.yashandb.com/yashandb/23.3/zh/%E6%95%B0%E6%8D%AE%...

日志管理章节所述范围为运维相关的日志管理，不包括与数据相关的redo/归档日志，对于redo/归档日志的管理将在文件管理章节描述。

日志分类

---

YashanDB的运维类日志分类如下：

• 运行日志run log：运行日志记录了数据库各服务运行产生的轨迹信息、调试信息、状态变迁、未产生影响的潜在问题和直接的错误信息。
• 告警日志alert log：当数据库发生死锁、表空间满、网络断连、坏块等错误时，会处于“带病运行”的状态，运维人员应该及时知道这些信息并作出处理。通过数据库在告警日志中发出告警（上报告警事件），运维人员定时检查告警日志，可以防患于未然，时刻了解和维护系统的运行状况。YashanDB包含的所有告警事件信息见参考手册告警事件。
• 监听日志listen log：当数据库遭遇连接风暴等问题时，需要查看连接来源定位原因，监听日志会向运维人员提供连接状态和频率等信息。
• 慢日志slow log：慢日志全称为慢查询日志（Slow Query Log），主要用于记录在数据库中执行时间超过指定时间的SQL语句，可选择输出到日志文件或系统表。通过慢查询日志，可以查找出哪些语句的执行效率低，以便进行优化。
• 代理程序日志yex\_server.log：代理程序日志记录了外置UDF代理程序服务运行产生的轨迹信息、调试信息、状态变迁、未产生影响的潜在问题和直接的错误信息。

下表列示了上述日志对应的文件信息：

日志文件	日志内容	说明
$YASDB\_HOME/log/集群名/node-nodeid/run/run.log	运行日志	1.安装时默认按此路径及名称创建

2.可通过RUN\_LOG\_FILE\_PATH参数修改文件路径，若路径不存在则会自动创建，需保证用户对该路径拥有相应权限
3.文件名称不可修改 |
| $YASDB\_DATA/log/alert/alert.log | 告警日志 | 1.安装时默认按此路径及名称创建
2.文件路径不可修改
3.文件名称不可修改 |
| $YASDB\_DATA/log/listener/listener.log | 监听日志 | 1.安装时默认按此路径及名称创建
2.文件路径不可修改
3.文件名称不可修改 |
| $YASDB\_HOME/log/集群名/node-nodeid/slow/slow.log | 慢查询日志 | 1.安装时默认按此路径及名称创建
2.可通过SLOW\_LOG\_FILE\_PATH参数修改文件路径，若路径不存在则会自动创建，需保证用户对该路径拥有相应权限
3.可通过SLOW\_LOG\_FILE\_NAME参数修改文件名称
4.输出方式为FILE时记入此文件，为TABLE时记入系统表 |
| $YASDB\_DATA/log/external/server/yex\_server.log | 代理程序日志 | 1.安装时默认按此路径及名称创建
2.文件路径不可修改
3.文件名称不可修改 |

日志归档

---

下表列示了YashanDB支持日志归档的情况：

日志类型	支持情况
运行日志	支持
告警日志	不支持
监听日志	不支持
慢日志	不支持
代理程序日志	支持

Caution：

对于不支持归档的日志，数据库管理员应该对其设置定期清理策略，避免占满磁盘空间。

运行日志归档

当运行日志文件达到RUN\_LOG\_FILE\_SIZE（默认为20M）后，将进行归档并创建一个新的日志文件，归档的日志文件命名为原日志文件名+时间后缀，如：run/run-20211213151402.log。

代理程序日志归档

当代理程序日志文件达到16M后，将进行归档并创建一个新的日志文件，归档的日志文件命名为原日志文件名+时间后缀，如：external/server/yex\_server20211213151402.log。

日志格式

---

运行日志文件内容格式

格式为：日期+时间+[级别]+[模块]+日志信息。如下：

2021-12-13 14:51:23.342 [INFO] [TABLESPACE] succeed to create tablespace SYSTEM
2021-12-13 14:53:18.559 [WARN] [CKPT] checkpoint not complete
2021-12-13 14:53:22.483 [DEBUG] [HA] send redo from point 0-5-12840-18360, size 278528, standby 1, next send point 0-5-12908-18373

Copied!

日志级别

YashanDB运行日志支持不同级别的日志管理，并根据配置打印不同级别的日志：

级别	描述
OFF	关闭日志
FATAL	致命错误产生的日志
ERROR	一般错误产生的日志
WARN	告警类错误产生的日志
INFO	正常运行日志（默认日志级别）
DEBUG	调试日志级别
TRACE	追踪日志
ALL	所有日志

从上到下，日志等级依次增高，高日志级别包含低日志级别。

告警日志文件内容格式

格式为：TimeStamp | Session ID | Event Name | Object | Action | content |Event Escription。各字段说明见下表：

字段	类型	说明
TimeStamp	timestamp	产生告警的时间
Session ID	uint16	产生告警的会话ID
Event Name	text	告警类型名称
Object	uint16	产生告警的对象ID

* Object和Event Name一起构成告警的唯一标识符
* 有些告警并不需要Object信息，则该值为0 |
| Action | int | 告警状态：
* 0：产生告警
* 1：告警消除 |
| Content | text | 对该告警的其他附带信息 |
| Description | text | 供用户进一步了解告警的详细信息 |

监听日志文件内容格式

日志格式示例如下：

2023-08-02 09:47:26.143 protocal = TCP  ip = fc00:7::126 port = 14526 user = SYS status = SUCCESS
2023-08-02 09:47:26.151 protocal = TCP  ip = fc00:7::126 port = 14528 user = SYS status = SUCCESS
2023-08-02 09:50:42.005 protocal = TCP  ip = fc00:7::126 port = 14650 user = SYS status = SUCCESS
2023-08-02 09:51:34.354 protocal = TCP  ip = fc00:7::126 port = 44058 user = REGRESS status = ERROR
2023-08-02 09:54:32.526 protocal = TCP  ip = fc00:7::126 port = 14656 user = SYS status = SUCCESS
2023-08-02 09:56:32.126 protocal = IPC  user = SYS status = SUCCESS

Copied!

格式为：

TimeStamp | Protocal | Ip | Port | User | Status

字段	说明
TimeStamp	产生监听记录的时间
Protocal	链路类型

* TCP：TCP连接
* IPC： IPC连接 |
| Ip | 客户端IP |
| Port | 客户端PORT |
| User | 连接用户 |
| Status | 连接状态
* SUCCESS：连接成功
* ERROR：连接失败 |

慢日志内容格式

慢日志文件格式

示例如下：

# TIME: 2022-11-18 20:51:30.374
# USER_HOST: [email protected]
# DB_NAME: test_base1
# COST_EXECUTE_TIME: 0.000119
# COST_OPTIMIZE_TIME: 0.000040
# ROWS_SENT: 1
# SQL_ID: 3jd5aq4g9t7gf
SQL: select * from v$parameter where name = 'SLOW_LOG_SQL_MAX_LEN'

Copied!

格式为：

字段	说明
TIME	打印该条慢SQL信息的时间
USER\_HOST	执行SQL时的连接信息
DB\_NAME	使用的数据库名称
COST\_EXECUTE\_TIME	SQL执行花费的时间，单位为秒
COST\_OPTIMIZE\_TIME	SQL优化计划阶段花费的时间，单位为秒
ROWS\_SENT	返回的行数
SQL\_ID	SQL ID

慢日志系统表格式

慢日志系统表名为SLOW\_LOG$，表结构定义如下：

列名	说明
DATABASE\_NAME	数据库名称
USER\_NAME	用户名
START\_TIME	日志记录时的时间，非执行开始时间
USER\_HOST	连接IP
QUERY\_TIME	执行时间
ROWS\_SENT	查询返回的行数
SQL\_ID	SQL的ID值
SQL\_TEXT	SQL语句，超过2000会截断