로그 보기 및 관리

클라우드 인프라 프로젝트의 Adobe Commerce 로그는 다음과 관련된 문제를 해결하는 데 유용합니다. 후크 빌드 및 배포, cloud services 및 Adobe Commerce 애플리케이션.

파일 시스템에서 로그를 볼 수 있습니다. Cloud Console및 magento-cloud CLI.

  • 파일 시스템- /var/log 시스템 디렉토리에는 모든 환경에 대한 로그가 포함되어 있습니다. 다음 var/log/ 디렉토리에는 특정 환경에 고유한 앱별 로그가 포함되어 있습니다. 이러한 디렉토리는 클러스터의 노드 간에 공유되지 않습니다. Pro 프로덕션 및 스테이징 환경에서는 각 노드의 로그를 확인해야 합니다.

  • Cloud Console—환경에서 로그 정보 작성, 배포 및 배포 후 확인 가능 메시지 목록을 표시합니다.

  • Cloud CLI- 다음을 사용하여 로컬 환경 로그를 볼 수 있습니다 magento-cloud log 명령 또는 원격 환경 로그 magento-cloud ssh 명령입니다.

로그 위치

시스템 로그는 다음 위치에 저장됩니다.

  • 통합: /var/log/<log-name>.log
  • Pro 스테이징: /var/log/platform/<project-ID>_stg/<log-name>.log
  • 프로프로덕션: /var/log/platform/<project-ID>/<log-name>.log

값: <project-ID> 프로젝트 및 환경이 스테이징인지 또는 프로덕션인지에 따라 다릅니다. 예를 들어 의 프로젝트 ID를 사용하는 경우 yw1unoukjcawe, 스테이징 환경 사용자는 yw1unoukjcawe_stg 및 프로덕션 환경 사용자는 yw1unoukjcawe.

이 예에서 배포 로그는 다음과 같습니다. /var/log/platform/yw1unoukjcawe_stg/deploy.log

원격 환경 로그 보기

대부분의 로그에는 원격 환경에서 발생하는 이벤트가 포함됩니다. Pro의 경우 여러 노드가 있고 각 노드에는 고유한 로그가 있습니다. 모든 호스트 목록을 보려면 다음을 사용하십시오.

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

샘플 응답:

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

원격 환경 로그 목록을 보려면:

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

Pro의 경우:

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

원격 로그를 보려면:

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

Pro의 경우:

ssh 1.ent-project-environment-id@ssh.region.magento.cloud "cat var/log/cron.log"
TIP
Pro 스태이징 및 프로덕션 환경의 경우, 고정된 파일 이름의 로그 파일에 대해 자동 로그 회전, 압축 및 제거를 사용할 수 있습니다. 각 로그 파일 유형에는 회전 패턴과 수명이 있습니다. 스타터 환경에는 로그 회전이 없습니다. 압축된 로그의 환경 로그 회전 및 수명에 대한 전체 세부 정보는 다음에서 확인할 수 있습니다. /etc/logrotate.conf/etc/logrotate.d/<various>. Pro 통합 환경에서는 로그 순환을 구성할 수 없습니다. Pro 통합의 경우 사용자 정의 솔루션/스크립트를 구현하고 cron 구성 필요한 경우 스크립트를 실행합니다.

로그 작성 및 배포

환경에 변경 사항을 푸시한 후 의 각 후크에서 로깅을 검토할 수 있습니다. var/log/cloud.log 파일. 로그에는 각 후크에 대한 시작 및 중지 메시지가 포함되어 있습니다. 다음 예제에서 메시지는 "Starting post-deploy." 및 "Post-deploy is complete."

로그 항목에 대한 타임스탬프를 확인하고 특정 배포에 대한 로그를 확인합니다. 다음은 문제 해결에 사용할 수 있는 로그 출력의 압축된 예입니다.

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
클라우드 환경을 구성할 때 다음을 설정할 수 있습니다 로그 기반 Slack 및 이메일 알림 빌드 및 배포 작업용

다음 로그에는 모든 클라우드 프로젝트에 대한 공통 위치가 있습니다.

  • 배포 로그: var/log/cloud.log
  • 마지막 배포 오류 로그: var/log/cloud.error.log
  • 디버그 로그: var/log/debug.log
  • 예외 로그: var/log/exception.log
  • 시스템 로그: var/log/system.log
  • 지원 로그: var/log/support_report.log
  • 보고서: var/report/

하지만 cloud.log 파일에는 배포 프로세스의 각 단계에서 받은 피드백이 포함되어 있으며 배포 후크에서 만든 로그는 각 환경에 대해 고유합니다. 환경별 배포 로그는 다음 디렉토리에 있습니다.

  • Starter 및 Pro 통합: /var/log/deploy.log
  • Pro 스테이징: /var/log/platform/<project-ID>_stg/deploy.log
  • 프로프로덕션: /var/log/platform/<project-ID>/deploy.log

로그 배포

각 배포에 대한 로그는 특정 deploy.log 파일. 다음 예제에서는 터미널에 현재 환경의 배포 로그를 인쇄합니다.

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

샘플 응답:

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
사용자 지정 테마 파일이 누락되는 등 배포 후 애플리케이션에 정적 콘텐츠 파일에 문제가 있는 경우 최대 예상 실행 시간을 900초 이상으로 늘리십시오.

오류 로그

배포 프로세스 중에 생성된 오류 및 경고 메시지는 var/log/cloud.logvar/log/cloud.error.log 파일. 클라우드 오류 로그 파일에는 최신 배포의 오류와 경고만 포함되어 있습니다. 빈 파일은 오류 없이 성공적으로 배포했음을 나타냅니다.

다음을 사용하여 로그 파일을 볼 수 있습니다. Cloud CLI SSH또는 ECE-Tools를 사용하여 제안과 함께 오류를 표시할 수 있습니다.

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

샘플 응답:

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

대부분의 오류 메시지에는 설명 및 제안 작업이 포함되어 있습니다. 사용 ECE-Tools에 대한 오류 메시지 참조 오류 코드를 조회하여 추가 지침을 확인하십시오. 추가 지침을 보려면 Adobe Commerce 배포 문제 해결사.

애플리케이션 로그

배포 로그와 마찬가지로 애플리케이션 로그는 각 환경에 대해 고유합니다.

로그 파일
Starter 및 Pro 통합
설명
로그 배포
/var/log/deploy.log
의 활동 후크 배포.
배포 후 로그
/var/log/post_deploy.log
의 활동 후배포 후크.
크론 로그
/var/log/cron.log
cron 작업의 출력.
Nginx 액세스 로그
/var/log/access.log
Nginx 시작 시 누락된 디렉터리 및 제외된 파일 유형에 대한 HTTP 오류가 발생합니다.
Nginx 오류 로그
/var/log/error.log
Nginx와 관련된 구성 오류를 디버깅하는 데 유용한 시작 메시지입니다.
PHP 액세스 로그
/var/log/php.access.log
PHP 서비스에 대한 요청입니다.
PHP FPM 로그
/var/log/app.log

Pro 스테이징 및 프로덕션 환경의 경우 배포, 사후 배포 및 Cron 로그는 클러스터의 첫 번째 노드에서만 사용할 수 있습니다.

로그 파일
Pro 스테이징
프로프로덕션
로그 배포
첫 번째 노드만:
/var/log/platform/<project-ID>_stg/deploy.log
첫 번째 노드만:
/var/log/platform/<project-ID>/deploy.log
배포 후 로그
첫 번째 노드만:
/var/log/platform/<project-ID>_stg/post_deploy.log
첫 번째 노드만:
/var/log/platform/<project-ID>/post_deploy.log
크론 로그
첫 번째 노드만:
/var/log/platform/<project-ID>_stg/cron.log
첫 번째 노드만:
/var/log/platform/<project-ID>/cron.log
Nginx 액세스 로그
/var/log/platform/<project-ID>_stg/access.log
/var/log/platform/<project-ID>/access.log
Nginx 오류 로그
/var/log/platform/<project-ID>_stg/error.log
/var/log/platform/<project-ID>/error.log
PHP 액세스 로그
/var/log/platform/<project-ID>_stg/php.access.log
/var/log/platform/<project-ID>/php.access.log
PHP FPM 로그
/var/log/platform/<project-ID>_stg/php5-fpm.log
/var/log/platform/<project-ID>/php5-fpm.log

보관된 로그 파일

애플리케이션 로그는 하루에 한 번 압축되고 아카이빙되며 1년 동안 보관됩니다. 압축된 로그의 이름은 다음에 해당하는 고유 ID를 사용하여 지정됩니다. Number of Days Ago + 1. 예를 들어 Pro 프로덕션 환경에서는 과거 21일 동안의 PHP 액세스 로그가 다음과 같이 저장되고 이름이 지정됩니다.

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

아카이브된 로그 파일은 항상 압축 전에 원래 파일이 있던 디렉토리에 저장됩니다.

NOTE
배포Post-deploy 로그 파일은 회전 및 보관되지 않습니다. 전체 배포 기록은 이러한 로그 파일 내에 기록됩니다.

서비스 로그

각 서비스는 별도의 컨테이너에서 실행되므로 통합 환경에서 서비스 로그를 사용할 수 없습니다. Adobe Commerce on cloud infrastructure는 통합 환경에서만 웹 서버 컨테이너에 액세스할 수 있습니다. 다음 서비스 로그 위치는 Pro 프로덕션 및 스테이징 환경용입니다.

  • 레디스 로그: /var/log/platform/<project-ID>_stg/redis-server-<project-ID>_stg.log
  • Elasticsearch 로그: /var/log/elasticsearch/elasticsearch.log
  • Java 가비지 수집 로그: /var/log/elasticsearch/gc.log
  • 메일 로그: /var/log/mail.log
  • MySQL 오류 로그: /var/log/mysql/mysql-error.log
  • MySQL 느린 로그: /var/log/mysql/mysql-slow.log
  • RabbitMQ 로그: /var/log/rabbitmq/rabbit@host1.log

서비스 로그는 로그 유형에 따라 서로 다른 기간 동안 보관되고 저장됩니다. 예를 들어 MySQL 로그는 7일 후에 제거되어 수명이 가장 짧습니다.

TIP
크기 조정된 아키텍처의 로그 파일 위치는 노드 유형에 따라 다릅니다. 다음을 참조하십시오 크기 조정된 아키텍처의 로그 위치 주제.

Pro 프로덕션 및 스테이징에 대한 로그 데이터

Pro 프로덕션 및 스테이징 환경에서 다음을 사용합니다. New Relic 로그 관리 프로젝트와 통합하여 Adobe Commerce on cloud infrastructure 프로젝트와 연결된 모든 로그에서 집계된 로그 데이터를 관리합니다.

New Relic 로그 애플리케이션은 클라우드 인프라 프로덕션 및 스테이징 환경에서 Adobe Commerce의 문제를 해결하고 모니터링하는 중앙 집중식 로그 관리 대시보드를 제공합니다. 또한 대시보드는 Fastly CDN, 이미지 최적화 및 WAF(Web Application Firewall) 서비스의 로그 데이터에 대한 액세스를 제공합니다. 다음을 참조하십시오 New Relic 서비스.

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