日志参考

    日志类型

    日志类型的详细说明请参见下表。

    表 1 日志类型

    系统日志

    openGauss运行时数据库节点以及openGauss安装部署时产生的日志统称为系统日志。如果openGauss在运行时发生故障，可以通过这些系统日志及时定位故障发生的原因，根据日志内容制定恢复openGauss的方法。

    日志文件存储路径

    数据库节点的运行日志放在“/var/log/gaussdb/用户名/pg_log”中各自对应的目录下。

    openGauss安装卸载时产生的日志放在安装卸载脚本的同级目录下。

    • 数据库节点运行日志的命名规则：

      postgresql-创建时间.log

      默认情况下，每日0点或者日志文件大于16MB或者数据库实例（数据库节点）重新启动后，会生成新的日志文件。

    • CM的运行日志的命名规则：

      • cm_agent的日志：cm_agent-创建时间.log、cm_agent-创建时间-current.log、system_call-创建时间.log、system_call-创建时间-current.log。
      • om_monitor的日志：om_monitor-创建时间.log、om_monitor-创建时间-current.log。

      其中，不带current标识符的文件是历史日志文件，带current标识符的文件是当前日志文件。最初调用进程时，进程会先创建一个带current标识符的日志文件，当该日志文件的大小超过16MB时，会将当前日志文件重命名为历史日志文件，并以当前时间生成新的当前日志文件。

    日志内容说明

    • 数据库节点每一行日志内容的默认格式：

      日期+时间+时区+用户名称+数据库名称+会话ID+日志级别+日志内容

    • cm_agent、cm_server、om_monitor每一行日志内容的默认格式：

      时间+时区+会话ID+日志内容

      SYSTEM_CALL系统调用日志记录了CM_AGENT在运行过程中调用工具命令的情况。

      key_event每一行日志内容的默认格式: 时间+线程号+线程名: 关键事件类型+仲裁对象实例ID+仲裁细节

    操作日志是指数据库管理员使用工具操作数据库时以及工具被openGauss调用时产生的日志。如果openGauss发生故障，可以通过这些日志信息跟踪用户对数据库进行了哪些操作，重现故障场景。

    日志文件存储路径

    默认在“$GAUSSLOG/bin”目录下，如果环境变量$GAUSSLOG不存在或者变量值为空，则工具日志信息不会记录到对应的工具日志文件中，日志信息只会打印到屏幕上。

    日志文件命名格式

    日志文件命名格式为：

    • 工具名-日志创建时间.log

    其中，“工具名-日志创建时间.log”是历史日志文件，“工具名-日志创建时间-current.log”是当前日志文件。

    如果日志大小超过16MB，在下一次调用该工具时，会重命名当前日志文件为历史日志文件，并以当前时间生成新的当前日志文件。

    例如将“gs_guc-2015-01-16_183728-current.log”重命名为“gs_guc-2015-01-16_183728.log”，然后重新生成“gs_guc-2015-01-17_142216-current.log”。

    维护建议

    建议定时对过期的日志文件进行转储，以避免大量日志占用太多的磁盘空间和避免重要日志丢失。

    审计日志

    审计功能开启时会不断产生大量的审计日志，占用磁盘空间。用户可以根据磁盘空间的大小设置审计日志维护策略。

    预写式日志WAL（Write Ahead Log，也称为Xlog）是指如果要修改数据文件，必须是在这些修改操作已经记录到日志文件之后才能进行修改，即在描述这些变化的日志记录刷新到永久存储器之后。在系统崩溃时，可以使用WAL日志对openGauss进行恢复操作。

    日志文件存储路径

    以一个数据库节点为例，默认在“/gaussdb/data/data_dn/pg_xlog”目录下。

    其中“/gaussdb/data/data_dn”代表openGauss节点的数据目录。

    日志文件命名格式

    日志文件以段文件的形式存储的，每个段为16MB，并分割成若干页，每页8KB。对WAL日志的命名说明如下：一个段文件的名称由24个十六进制组成，分为三个部分，每个部分由8个十六进制字符组成。第一部分表示时间线，第二部分表示日志文件标号，第三部分表示日志文件的段标号。时间线由1开始，日志文件标号和日志文件的段标号由0开始。

    例如，系统中的第一个事务日志文件是000000010000000000000000。

    日志内容说明

    WAL日志的内容取决于记录事务的类型，在系统崩溃时可以利用WAL日志进行恢复。

    默认配置下，openGauss每次启动时会先读取WAL日志进行恢复。

    维护建议

    WAL日志对数据库异常恢复有重要的作用，建议定期对WAL日志进行备份。

    性能日志

    性能日志主要关注外部资源的访问性能问题。性能日志指的是数据库系统在运行时检测物理资源的运行状态的日志，在对外部资源进行访问时的性能检测，包括磁盘等外部资源的访问检测信息。在出现性能问题时，可以借助性能日志及时的定位问题发生的原因，能极大地提升问题解决效率。

    日志文件存储路径

    数据库节点的性能日志目录在“$GAUSSLOG/gs_profile”中各自对应的目录下。

    日志文件命名格式

    数据库节点的性能日志的命名规则：

    postgresql-创建时间.prf

    默认情况下，每日0点或者日志文件大于20MB或者数据库实例（数据库节点）重新启动后，会生成新的日志文件。

    日志内容说明

    数据库节点每一行日志内容的默认格式：

    主机名称+日期+时间+实例名称+线程号+日志内容。