Visa och hantera loggar

Loggar för Adobe Commerce i molninfrastrukturprojekt är användbara för felsökning av problem som rör bygg och distribuera hooks, molntjänster och Adobe Commerce-programmet.

Du kan visa loggarna från filsystemet, Cloud Console och magento-cloud CLI.

Loggplatser

Systemloggarna lagras på följande platser:

Värdet för <project-ID> beror på projektet och om miljön är Förproduktion eller Produktion. Med ett projekt-ID på yw1unoukjcawe är till exempel användaren i mellanlagringsmiljön yw1unoukjcawe_stg och användaren i produktionsmiljön är yw1unoukjcawe.

Med det exemplet är distributionsloggen: /var/log/platform/yw1unoukjcawe_stg/deploy.log

Visa fjärrmiljöloggar

De flesta loggar innehåller händelser som inträffar i fjärrmiljön. För Pro finns det flera noder och varje nod har unika loggar. Använd följande för att se en lista över alla värdar:

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

Exempelsvar:

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

Så här visar du en lista över fjärrmiljöloggar:

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

Exempel för Pro:

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

Så här visar du en fjärrlogg:

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

Exempel för Pro:

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

Skapa och distribuera loggar

När du har gjort ändringar i din miljö kan du granska loggningen från varje krok i filen var/log/cloud.log. Loggen innehåller start- och stoppmeddelanden för varje krok. I följande exempel är meddelandena Starting post-deploy. och Post-deploy is complete.

Kontrollera tidsstämplarna för loggposterna, verifiera och hitta loggarna för en specifik distribution. Följande är ett komprimerat exempel på loggutdata som du kan använda för felsökning:

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.

Följande loggar har en gemensam plats för alla Cloud-projekt:

Även om filen cloud.log innehåller feedback från varje steg i distributionsprocessen, är loggar som skapas av distributionskroken unika för varje miljö. Den miljöspecifika distributionsloggen finns i följande kataloger:

Distribuera logg

Loggen för varje distribution sammanfogas med den specifika deploy.log-filen. Följande exempel skriver ut distributionsloggen för den aktuella miljön i terminalen:

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

Exempelsvar:

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

Fellogg

Fel- och varningsmeddelanden som genereras under distributionsprocessen skrivs till både var/log/cloud.log- och var/log/cloud.error.log-filerna. Felloggfilen i molnet innehåller endast fel och varningar från den senaste distributionen. En tom fil visar att distributionen lyckades utan fel.

Du kan visa loggfilen med Cloud CLI SSH eller använda ECE-Tools för att visa felen med förslag:

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

Exempelsvar:

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

De flesta felmeddelanden innehåller en beskrivning och förslag på åtgärd. Använd felmeddelandereferensen för ECE-verktyg för att leta upp felkoden för ytterligare vägledning. Använd felsökaren för Adobe Commerce-distribution om du vill ha mer information.

Programloggar

På samma sätt som för distributionsloggar är programloggar unika för varje miljö:

I Pro Staging- och Production-miljöer är loggarna Deploy, Post-deploy och Cron bara tillgängliga på den första noden i klustret:

Arkiverade loggfiler

Programloggarna komprimeras och arkiveras en gång om dagen och sparas i ett år. De komprimerade loggarna namnges med ett unikt ID som motsvarar Number of Days Ago + 1. I Pro-produktionsmiljöer har till exempel en PHP-åtkomstlogg för 21 dagar tidigare lagrats och fått följande namn:

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

De arkiverade loggfilerna sparas alltid i den katalog där originalfilen fanns före komprimeringen.

Tjänstloggar

Eftersom varje tjänst körs i en separat behållare är inte tjänstloggarna tillgängliga i integreringsmiljön. Adobe Commerce i molninfrastruktur ger åtkomst till webbserverbehållaren endast i integreringsmiljön. Följande loggplatser är för Pro Production och Staging-miljöerna:

Tjänstloggarna arkiveras och sparas under olika tidsperioder, beroende på loggtyp. MySQL-loggar har till exempel den kortaste livstiden, som har tagits bort efter sju dagar.

Loggdata för Pro Production och Staging

I Pro Production- och Staging-miljöer använder du New Relic logghantering som är integrerad med ditt projekt för att hantera aggregerade loggdata från alla loggar som är kopplade till ditt Adobe Commerce i molninfrastruktursprojekt.

New Relic Logs-programmet har en central kontrollpanel för logghantering för felsökning och övervakning av Adobe Commerce i molninfrastrukturproduktions- och mellanlagringsmiljöer. Kontrollpanelen ger även åtkomst till loggdata för tjänsterna Snabbt CDN, Bildoptimering och Brandvägg för webbprogram (WAF). Se New Relic-tjänster.