Visualizzare e gestire i registri

I registri per i progetti di infrastruttura cloud di Adobe Commerce sono utili per la risoluzione dei problemi relativi agli hook di compilazione e distribuzione, ai servizi cloud e all'applicazione Adobe Commerce.

È possibile visualizzare i registri dal file system, da Cloud Console e dalla CLI di magento-cloud.

Posizioni del registro

I registri di sistema sono archiviati nei seguenti percorsi:

Il valore di <project-ID> dipende dal progetto e dal fatto che l'ambiente sia di staging o produzione. Ad esempio, con un ID progetto di yw1unoukjcawe, l'utente dell'ambiente di staging è yw1unoukjcawe_stg e l'utente dell'ambiente di produzione è yw1unoukjcawe.

Utilizzando l'esempio, il registro di distribuzione è: /var/log/platform/yw1unoukjcawe_stg/deploy.log

Visualizzare i registri dell’ambiente remoto

La maggior parte dei registri include eventi che si verificano nell’ambiente remoto. Per Pro, ci sono più nodi e ogni nodo ha registri univoci. Utilizzare quanto segue per visualizzare un elenco di tutti gli host:

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

Risposta di esempio:

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

Per visualizzare un elenco dei registri dell'ambiente remoto:

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

Esempio per Pro:

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

Per visualizzare un registro remoto:

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

Esempio per Pro:

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

Creare e distribuire i registri

Dopo aver inviato le modifiche all'ambiente, è possibile rivedere la registrazione da ogni hook nel file var/log/cloud.log. Il registro contiene messaggi di avvio e di arresto per ogni hook. Nell'esempio seguente, i messaggi sono "Starting post-deploy." e "Post-deploy is complete."

Controlla i timestamp sulle voci di registro, verifica e individua i registri per una distribuzione specifica. Di seguito è riportato un esempio sintetico di output di registro che è possibile utilizzare per la risoluzione dei problemi:

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.

I seguenti registri hanno una posizione comune per tutti i progetti Cloud:

Sebbene il file cloud.log contenga feedback da ogni fase del processo di distribuzione, i registri creati dall'hook di distribuzione sono univoci per ogni ambiente. Il registro di distribuzione specifico dell’ambiente si trova nelle seguenti directory:

Distribuisci registro

Il registro di ogni distribuzione si concatena al file deploy.log specifico. L’esempio seguente stampa il registro di distribuzione dell’ambiente corrente nel terminale:

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

Risposta di esempio:

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

Registro errori

I messaggi di errore e di avviso generati durante il processo di distribuzione vengono scritti sia nei file var/log/cloud.log che nei file var/log/cloud.error.log. Il file di registro degli errori di Cloud contiene solo errori e avvisi dell’ultima distribuzione. Un file vuoto indica una distribuzione riuscita senza errori.

È possibile visualizzare il file di registro utilizzando Cloud CLI SSH oppure utilizzare ECE-Tools per visualizzare gli errori con suggerimenti:

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

Risposta di esempio:

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

La maggior parte dei messaggi di errore contiene una descrizione e un’azione suggerita. Utilizza il Riferimento messaggio di errore per ECE-Tools per cercare il codice di errore per ulteriori indicazioni. Per ulteriori informazioni, utilizzare Risoluzione dei problemi di distribuzione di Adobe Commerce.

Registri applicazioni

Analogamente ai registri di distribuzione, i registri dell’applicazione sono univoci per ciascun ambiente:

Per gli ambienti di staging e produzione Pro, i registri di distribuzione, post-distribuzione e Cron sono disponibili solo sul primo nodo del cluster:

File di registro archiviati

I registri delle applicazioni vengono compressi e archiviati una volta al giorno e conservati per 30 giorni. I registri compressi sono denominati utilizzando un ID univoco che corrisponde a Number of Days Ago + 1. Ad esempio, negli ambienti di produzione Pro viene memorizzato un registro di accesso PHP per 21 giorni nel passato, denominato come segue:

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

I file di registro archiviati vengono sempre memorizzati nella directory in cui si trovava il file originale prima della compressione.

Registri del servizio

Poiché ogni servizio viene eseguito in un contenitore separato, i registri del servizio non sono disponibili nell’ambiente di integrazione. Adobe Commerce su infrastruttura cloud fornisce l’accesso al contenitore del server web solo nell’ambiente di integrazione. Le seguenti posizioni dei log di servizio sono per gli ambienti Pro Production e Staging:

I registri del servizio vengono archiviati e salvati per diversi periodi di tempo, a seconda del tipo di registro. Ad esempio, i registri MySQL hanno una durata più breve, che viene rimossa dopo sette giorni.

Registra i dati per Pro Production e Staging

Negli ambienti di produzione e staging Pro, utilizza la gestione dei registri di New Relic integrata nel progetto per gestire i dati di registro aggregati da tutti i registri associati al progetto di infrastruttura cloud Adobe Commerce.

L’applicazione New Relic Logs fornisce un dashboard di gestione dei registri centralizzato per la risoluzione dei problemi e il monitoraggio di Adobe Commerce negli ambienti di produzione e staging dell’infrastruttura cloud. La dashboard consente inoltre di accedere ai dati di registro per i servizi Fastly CDN, Image Optimization e Web Application Firewall (WAF). Consulta Servizi New Relic.