文档Commerce配置指南

[仅限PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}

启用日志记录

Last update: Wed Nov 12 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 有经验的
  • 管理员
  • 开发人员
WARNING
所有Magento CLI命令都必须由文件系统所有者运行。

调试日志记录

默认情况下，Commerce在默认或开发模式下写入调试日志(<install_directory>/var/log/debug.log)，在生产模式下则不写入。 使用bin/magento setup:config:set --enable-debug-logging命令更改默认值。

INFO
自Commerce 2.3.1起，您无法再使用bin/magento config:set dev/debug/debug_logging命令在当前模式下启用或禁用调试日志记录。

启用调试日志记录

  1. 使用setup:config:set命令在当前模式下启用调试日志记录。

    code language-bash 
    bin/magento setup:config:set --enable-debug-logging=true

  2. 刷新缓存。

    code language-bash 
    bin/magento cache:flush

禁用调试日志记录

  1. 使用setup:config:set命令禁用当前模式的调试日志记录。

    code language-bash 
    bin/magento setup:config:set --enable-debug-logging=false

  2. 刷新缓存。

    code language-bash 
    bin/magento cache:flush

数据库日志记录

默认情况下，Commerce将数据库活动日志写入<install-dir>/var/debug/db.log文件。

查询日志记录存储位置

启用数据库日志记录后，Commerce会将查询日志存储在以下位置：

  • 查询日志文件： <install-directory>/var/debug/db.log
  • 日志目录： <install-directory>/var/debug/

查询日志包含：

  • 应用程序执行的SQL查询
  • 查询执行时间
  • 查询参数和绑定
  • 数据库连接信息
NOTE
在高流量环境中，查询日志文件可能会快速增大。 监视磁盘空间，并考虑实施日志轮换或定期清理查询日志文件。

启用数据库日志记录

  1. 使用dev:query-log命令启用或禁用数据库日志记录。

    code language-bash 
    bin/magento dev:query-log:enable
    code language-bash 
    bin/magento dev:query-log:disable

  2. 刷新缓存。

    code language-bash 
    bin/magento cache:flush

查看查询日志

您可以使用标准文件查看命令查看查询日志：

# View the entire query log
cat var/debug/db.log

# View the last 100 lines of the query log
tail -n 100 var/debug/db.log

# Monitor the query log in real-time
tail -f var/debug/db.log

# Search for specific queries
grep "SELECT" var/debug/db.log

Cron日志记录

在版本2.3.1中，Commerce现在创建单独的cron日志。
Commerce最近使cron日志记录更详细，这提供了更多信息，但显着延长了system.log。
将cron信息移动到专用日志可使两个日志更易于读取。

默认情况下，Commerce将cron信息写入<install-directory>/var/log/cron.log文件。

Syslog日志记录

默认情况下，Commerce将​ syslog ​日志写入操作系统syslog文件。
从Commerce 2.3.1开始，您必须使用magento命令启用或禁用syslog。
管理员中的设置已被删除。

启用syslog日志记录

默认情况下已禁用登录到syslog。

  1. 使用setup:config:set命令将dev/syslog/syslog_logging数据库值更改为true。

    code language-bash 
    bin/magento setup:config:set --enable-syslog-logging=true

  2. 刷新缓存。

    code language-bash 
    bin/magento cache:flush

禁用syslog日志记录

  1. 使用setup:config:set命令将dev/syslog/syslog_logging数据库值更改为false。

    code language-bash 
    bin/magento setup:config:set --enable-syslog-logging=false

  2. 刷新缓存。

    code language-bash 
    bin/magento cache:flush
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c