수집 뷰어

수집 뷰어 (작업 센터의 수집 > 기록에서 액세스 가능)는 지역 관심 장소 피드의 상태, 유효성 검사 상태, 처리 기록을 거의 실시간으로 파악할 수 있도록 지원합니다.

수집 뷰어를 사용하여 일일 피드 업로드를 추적하고, 수집 상태를 모니터링하고, 상품 수준 검사 오류 통계를 검사하고, 피드 파일의 도착을 확인할 수 있습니다.

개요

기본 수집 뷰어 페이지에는 Google에서 수신한 모든 피드의 역순 로그가 표시됩니다.

수집 수명 주기 단계

각 피드 제출은 다음과 같은 순차적 처리 단계를 거칩니다.

  1. 파일 획득: Google은 SFTP를 사용하여 피드 파일을 수신합니다.
  2. 파일 유효성 검사: 시스템에서 파일 무결성, 압축 해제, 전체 스키마 형식을 확인합니다.
  3. 항목 추출 및 검증: 파이프라인은 개별 지역 레코드 (poi_id, 주소, 좌표, 현지화)를 파싱하고 구문, 완전성, 정책 준수 여부를 확인합니다.
  4. 조정 및 일치: 유효한 항목은 게재를 위해 표준 Google Place ID와 연결되도록 Google의 일치 엔진으로 전달됩니다.
  5. 보고서 생성: 요약 측정항목과 그룹화된 문제 진단이 수집 뷰어에 게시됩니다.

피드 수집 기록을 보려면 다음 단계를 완료하세요.

  1. Actions Center에 로그인합니다.
  2. 수집 > 기록 페이지를 엽니다.
  3. 열 컨트롤을 사용하여 수집 테이블을 필터링, 정렬, 확인합니다.

수집 목록 열

기본 요약 표에는 각 인제스트 실행에 대해 다음 열이 제공됩니다.

열 데이터 유형 설명
ID String 수집 실행의 고유 식별자입니다.
수집된 시간 (UTC) Timestamp Google에서 피드 수집을 처리하기 시작한 날짜와 시간 (UTC)입니다.
처리 유형 Enum 데이터 획득 유형 (예: Feed)
이름 String 피드 수집 유형의 이름입니다. google.local_vss이 됩니다.
상태 State 인제션의 전체 처리 상태입니다 (예: 완료, 실패). 상태 정의를 참고하세요.
처리 동작 Enum 모든 로컬 POI 피드는 Batch 모드로 처리됩니다.
오류 Integer 감지된 차단 오류 수준 유효성 검사 문제의 총수입니다.
경고 Integer 감지된 차단되지 않는 경고 수준 문제의 총 개수입니다.
상품 Integer 이 수집에서 처리된 오프라인 속성의 총수입니다.

상태 정의

상태 열에는 피드 제출의 현재 운영 상태가 표시됩니다.

  • 완료 (STATUS_COMPLETE): 심각한 오류 없이 피드가 성공적으로 수집, 검증, 처리되었습니다.
  • 실패 (STATUS_FAILED): 인그레스 중에 심각한 스키마, 파일 손상 또는 파이프라인 오류가 발생하여 완료할 수 없습니다.
  • 처리 (STATUS_PROCESSING): Google에서 피드 데이터를 적극적으로 검증하고 매칭하고 저장하는 중입니다.
  • 건너뜀 (NOT_STARTED): 피드 업로드가 건너뛰었습니다 (예: 생성 타임스탬프가 이전에 처리된 피드보다 오래된 경우).

수집 세부정보 보기

수집 뷰어 표에서 행을 클릭하여 수집 세부정보 보기를 엽니다. 이 뷰에서는 문제를 디버깅하기 위한 포괄적인 진단 카드와 확장 패널을 제공합니다.

세부정보 패널

수집 세부정보 페이지는 다음과 같이 확장 가능한 네 섹션으로 구분됩니다.

1. 기본 정보

실행에 관한 핵심 메타데이터를 표시합니다.

  • 수집 시간 (UTC): Google에서 수집을 시작한 시점의 타임스탬프입니다.
  • 수집 유형: Feed
  • 이름: google.local_vss
  • 처리 동작: Batch
  • 상태: 색상 코딩된 상태 배지 (Done, Failed, Processing, Skipped)

2. 검사

수집 중에 발생한 모든 유효성 검사 결과를 나열합니다.

  • 파일 오류 (설명 상자): 전체 피드 파일이 실패한 경우 (예: 읽을 수 없는 보관 파일 또는 잘못된 형식의 JSON 구문) 눈에 띄는 경고 설명 상자에 근본 원인 메시지가 표시됩니다.
  • 엔티티 문제 (아코디언 표): 심각도 및 오류 코드로 그룹화된 상품 수준 검증 문제입니다.
    • 문제 코드: 특정 오류 식별자 (예: INVALID_ATTRIBUTE_VALUE, MISSING_RECOMMENDED_FIELD 또는 SAFE_SEARCH_POLICY_VIOLATION_TEXT)입니다.
    • 문제 정보: 근본 원인과 영향을 받는 필드를 설명하는 진단 설명입니다.
    • 레코드: 이 문제의 영향을 받는 속성 항목의 총수입니다.
    • 문제 행을 클릭하여 인벤토리 뷰어에서 속성을 검사할 수 있는 직접 링크가 포함된 샘플 항목 ID (poi_ids)를 펼칩니다.

3. 항목

수집 실행에 대한 항목 수준 인벤토리 델타 스코어카드를 제공합니다.

  • 합계: 처리된 오프라인 숙박 시설의 총수입니다.
  • 추가됨: 카탈로그에 새로 발견된 비즈니스 정보가 추가된 수입니다.
  • 변경됨: 속성 (예: 이름, 주소, 좌표 또는 이미지)이 업데이트된 기존 속성의 수입니다.
  • 삭제됨: 이전 피드 기준 대비 삭제되거나 생략된 속성의 수입니다.

4. 파일

업로드된 피드 파일의 이름이 표시됩니다.

  • 파일 이름: 피드 파일의 이름입니다 (예: local_feed.json.gz).

수집 실패 문제 해결

처리 뷰어에서 피드를 문제 해결할 때는 다음 가이드라인을 따르세요.

증상 가능한 원인 권장 조치
상태가 파일 오류와 함께 Failed임 ZIP/GZIP 보관 파일이 손상되었거나, JSON 구문이 잘못되었거나, 지원되지 않는 파일 인코딩입니다. 피드 패키징 가이드라인을 사용하여 피드가 올바르게 패키징되었는지 확인합니다.
유효성 검사에서 Errors 수가 많음 레코드에서 필수 스키마 필드 (예: poi_id, 구조화된 location.address 또는 WGS84 좌표)가 누락되었습니다. 확장된 유효성 검사 아코디언을 검토하여 위반 poi_id를 확인하고, 관심 장소 피드 파이프라인을 수정하고, 피드를 다시 가져옵니다.
처리된 Items이(가) 0개 피드 파일이 비어 있거나 레코드의 루트 수준 JSON 배열 파싱이 실패했습니다. 피드 래퍼 구조가 VssPoi 메시지 사양을 준수하는지 확인합니다. 피드 패키징 가이드라인을 참고하세요.