查看和管理日志
云基础架构项目上的Adobe Commerce日志可用于排除与生成和部署挂接、云服务和Adobe Commerce应用程序相关的问题。
您可以从文件系统、Cloud Console和magento-cloud CLI中查看日志。
-
文件系统 -
/var/log系统目录包含所有环境的日志。var/log/目录包含特定环境专属的应用程序特定日志。 这些目录不在群集中的节点之间共享。 在Pro生产和暂存环境中，必须检查每个节点上的日志。 -
Cloud Console — 您可以在环境 消息 列表中看到生成、部署和部署后日志信息。
-
云CLI — 您可以使用
magento-cloud log命令查看本地环境日志，或使用magento-cloud ssh命令查看远程环境日志。
日志位置
系统日志存储在以下位置：
- 集成：
/var/log/<log-name>.log - Pro暂存：
/var/log/platform/<project-ID>_stg/<log-name>.log - Pro生产：
/var/log/platform/<project-ID>/<log-name>.log
<project-ID>的值取决于项目以及环境是“暂存”还是“生产”。 例如，项目ID为yw1unoukjcawe时，暂存环境用户为yw1unoukjcawe_stg，生产环境用户为yw1unoukjcawe。
使用该示例，部署日志为： /var/log/platform/yw1unoukjcawe_stg/deploy.log
查看远程环境日志
大多数日志都包含在远程环境中发生的事件。 对于Pro，有多个节点，每个节点都有唯一的日志。 使用下列内容查看所有主机的列表：
magento-cloud ssh -p <project-ID> -e <environment-ID> --all
示例响应：
1.ent-project-environment-id@ssh.region.magento.cloud
2.ent-project-environment-id@ssh.region.magento.cloud
3.ent-project-environment-id@ssh.region.magento.cloud
要查看远程环境日志的列表：
magento-cloud ssh -e <environment-ID> "ls var/log"
Pro示例：
ssh 1.ent-project-environment-id@ssh.region.magento.cloud "ls var/log | grep error"
要查看远程日志：
magento-cloud ssh -e <environment-ID> "cat var/log/cron.log"
Pro示例：
ssh 1.ent-project-environment-id@ssh.region.magento.cloud "cat var/log/cron.log"
/etc/logrotate.conf和/etc/logrotate.d/<various>。 无法在Pro Integration环境中配置日志轮换。 对于Pro集成，您必须实施自定义解决方案/脚本，并配置cron以根据需要运行脚本。生成和部署日志
将更改推送到环境后，您可以从var/log/cloud.log文件中的每个挂接查看日志记录。 日志包含每个挂接的启动和停止消息。 在以下示例中，消息为“Starting post-deploy.”和“Post-deploy is complete.”
检查日志条目上的时间戳，验证并查找特定部署的日志。 以下是可用于故障排除的日志输出的简短示例：
Re-deploying environment project-integration-ID
Executing post deploy hook for service `mymagento`
[2019-01-03 19:44:11] NOTICE: Starting post-deploy.
[2019-01-03 19:44:11] INFO: Validating configuration
[2019-01-03 19:44:11] INFO: End of validation
[2019-01-03 19:44:11] INFO: Enable cron
[2019-01-03 19:44:11] INFO: Create backup of important files.
[2019-01-03 19:44:11] INFO: Backup /app/app/etc/env.php.bak for /app/app/etc/env.php was created.
[2019-01-03 19:44:11] INFO: Backup /app/app/etc/config.php.bak for /app/app/etc/config.php was created.
[2019-01-03 19:44:11] INFO: php ./bin/magento cache:flush --ansi --no-interaction
[2019-01-03 19:44:32] INFO: Warming up failed: http://integration-id-project.us.magentosite.cloud/
[2019-01-03 19:44:32] NOTICE: Post-deploy is complete.
以下日志具有适用于所有云项目的公共位置：
- 部署日志：
var/log/cloud.log - 上次部署错误日志：
var/log/cloud.error.log - 调试日志：
var/log/debug.log - 异常日志：
var/log/exception.log - 系统日志：
var/log/system.log - 支持日志：
var/log/support_report.log - 报告：
var/report/
虽然cloud.log文件包含来自部署过程每个阶段的反馈，但部署挂接创建的日志对每个环境都是唯一的。 特定于环境的部署日志位于以下目录中：
- 入门和专业集成：
/var/log/deploy.log - 专业暂存：
/var/log/platform/<project-ID>_stg/deploy.log - 专业生产：
/var/log/platform/<project-ID>/deploy.log
部署日志
每个部署的日志都连接到特定的deploy.log文件。 以下示例在终端中打印当前环境的部署日志：
magento-cloud log -e <environment-ID> deploy
示例响应：
Reading log file projectID-branchname-ID--mymagento@ssh.zone.magento.cloud:/var/log/'deploy.log'
[2023-04-24 18:58:03.080678] Launching command 'b'php ./vendor/bin/ece-tools run scenario/deploy.xml\n''.
[2023-04-24T18:58:04.129888+00:00] INFO: Starting scenario(s): scenario/deploy.xml (magento/ece-tools version: 2002.1.14, magento/magento2-base version: 2.4.6)
[2023-04-24T18:58:04.364714+00:00] NOTICE: Starting pre-deploy.
...
错误日志
部署过程中生成的错误和警告消息将写入var/log/cloud.log和var/log/cloud.error.log文件。 云错误日志文件仅包含来自最新部署的错误和警告。 空文件表示部署成功，并且没有错误。
您可以使用Cloud CLI SSH查看日志文件，也可以使用ECE-Tools显示错误及建议：
magento-cloud ssh -e <environment-ID> "./vendor/bin/ece-tools error:show"
示例响应：
errorCode: 1001
stage: build
step: validate-config
suggestion: Please run the following commands:
1. bin/magento module:enable --all
2. git add -f app/etc/config.php
3. git commit -m 'Adding config.php'
4. git push
title: File app/etc/config.php does not exist
type: warning
---------------
errorCode: 1006
stage: build
step: validate-config
suggestion: Your application does not have the "post_deploy" hook enabled.
In order to minimize downtime, add the following to ".magento.app.yaml":
hooks:
post_deploy: |
php ./vendor/bin/ece-tools run scenario/post-deploy.xml
title: The configured state is not ideal
type: warning
大多数错误消息都包含说明和建议的操作。 使用ECE-Tools🔗的错误消息引用查找错误代码以获得进一步的指导。 有关进一步指导，请使用Adobe Commerce部署疑难解答程序。
应用程序日志
与部署日志类似，应用程序日志对于每个环境都是唯一的：
/var/log/cron.log/var/log/access.log/var/log/error.log/var/log/php.access.log/var/log/app.log对于Pro暂存和生产环境，部署、部署后和Cron日志仅在群集中的第一个节点上可用：
/var/log/platform/<project-ID>_stg/deploy.log/var/log/platform/<project-ID>/deploy.log/var/log/platform/<project-ID>_stg/post_deploy.log/var/log/platform/<project-ID>/post_deploy.log/var/log/platform/<project-ID>_stg/cron.log/var/log/platform/<project-ID>/cron.log/var/log/platform/<project-ID>_stg/access.log/var/log/platform/<project-ID>/access.log/var/log/platform/<project-ID>_stg/error.log/var/log/platform/<project-ID>/error.log/var/log/platform/<project-ID>_stg/php.access.log/var/log/platform/<project-ID>/php.access.log/var/log/platform/<project-ID>_stg/php5-fpm.log/var/log/platform/<project-ID>/php5-fpm.log归档日志文件
应用程序日志每天压缩并存档一次，并保留 30天。 压缩日志使用与Number of Days Ago + 1对应的唯一ID进行命名。 例如，在Pro生产环境中，过去21天的PHP访问日志按如下方式存储和命名：
/var/log/platform/<project-ID>/php.access.log.22.gz
存档的日志文件始终存储在压缩前原始文件所在的目录中。
服务日志
由于每个服务都在一个单独的容器中运行，因此服务日志在集成环境中不可用。 云基础架构上的Adobe Commerce仅允许访问集成环境中的Web服务器容器。 以下服务日志位置适用于专业生产和暂存环境：
- Redis日志：
/var/log/platform/<project-ID>_stg/redis-server-<project-ID>_stg.log - Elasticsearch日志：
/var/log/elasticsearch/elasticsearch.log - Java垃圾回收日志：
/var/log/elasticsearch/gc.log - 邮件日志：
/var/log/mail.log - MySQL错误日志：
/var/log/mysql/mysql-error.log - MySQL慢速日志：
/var/log/mysql/mysql-slow.log - RabbitMQ日志：
/var/log/rabbitmq/rabbit@host1.log
根据日志类型，服务日志会存档并保存不同的时间段。 例如，MySQL日志的生命周期最短–7天后删除。
记录用于专业生产和暂存的数据
在Pro生产和暂存环境中，使用与您的项目集成的New Relic日志管理来管理云基础架构项目上与Adobe Commerce关联的所有日志中的聚合日志数据。
New Relic Logs应用程序提供了一个集中式日志管理功能板，用于对云基础架构生产和暂存环境上的Adobe Commerce进行故障排除和监控。 仪表板还提供对Fastly CDN、图像优化和Web应用程序防火墙(WAF)服务的日志数据的访问。 请参阅New Relic服务。