설명서

Adobe Commerce용 고급 보고 문제 해결사

Last update: Mon Feb 02 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

이 문서에서는 Adobe Commerce의 고급 보고 문제를 진단하고 해결하기 위한 구조화된 문제 해결 의사 결정 트리를 제공합니다. 타겟팅된 진단 질문을 안내하고 답변을 기반으로 관련 쿼리, 패치 또는 설명서를 안내합니다. 워크플로는 구성 차이, 통화 불일치, 토큰 문제 및 cron 관련 실패와 같은 근본 원인을 식별하는 데 도움이 됩니다.

설명 description

환경

클라우드 인프라의 Adobe Commerce

문제/증상

  • 고급 보고 대시보드에 데이터가 표시되지 않음
  • 고급 보고에 액세스할 때 404 오류 발생
  • Adobe Commerce과 고급 보고 간의 동기화 지연
  • 구성에 토큰이 누락되었거나 잘못되었습니다.
  • 구성 또는 내역 주문에서 여러 기본 통화가 감지됨
  • Cron 작업 analytics_collect_data가 누락되었거나, 실패했거나, 오류 상태에서 중단되었습니다.

해결 방법 resolution

각 질문을 클릭하면 문제 해결사의 각 단계에서 답변 세부 사항이 표시됩니다.

1단계

고급 보고를 사용할 때 404 오류가 발생하며, 사이트가 고급 보고 요구 사항을 충족합니까?
  • 예 - 2단계로 진행합니다.
  • 아니요 - 고급 보고 요구 사항의 단계에 따라 사이트에 대한 고급 보고 요구 사항을 완료합니다. 그런 다음 2단계로 진행합니다.

2단계

주문 및 구성에서 여러 기본 통화가 사용됩니까?

참고: 이 명령을 사용하려면 전체 테이블을 검사해야 하므로 레코드 수가 많은 테이블의 경우 이전 주문 데이터를 얻기 위해 쿼리를 실행하는 동안 성능에 영향을 줄 수 있습니다.

  • 예 - SELECT value FROM core_config_data WHERE path = 'currency/options/base';에서 여러 행을 반환하는 경우 고급 보고가 지원되지 않습니다. 1통화만 지원됩니다. 대신 Adobe Commerce Intelligence을(를) 사용해야 합니다. 계정 팀에 문의하여 설정을 구성하십시오.
  • 아니요 - 통화(예: USD)가 하나만 표시된 경우 SELECT DISTINCT base_currency_code FROM sales_order;(으)로 이전 주문을 확인하십시오. 여러 통화가 존재하는 경우 고급 보고가 지원되지 않습니다. 그렇지 않으면 3단계로 진행합니다.

3단계

고급 보고가 활성화되어 있습니까? 관리자 확인 > 스토어 > 설정 > 구성 > 일반 > 고급 보고. 자세한 단계는 고급 보고: 고급 보고 사용을 검토하십시오.
  • 예 - 4단계로 진행합니다.
  • 아니요 - 관리자의 고급 보고 사용 > 스토어 > 설정 > 구성 > 일반 > 고급 보고. 동기화를 위해 24시간 동안 기다립니다. 데이터가 로드되면 문제가 해결됩니다. 그렇지 않으면 4단계로 진행합니다.

4단계

구성에 토큰이 있습니까? SELECT * FROM core_config_data WHERE path LIKE 'analytics/general/token' \G 쿼리를 실행하여 확인하십시오.
  • 예 - 6단계로 진행합니다.
  • NO - 토큰이 NULL이거나 누락된 경우 5단계로 진행합니다.

5단계

쿼리가 flag 테이블의 행을 반환합니까?

6단계

cron_schedule 테이블에 레코드가 있고 analytics_collect_data 작업이 실행되었습니까?(SELECT * FROM cron_schedule WHERE job_code LIKE 'analytics_collect_data' \G 사용 확인)

  • 예 - status = missed인 경우 analytics_collect_data 이(가) 예상대로 실행되지 않았음을 나타냅니다.  작업이 원래 기본 cron 그룹에서 실행되었으므로 이 문제는 지원되는 Adobe Commerce 버전에서 계속 발생할 수 있습니다. QPT 패치 MDVA-19640을 적용합니다. 적용하기 전에 품질 패치 도구(QPT)의 최신 버전으로 업그레이드하십시오. 공식 QPT 사용 안내서의 패치 애플리케이션 지침을 따르십시오.

  • 예 - status = success인 경우 8단계로 진행합니다.

  • 예 - status = error인 경우 작업을 실행하려고 했지만 오류가 발생했습니다. 추가 진단을 위해 7단계로 진행합니다.

  • NO - 레코드를 찾을 수 없습니다. 작업이 실행된 적이 없습니다. 7단계로 진행합니다.

7단계

작업이 support_report.log에 기록되었습니까?

8단계

data.tgz 파일이 시스템에 있고 액세스 로그에 레코드가 있습니까?

data.tgz 파일이 있는지 확인하려면 이 명령을 실행하십시오. 해시 이름의 디렉터리를 반환해야 합니다.

code language-none 
ls -ltr pub/media/analytics/

access.log에 레코드가 있는지 확인하려면 이 명령을 실행하십시오.

Commerce Cloud에서:

code language-none 
zgrep -i analytics /var/log/platform/*/access.log* | grep MagentoBI

온-프레미스: 파일 경로를 적절하게 대체:

code language-none 
zgrep -i analytics <your web server's log path>/access.log* | grep MagentoBI
  • 예 - data.tgz 파일이 있고 액세스 로그에 레코드가 있지만 404 오류가 있는 경우 지원 티켓을 제출해야 합니다.
  • 아니요 - 9단계로 진행합니다.

9단계

cron 작업에서 오류 메시지가 표시됩니까?

예: cron_schedule 테이블에 오류 이(가) 표시됩니다. "/app/var/tmp/analytics/tmp/.nfsb3b6041dd44588a0000850c0 파일을 삭제할 수 없습니다. 경고! unlink(https://experienceleague.adobe.com/app/var/tmp/analytics/tmp/.nfsb3b6041dd44588a0000850?lang=ko): 이러한 파일 또는 디렉터리가 없습니다."

  • 예 - 이 문제는 ECE 도구에 포함된 클라우드 패치를 통해 Adobe Commerce on Cloud에서 자동으로 해결됩니다. 수동 작업은 필요하지 않습니다. 온-프레미스 판매자의 경우 QPT(Quality Patches Tool)를 통해서는 이 수정 사항을 사용할 수 없습니다. 오류가 지속되면 지원 티켓을 제출하십시오.
  • 아니요 - 지원 티켓을 제출.

관련 읽기

Commerce 관리 시작 안내서의 고급 보고.

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f