데이터 피드 동기화 상태 모니터링
Adobe Commerce 관리자는 Commerce 관리자의 데이터 피드 동기화 상태 페이지를 사용하여 Adobe Commerce에서 연결된 Commerce 서비스로 내보낸 데이터의 동기화 상태를 모니터링할 수 있습니다.
이 페이지에서는 제품 및 범주 데이터를 Commerce에서 Product Recommendations, Live Search 및 Catalog Service과 같은 외부 서비스로 전송하는 데이터 내보내기 피드의 상태와 성능에 대한 실시간 통찰력을 제공합니다.
동기화 상태 페이지에는 내보내기 상태만 표시됩니다. 성공 상태는 데이터를 성공적으로 내보내고 연결된 Commerce 서비스에서 사용할 수 있음을 나타냅니다. 실제 엔터티 동기화 상태를 보려면 데이터 관리 대시보드를 사용하십시오.
피드 상태 모니터링은 데이터 일관성을 보장하고 내보내기 프로세스 중에 발생하는 모든 문제를 신속하게 해결할 수 있습니다. 관리자는 다음 작업을 수행할 수 있습니다.
- 모든 데이터 피드에 대해 동기화 상태 보기
- 피드 처리에서 오류 식별 및 문제 해결
- 개별 피드 항목에 대한 자세한 상태 정보에 액세스
다음 피드에 대해 상태가 추적됩니다.
- 제품 피드
- 제품 속성 피드
- 카테고리 피드
- 제품 재정의 피드
- 제품 가격 피드
- 제품 변형 피드
확장 설치
데이터 피드 상태 페이지는 다음 Commerce 서비스에 대한 활성 라이선스가 있는 모든 Commerce 판매자가 사용할 수 있습니다.
요구 사항
-
PHP 8.1, 8.2, 8.3 또는 8.4
-
Adobe Commerce 2.4.4+
-
Adobe Commerce 데이터 내보내기 확장, 버전 103.4.15 이상
-
키를 생성하고 필요한 권한을 얻으려면 인증 키 가져오기를 참조하십시오. 클라우드 설치의 경우 Commerce on Cloud Infrastructure Guide를 참조하십시오.
-
Adobe Commerce 애플리케이션 서버의 명령줄에 액세스합니다.
설치 단계
작성기를 사용하여 magento/module-data-exporter-status 모듈 추가:
composer require magento/module-data-exporter-status
자세한 설치 단계는 다음 안내서를 참조하십시오.
데이터 피드 상태 페이지 액세스
Commerce 관리자의 System > 데이터 전송 > Data Feed Sync Status에서 Commerce 관리자의 데이터 피드 상태 페이지에 액세스합니다.
데이터 피드 내보내기 활동을 요약하는
데이터 피드 상태 모니터링은 다음 두 가지 인터페이스를 제공합니다.
- 사용 가능한 피드 및 현재 상태를 나열하는 데이터 피드 동기화 상태 요약 페이지
- 선택한 피드에 대한 자세한 정보를 표시하는 데이터 피드 동기화 상태 - 세부 정보 페이지입니다.
데이터 피드 동기화 상태 요약
피드 동기화 상태 요약 페이지는 다음 정보를 포함하여 데이터 피드 내보내기 활동에 대한 정보를 제공합니다.
데이터 피드 동기화 상태 세부 정보
데이터 피드 상태 요약 페이지에서 피드 이름을 클릭하거나 View Details 작업을 사용하여 피드 내의 개별 레코드에 대한 자세한 정보에 액세스합니다.
피드 항목 상태를 보고하는
세부 사항 보기는 각 피드 항목에 대해 다음 정보를 제공합니다.
다음 컨트롤을 사용하여 보기를 관리할 수 있습니다.
- Mass Action: 선택한 피드 항목에 대한 재동기화를 예약합니다.
- Filters
- Default View: 필터링된 보기를 만들고 저장하고 보기 간에 전환합니다.
- 테이블에서 열을 표시하거나 숨기려면 Columns을(를) 사용합니다.
피드 상태 표시기
각 피드 세부 사항 페이지의 맨 위에서 중요 상태 표시기는 각 피드에 대한 시스템 상태를 제공합니다.
인덱서 상태
- 유효: 데이터가 동기화되어 다시 인덱싱할 필요가 없습니다.
- 잘못됨: 원본 데이터가 변경되었습니다. 인덱스를 업데이트해야 합니다.
- 처리 중: 인덱싱이 진행 중입니다.
로그 백로그 변경
- 모두 동기화됨: 프로세스에 대한 보류 중인 변경 내용이 없습니다.
- 백로그의 항목: 처리 대기 중인 보류 중인 변경 내용 수
내보내기 상태 유형
시스템은 문제를 신속하게 식별하는 데 도움이 되는 상태 표시기를 제공합니다.
상태 범주
데이터 피드 상태 모니터링
Commerce 데이터베이스에서 제품 및 카테고리 관련 엔터티를 업데이트하면 피드 구성에 따라 데이터가 Commerce 서비스로 전송됩니다. 데이터 피드 동기화 상태 요약 페이지에서 이 프로세스를 실시간으로 모니터링할 수 있습니다.
성공적으로 전송된 레코드 수가 소스 레코드 수와 일치하면 동기화가 완료되고 모든 데이터가 성공적으로 전송되었음을 나타냅니다.
실패한 내보내기 관리
실패한 내보내기의 세부 정보를 확인하고 수정 작업을 수행하려면 다음을 수행합니다.
-
피드 동기화 상태 페이지에서 실패한 레코드가 있는 피드를 찾습니다.
-
Details을(를) 클릭합니다.
-
특정 실패 이유에 대한 오류 메시지를 검토하십시오.
-
대량 조치를 사용하여 실패한 품목에 대한 재동기화 작업을 스케줄링합니다.
실패한 데이터 재동기화
Actions 페이지의 Data Feed Sync Status - Details 메뉴를 사용하여 수동으로 실패한 데이터 피드 또는 문제가 있는 데이터 피드를 다시 동기화할 수 있습니다.
시스템이 특정 유형의 실패를 자동으로 다시 시도하는 동안 다음 시나리오에서 수동 개입이 필요할 수 있습니다.
- 인증 또는 권한 오류(401, 403 상태 코드)가 표시됩니다.
- 페이로드 오류를 일으킨 데이터 형식 문제를 해결한 후
- 외부 서비스 구성 또는 엔드포인트에 대한 다음 업데이트.
- 데이터 내보내기 프로세스에 영향을 주는 사용자 지정을 배포하고 있습니다.
피드 상태를 사전 예방적으로 모니터링하고 오류를 신속하게 해결함으로써 Commerce 에코시스템 전반에서 데이터 일관성과 안정성을 유지할 수 있습니다.
피드 항목 수동 재동기화
특정 피드 항목을 다시 동기화해야 하는 경우:
- 레코드 선택: 주의가 필요한 실패한 레코드를 선택하려면 확인란을 사용하십시오.
- 동작 선택: 일괄 동작 드롭다운에서 Schedule Resync을(를) 선택합니다.
- 확인: Submit을(를) 클릭하고 다시 동기화 작업을 확인합니다.
- 결과 모니터링: 성공 메시지를 확인하고 상태 변경을 모니터링합니다.
우수 사례
정기 모니터링
- 일별 검사: 오류율이 높은 피드에 대한 개요 페이지를 매일 검토합니다
- 주별 심층 분석: 중요 피드(제품, 가격)에 대한 세부 상태를 검사합니다.
- 월별 분석: 내보내기 성공률 및 성능의 트렌드를 추적합니다.
워크플로우 문제 해결
- 문제 식별: 오류 및 높은 오류 수 확인
- 인덱서 상태 확인: 인덱서가 유효하고 백로그가 관리 가능한지 확인하십시오.
- 오류 세부 정보 검토: 특정 오류 메시지를 보려면 실패한 레코드를 클릭하십시오.
- 다시 동기화 예약: 대량 작업을 사용하여 실패한 내보내기를 다시 시도하십시오
- 모니터 해상도: 다시 동기화된 항목에 성공 상태가 표시되는지 확인
일반적인 문제 해결
높은 실패율
증상: "실패, 주의 필요" 상태를 표시하는 레코드가 너무 많습니다.
가능한 원인:
- 외부 서비스 구성 변경 사항
- 데이터 형식 비호환성
- 인증 또는 권한 문제
해결 단계:
- 외부 서비스 상태 및 구성 확인
- 패턴에 대한 오류 메시지 검토
- 인증 자격 증명 확인
- 필요한 경우 외부 서비스 지원에 문의하십시오
느린 내보내기 성능
증상: 변경 로그 백로그가 많고 상태 업데이트가 느림
가능한 원인:
- 인덱서 성능 문제
- 높은 데이터 볼륨
- 외부 서비스 속도 제한
해결 단계:
- 인덱서 상태를 확인하고 잘못된 경우 다시 실행
- 외부 서비스 응답 시간 모니터링
- 사용량이 적은 시간 동안 내보내기 일정 조정 고려
- 시스템 리소스 및 성능 검토
인증 실패
증상: 401 또는 403 상태 코드
해결 단계:
- API 자격 증명 및 토큰 확인
- 외부 서비스 계정 권한 확인
- 만료된 인증 토큰 갱신
- 액세스 문제에 대해서는 서비스 공급업체에 문의하십시오