檢視和管理記錄檔
雲端基礎結構專案上的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>的值取決於專案以及環境是中繼還是生產。 例如，專案識別碼為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 Integration，您必須實作自訂解決方案/指令碼，並設定您的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檔案包含部署流程每個階段的回饋，但部署勾點建立的記錄對每個環境都是唯一的。 環境特定的部署記錄位於以下目錄中：
- 入門和Pro整合：
/var/log/deploy.log - Pro暫存：
/var/log/platform/<project-ID>_stg/deploy.log - Pro Production：
/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測試和生產環境，部署、Post部署和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存檔的記錄檔
應用程式記錄檔每天會壓縮並封存一次，並保留一年。 壓縮的記錄檔使用對應至Number of Days Ago + 1的唯一識別碼來命名。 例如，在Pro生產環境中，過去21天的PHP存取記錄會儲存起來，並命名如下：
/var/log/platform/<project-ID>/php.access.log.22.gz
存檔日誌檔一律儲存在壓縮前原始檔案所在的目錄中。
服務記錄
由於每個服務都在個別的容器中執行，因此整合環境中無法使用服務記錄檔。 雲端基礎結構上的Adobe Commerce僅提供對整合環境中Web伺服器容器的存取權。 以下服務記錄位置適用於Pro生產和中繼環境：
- 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生產和測試所需的資料
在Pro生產和測試環境中，使用與您專案整合的New Relic記錄管理，以管理雲端基礎結構專案上與您的Adobe Commerce相關的所有記錄中的彙總記錄資料。
New Relic記錄檔應用程式提供集中式記錄檔管理控制面板，用於疑難排解及監控雲端基礎結構生產和中繼環境上的Adobe Commerce。 控制面板還提供對Fastly CDN、影像最佳化和Web應用程式防火牆(WAF)服務的記錄資料存取。 請參閱New Relic服務。