Exibir e gerenciar logs

Os logs do Adobe Commerce em projetos de infraestrutura em nuvem são úteis para solucionar problemas relacionados a criar e implantar ganchos, serviços em nuvem e o aplicativo do Adobe Commerce.

Você pode visualizar os registros do sistema de arquivos, a variável Cloud Console, e o magento-cloud CLI.

Locais de log

Os registros do sistema são armazenados nos seguintes locais:

O valor de <project-ID> depende do projeto e se o ambiente é de Preparo ou Produção. Por exemplo, com uma ID de projeto de yw1unoukjcawe, o usuário do ambiente de preparo é yw1unoukjcawe_stg e o usuário do ambiente de produção for yw1unoukjcawe.

Usando esse exemplo, o log de implantação é: /var/log/platform/yw1unoukjcawe_stg/deploy.log

Exibir logs de ambiente remoto

A maioria dos registros inclui eventos que ocorrem no ambiente remoto. Para o Pro, há vários nós e cada nó tem registros exclusivos. Use o seguinte para ver uma lista de todos os hosts:

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

Exemplo de resposta:

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

Para exibir uma lista de logs de ambientes remotos:

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

Exemplo para Pro:

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

Para ver um registro remoto:

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

Exemplo para Pro:

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

Criar e implantar logs

Depois de enviar as alterações para o ambiente, você pode revisar o registro de cada gancho na var/log/cloud.log arquivo. O log contém mensagens de início e parada para cada gancho. No exemplo a seguir, as mensagens são "Starting post-deploy." e "Post-deploy is complete."

Verifique os carimbos de data e hora nas entradas do log e localize os logs para uma implantação específica. Este é um exemplo condensado de saída de log que você pode usar para solução de problemas:

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.

Os seguintes logs têm um local comum para todos os projetos na nuvem:

Embora o cloud.log O arquivo contém feedback de cada estágio do processo de implantação. Os logs criados pelo gancho de implantação são exclusivos de cada ambiente. O log de implantação específico do ambiente está nos seguintes diretórios:

Implantar log

O log de cada implantação concatena com a variável deploy.log arquivo. O exemplo a seguir imprime o log de implantação do ambiente atual no terminal:

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

Exemplo de resposta:

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

Log de erros

Mensagens de erro e de aviso geradas durante o processo de implantação são gravadas em ambos var/log/cloud.log e a variável var/log/cloud.error.log arquivos. O arquivo de log de erros da nuvem contém apenas erros e avisos da implantação mais recente. Um arquivo vazio indica uma implantação bem-sucedida sem erros.

Você pode exibir o arquivo de log usando o SSH da CLI da nuvemou você pode usar ECE-Tools para mostrar os erros com sugestões:

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

Exemplo de resposta:

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

A maioria das mensagens de erro contém uma descrição e uma ação sugerida. Use o Referência da mensagem de erro para ECE-Tools para consultar o código de erro e obter mais orientações. Para obter mais orientações, use o Solução de problemas de implantação do Adobe Commerce.

Logs do aplicativo

Assim como os logs de implantação, os logs de aplicativos são exclusivos para cada ambiente:

Para ambientes de preparo e produção Pro, os logs de implantação, pós-implantação e cron estão disponíveis somente no primeiro nó do cluster:

Arquivos de log arquivados

Os registros de aplicativos são compactados e arquivados uma vez por dia e mantidos por um ano. Os logs compactados são nomeados usando uma ID exclusiva que corresponde à Number of Days Ago + 1. Por exemplo, em ambientes de produção Pro, um log de acesso do PHP para 21 dias no passado é armazenado e nomeado da seguinte maneira:

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

Os arquivos de log arquivados são sempre armazenados no diretório onde o arquivo original estava localizado antes da compactação.

Logs de serviço

Como cada serviço é executado em um contêiner separado, os logs do serviço não estão disponíveis no ambiente de integração. A infraestrutura do Adobe Commerce na nuvem fornece acesso ao container do servidor Web somente no ambiente de integração. Os seguintes locais de registro de serviço são para os ambientes de produção e preparo profissionais:

Os logs de serviço são arquivados e salvos por períodos diferentes, dependendo do tipo de log. Por exemplo, os registros MySQL têm o tempo de vida mais curto, removido após sete dias.

Dados de log para produção e preparo profissionais

Em ambientes de produção e preparo profissionais, use Gerenciamento de logs do New Relic integrado ao seu projeto para gerenciar dados de log agregados de todos os logs associados ao seu projeto do Adobe Commerce na nuvem.

O aplicativo de logs do New Relic fornece um painel de gerenciamento de log centralizado para solucionar problemas e monitorar o Adobe Commerce em ambientes de produção e preparo de infraestrutura em nuvem. O painel também fornece acesso aos dados de log para os serviços Fastly CDN, Image Otimization e Web application firewall (WAF). Consulte Serviços da New Relic.