Visualización y administración de registros

Los registros de Adobe Commerce en proyectos de infraestructura en la nube son útiles para solucionar problemas relacionados con generar e implementar enlaces, servicios en la nube y la aplicación de Adobe Commerce.

Puede ver los registros del sistema de archivos, Cloud Console y magento-cloud CLI.

  • Sistema de archivos: el directorio del sistema /var/log contiene registros para todos los entornos. El directorio var/log/ contiene registros específicos de la aplicación exclusivos de un entorno en particular. Estos directorios no se comparten entre los nodos de un clúster. En los entornos de ensayo y producción de Pro, debe comprobar los registros de cada nodo.

  • Cloud Console: puede ver información de registro de generación, implementación y posterior a la implementación en la lista de mensajes del entorno.

  • CLI de nube: puede ver los registros del entorno local mediante el comando magento-cloud log o los registros del entorno remoto mediante el comando magento-cloud ssh.

Ubicaciones de registro

Los registros del sistema se almacenan en las siguientes ubicaciones:

  • Integración: /var/log/<log-name>.log
  • Ensayo profesional: /var/log/platform/<project-ID>_stg/<log-name>.log
  • Producción profesional: /var/log/platform/<project-ID>/<log-name>.log

El valor de <project-ID> depende del proyecto y de si el entorno es de ensayo o de producción. Por ejemplo, con un ID de proyecto de yw1unoukjcawe, el usuario del entorno de ensayo es yw1unoukjcawe_stg y el usuario del entorno de producción es yw1unoukjcawe.

En ese ejemplo, el registro de implementación es: /var/log/platform/yw1unoukjcawe_stg/deploy.log

Ver registros de entorno remoto

La mayoría de los registros incluyen eventos que se producen en el entorno remoto. Para Pro, hay varios nodos y cada nodo tiene registros únicos. Utilice lo siguiente para ver una lista de todos los hosts:

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

Respuesta de ejemplo:

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 ver una lista de registros de entorno remoto:

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

Ejemplo de Pro:

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

Para ver un registro remoto:

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

Ejemplo de Pro:

ssh 1.ent-project-environment-id@ssh.region.magento.cloud "cat var/log/cron.log"
TIP
En los entornos de ensayo y producción de Pro, la rotación, compresión y eliminación automáticas del registro están habilitadas para los archivos de registro con un nombre de archivo fijo. Cada tipo de archivo de registro tiene un patrón giratorio y una duración. Los entornos de inicio no tienen rotación de registro. Se pueden encontrar todos los detalles sobre la rotación del registro del entorno y la duración de los registros comprimidos en: /etc/logrotate.conf y /etc/logrotate.d/<various>. La rotación de registros no se puede configurar en entornos de Pro Integration. Para la integración Pro, debe implementar una solución/script personalizado y configurar su cron para ejecutar el script según sea necesario.

Creación e implementación de registros

Después de insertar los cambios en su entorno, puede revisar el registro desde cada vínculo en el archivo var/log/cloud.log. El registro contiene mensajes de inicio y parada para cada vínculo. En el ejemplo siguiente, los mensajes son "Starting post-deploy." y "Post-deploy is complete."

Compruebe las marcas de tiempo en las entradas de registro, compruebe y busque los registros de una implementación específica. El siguiente es un ejemplo conciso de la salida de registro que puede utilizar para solucionar 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.
TIP
Al configurar su entorno de nube, puede configurar notificaciones por correo electrónico y Slack basadas en registros para acciones de compilación e implementación.

Los siguientes registros tienen una ubicación común para todos los proyectos en la nube:

  • Registro de implementación: var/log/cloud.log
  • Último registro de errores de implementación: var/log/cloud.error.log
  • Registro de depuración: var/log/debug.log
  • Registro de excepciones: var/log/exception.log
  • Registro del sistema: var/log/system.log
  • Registro de asistencia: var/log/support_report.log
  • Informes: var/report/

Aunque el archivo cloud.log contiene comentarios de cada fase del proceso de implementación, los registros creados por el vínculo de implementación son exclusivos de cada entorno. El registro de implementación específico del entorno se encuentra en los siguientes directorios:

  • Integración de Starter y Pro: /var/log/deploy.log
  • Ensayo profesional: /var/log/platform/<project-ID>_stg/deploy.log
  • Producción profesional: /var/log/platform/<project-ID>/deploy.log

Implementación del registro

El registro de cada implementación se concatena al archivo deploy.log específico. El siguiente ejemplo imprime el registro de implementación del entorno actual en el terminal:

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

Respuesta de ejemplo:

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.
...
WARNING
Si tiene problemas con archivos de contenido estático en la aplicación después de la implementación, como la falta de archivos de temas personalizados, aumente el tiempo de ejecución máximo esperado a 900 segundos o superior.

Registro de errores

Los mensajes de error y advertencia generados durante el proceso de implementación se escriben en los archivos var/log/cloud.log y var/log/cloud.error.log. El archivo de registro de errores de Cloud solo contiene errores y advertencias de la implementación más reciente. Un archivo vacío indica una implementación correcta sin errores.

Puede ver el archivo de registro mediante Cloud CLI SSH, o puede usar ECE-Tools para mostrar los errores con sugerencias:

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

Respuesta de ejemplo:

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 mayoría de los mensajes de error contienen una descripción y una acción sugerida. Use la referencia de mensaje de error para ECE-Tools para buscar el código de error y obtener más instrucciones. Para obtener más información, use el solucionador de problemas de implementación de Adobe Commerce.

Registros de aplicaciones

De forma similar a los registros de implementación, los registros de aplicaciones son únicos para cada entorno:

Archivo de registro
Integración de Starter y Pro
Descripción
Implementar registro
/var/log/deploy.log
Actividad desde el vínculo de implementación.
Registro posterior a la implementación
/var/log/post_deploy.log
Actividad desde el vínculo posterior a la implementación.
Registro Cron
/var/log/cron.log
Salida de trabajos cron.
Registro de acceso de Nginx
/var/log/access.log
Al inicio de Nginx, errores HTTP para los directorios que faltan y los tipos de archivo excluidos.
Registro de errores Nginx
/var/log/error.log
Mensajes de inicio útiles para depurar errores de configuración asociados a Nginx.
Registro de acceso de PHP
/var/log/php.access.log
Solicitudes al servicio PHP.
Registro FPM de PHP
/var/log/app.log

Para los entornos de ensayo y producción Pro, los registros de implementación, posterior a la implementación y Cron solo están disponibles en el primer nodo del clúster:

Archivo de registro
Ensayo profesional
Producción profesional
Implementar registro
Solo el primer nodo:
/var/log/platform/<project-ID>_stg/deploy.log
Solo el primer nodo:
/var/log/platform/<project-ID>/deploy.log
Registro posterior a la implementación
Solo el primer nodo:
/var/log/platform/<project-ID>_stg/post_deploy.log
Solo el primer nodo:
/var/log/platform/<project-ID>/post_deploy.log
Registro Cron
Solo el primer nodo:
/var/log/platform/<project-ID>_stg/cron.log
Solo el primer nodo:
/var/log/platform/<project-ID>/cron.log
Registro de acceso de Nginx
/var/log/platform/<project-ID>_stg/access.log
/var/log/platform/<project-ID>/access.log
Registro de errores Nginx
/var/log/platform/<project-ID>_stg/error.log
/var/log/platform/<project-ID>/error.log
Registro de acceso de PHP
/var/log/platform/<project-ID>_stg/php.access.log
/var/log/platform/<project-ID>/php.access.log
Registro FPM de PHP
/var/log/platform/<project-ID>_stg/php5-fpm.log
/var/log/platform/<project-ID>/php5-fpm.log

Archivos de registro archivados

Los registros de la aplicación se comprimen y archivan una vez al día y se conservan durante un año. Los registros comprimidos reciben un nombre mediante un identificador único que corresponde al Number of Days Ago + 1. Por ejemplo, en entornos de producción Pro, se almacena un registro de acceso PHP de 21 días en el pasado y se le asigna el siguiente nombre:

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

Los archivos de registro archivados siempre se almacenan en el directorio en el que se encontraba el archivo original antes de la compresión.

NOTE
Los archivos de registro Implementar y Posterior a la implementación no se giran ni se archivan. Todo el historial de implementación se escribe dentro de esos archivos de registro.

Registros de servicio

Dado que cada servicio se ejecuta en un contenedor independiente, los registros del servicio no están disponibles en el entorno de integración. Adobe Commerce en la infraestructura en la nube proporciona acceso al contenedor del servidor web solo en el entorno de integración. Las siguientes ubicaciones de registro de servicio son para los entornos de ensayo y producción de Pro:

  • Registro de redis: /var/log/platform/<project-ID>_stg/redis-server-<project-ID>_stg.log
  • registro de Elasticsearch: /var/log/elasticsearch/elasticsearch.log
  • Registro de recolección de elementos no utilizados de Java: /var/log/elasticsearch/gc.log
  • Registro de correo: /var/log/mail.log
  • Registro de errores de MySQL: /var/log/mysql/mysql-error.log
  • Registro lento de MySQL: /var/log/mysql/mysql-slow.log
  • Registro de RabbitMQ: /var/log/rabbitmq/rabbit@host1.log

Los registros de servicio se archivan y guardan durante diferentes períodos de tiempo, según el tipo de registro. Por ejemplo, los registros MySQL tienen la duración más corta: se eliminan después de siete días.

TIP
Las ubicaciones de los archivos de registro en la arquitectura escalada dependen del tipo de nodo. Consulte Ubicaciones de registro en el tema Arquitectura a escala.

Datos de registro para Producción y ensayo profesionales

En entornos Pro Production y Staging, use la administración de registros de New Relic integrada con su proyecto para administrar los datos de registro agregados de todos los registros asociados con su proyecto Adobe Commerce en la nube.

La aplicación New Relic Logs proporciona un panel de administración de registros centralizado para solucionar problemas y supervisar Adobe Commerce en entornos de ensayo y producción de infraestructuras en la nube. El tablero también proporciona acceso a los datos de registro para los servicios Fastly CDN, Optimización de imágenes y cortafuegos de aplicaciones web (WAF). Consulte Servicios de New Relic.

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26