Anzeigen und Verwalten von Protokollen

Protokolle für Adobe Commerce in Cloud-Infrastrukturprojekten sind nützlich, um Probleme im Zusammenhang mit Build- und Bereitstellungs-), Cloud Services und der Adobe Commerce-Anwendung zu beheben.

Sie können die Protokolle aus dem Dateisystem, dem Cloud Console und der magento-cloud CLI anzeigen.

Speicherorte protokollieren

Systemprotokolle werden an den folgenden Speicherorten gespeichert:

Der Wert von <project-ID> hängt vom Projekt ab und davon, ob es sich um eine Staging- oder eine Produktionsumgebung handelt. Bei einer Projekt-ID von yw1unoukjcawe wird beispielsweise der Benutzer der Staging-Umgebung yw1unoukjcawe_stg und der Benutzer der Produktionsumgebung yw1unoukjcawe.

Unter Verwendung dieses Beispiels lautet das Bereitstellungsprotokoll: /var/log/platform/yw1unoukjcawe_stg/deploy.log

Remote-Umgebungsprotokolle anzeigen

Die meisten Protokolle enthalten Ereignisse, die in der Remote-Umgebung auftreten. Für Pro gibt es mehrere Knoten und jeder Knoten verfügt über eindeutige Protokolle. Verwenden Sie Folgendes, um eine Liste aller Hosts anzuzeigen:

magento-cloud ssh -p <project-ID> -e <environment-ID> --all

Beispielantwort:

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

So zeigen Sie eine Liste der Remote-Umgebungsprotokolle an:

magento-cloud ssh -e <environment-ID> "ls var/log"

Beispiel für Pro:

ssh 1.ent-project-environment-id@ssh.region.magento.cloud "ls var/log | grep error"

So zeigen Sie ein Remote-Protokoll:

magento-cloud ssh -e <environment-ID> "cat var/log/cron.log"

Beispiel für Pro:

ssh 1.ent-project-environment-id@ssh.region.magento.cloud "cat var/log/cron.log"

Erstellen und Bereitstellen von Protokollen

Nachdem Sie Änderungen an Ihre Umgebung gepusht haben, können Sie die Protokollierung von jedem Hook in der var/log/cloud.log-Datei überprüfen. Das Protokoll enthält Start- und Stopp-Meldungen für jeden Hook. Im folgenden Beispiel lauten die Nachrichten "Starting post-deploy." und "Post-deploy is complete."

Überprüfen Sie die Zeitstempel in Protokolleinträgen, überprüfen Sie die Protokolle für eine bestimmte Bereitstellung und suchen Sie sie. Im Folgenden finden Sie ein zusammengefasstes Beispiel für die Protokollausgabe, die Sie zur Fehlerbehebung verwenden können:

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.

Die folgenden Protokolle haben einen gemeinsamen Speicherort für alle Cloud-Projekte:

Obwohl die cloud.log-Datei Feedback aus jeder Phase des Bereitstellungsprozesses enthält, sind die vom Bereitstellungs-Hook erstellten Protokolle für jede Umgebung eindeutig. Das umgebungsspezifische Bereitstellungsprotokoll befindet sich in den folgenden Verzeichnissen:

Protokoll bereitstellen

Das Protokoll für jede Bereitstellung wird mit der spezifischen deploy.log verkettet. Im folgenden Beispiel wird das Bereitstellungsprotokoll der aktuellen Umgebung im Terminal gedruckt:

magento-cloud log -e <environment-ID> deploy

Beispielantwort:

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.
...

Fehlerprotokoll

Während des Bereitstellungsprozesses generierte Fehler- und Warnmeldungen werden sowohl in die var/log/cloud.log- als auch in die var/log/cloud.error.log geschrieben. Die Cloud-Fehlerprotokolldatei enthält nur Fehler und Warnungen aus der neuesten Bereitstellung. Eine leere Datei bedeutet, dass die Bereitstellung ohne Fehler erfolgreich war.

Sie können die Protokolldatei mit der Cloud-CLI SSH anzeigen oder ECE-Tools verwenden, um die Fehler mit Vorschlägen anzuzeigen:

magento-cloud ssh -e <environment-ID> "./vendor/bin/ece-tools error:show"

Beispielantwort:

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

Die meisten Fehlermeldungen enthalten eine Beschreibung und empfohlene Maßnahmen. Verwenden Sie die Fehlermeldungsreferenz für ECE-Tools, um den Fehlercode für weitere Anleitungen zu suchen. Weitere Anleitungen finden Sie in der Fehlerbehebung bei der Bereitstellung von Adobe Commerce.

Anwendungsprotokolle

Ähnlich wie bei der Bereitstellung von Protokollen sind auch Anwendungsprotokolle für jede Umgebung eindeutig:

Bei Pro-Staging- und Produktionsumgebungen sind die Protokolle „Bereitstellen“, „Nach der Bereitstellung“ und „Cron“ nur auf dem ersten Knoten im Cluster verfügbar:

Archivierte Protokolldateien

Die Anwendungsprotokolle werden einmal täglich komprimiert und archiviert und 30 Tage aufbewahrt. Die komprimierten Protokolle werden mit einer eindeutigen ID benannt, die dem -Number of Days Ago + 1 entspricht. In Pro-Produktionsumgebungen wird beispielsweise ein PHP-Zugriffsprotokoll für 21 Tage gespeichert und wie folgt benannt:

/var/log/platform/<project-ID>/php.access.log.22.gz

Die archivierten Protokolldateien werden immer in dem Verzeichnis gespeichert, in dem sich die Originaldatei vor der Komprimierung befand.

Service-Protokolle

Da jeder Service in einem separaten Container ausgeführt wird, sind die Service-Protokolle nicht in der Integrationsumgebung verfügbar. Adobe Commerce in der Cloud-Infrastruktur bietet nur in der Integrationsumgebung Zugriff auf den Webserver-Container. Die folgenden Speicherorte für Service-Protokolle sind für die Pro-Produktions- und Staging-Umgebungen vorgesehen:

Service-Protokolle werden je nach Protokolltyp für unterschiedliche Zeiträume archiviert und gespeichert. Beispielsweise haben MySQL-Protokolle die kürzeste Lebensdauer - sie werden nach sieben Tagen entfernt.

Protokolldaten für Pro Produktion und Staging

Verwenden Sie in Pro-Produktions- und Staging-Umgebungen das in Ihr Projekt 🔗 New Relic-Protokollmanagement, um aggregierte Protokolldaten aus allen Protokollen zu verwalten, die mit Ihrem Adobe Commerce in Cloud-Infrastrukturprojekt verknüpft sind.

Die Anwendung "New Relic-Protokolle“ bietet ein zentralisiertes Protokollmanagement-Dashboard zur Fehlerbehebung und Überwachung von Adobe Commerce in Cloud-Produktions- und Staging-Umgebungen. Das Dashboard bietet außerdem Zugriff auf Protokolldaten für Fastly CDN, Bildoptimierung und WAF-Services (Web Application Firewall). Siehe New Relic-Services.