Trình xem quy trình truyền dẫn

Trình xem dữ liệu đầu vào (có thể truy cập trong phần Dữ liệu đầu vào > Nhật ký trong Trung tâm hành động) cung cấp thông tin về trạng thái, tình trạng xác thực và nhật ký xử lý của nguồn cấp dữ liệu điểm đến tại địa phương gần như theo thời gian thực.

Sử dụng Trình xem dữ liệu đầu vào để theo dõi hoạt động tải nguồn cấp dữ liệu lên hằng ngày, giám sát tình trạng dữ liệu đầu vào, kiểm tra số liệu thống kê về lỗi xác thực ở cấp mặt hàng và xác minh thời điểm đến của tệp nguồn cấp dữ liệu.

Tổng quan

Trang chính của Trình xem dữ liệu đầu vào sẽ hiển thị nhật ký theo thứ tự thời gian đảo ngược của mọi nguồn cấp dữ liệu mà Google nhận được.

Các giai đoạn trong vòng đời của quá trình nhập

Mỗi lần gửi nguồn cấp dữ liệu sẽ trải qua các giai đoạn xử lý tuần tự sau đây:

  1. Thu thập tệp: Google nhận tệp nguồn cấp dữ liệu bằng SFTP.
  2. Xác thực tệp: Hệ thống xác minh tính toàn vẹn của tệp, quá trình giải nén và định dạng giản đồ tổng thể.
  3. Trích xuất và xác thực thực thể: Quy trình này phân tích các bản ghi riêng lẻ tại địa phương (poi_id, địa chỉ, toạ độ, bản dịch) và kiểm tra cú pháp, tính đầy đủ và việc tuân thủ chính sách.
  4. Đối chiếu và so khớp: Các thực thể hợp lệ sẽ được chuyển đến công cụ so khớp của Google để liên kết với mã địa điểm chuẩn của Google nhằm phân phát.
  5. Tạo báo cáo: Các chỉ số tóm tắt và thông tin chẩn đoán vấn đề theo nhóm được xuất bản cho Trình xem dữ liệu đầu vào.

Để xem nhật ký tiếp nhận nguồn cấp dữ liệu, hãy hoàn tất các bước sau:

  1. Đăng nhập vào Actions Center.
  2. Mở trang Truyền nhận > Nhật ký.
  3. Lọc, sắp xếp và xem bảng truyền dữ liệu bằng các chế độ kiểm soát cột.

Cột danh sách tiếp nhận

Bảng tóm tắt chính cung cấp các cột sau cho mỗi lần truyền dữ liệu:

Cột Loại dữ liệu Mô tả
Mã nhận dạng String Giá trị nhận dạng riêng biệt của lần chạy quy trình chuyển dữ liệu.
Thời gian tiếp nhận (UTC) Timestamp Ngày và giờ (theo giờ UTC) khi Google bắt đầu xử lý việc nhập nguồn cấp dữ liệu.
Loại truyền dẫn Enum Loại dữ liệu thu thập (ví dụ: Feed).
Tên String Tên cho loại nguồn cấp dữ liệu được nhập. Thao tác này sẽ google.local_vss.
Trạng thái State Trạng thái xử lý tổng thể của quá trình truyền tải (ví dụ: Đã hoàn tất, Không thành công). Xem Định nghĩa trạng thái.
Hành vi truyền dẫn Enum Tất cả nguồn cấp dữ liệu địa điểm yêu thích tại địa phương đều được xử lý ở chế độ Batch.
Lỗi Integer Tổng số vấn đề xác thực ở cấp lỗi chặn được phát hiện.
Cảnh báo Integer Tổng số vấn đề không chặn ở cấp cảnh báo đã phát hiện.
Mặt hàng Integer Tổng số tài sản tại địa phương được xử lý trong lần nhập này.

Định nghĩa trạng thái

Cột Trạng thái cho biết trạng thái hoạt động hiện tại của một lần gửi nguồn cấp dữ liệu:

  • Đã xong (STATUS_COMPLETE): Nguồn cấp dữ liệu đã được nhập, xác thực và xử lý thành công mà không gặp lỗi nghiêm trọng.
  • Thất bại (STATUS_FAILED): Quá trình truyền dữ liệu gặp phải lỗi nghiêm trọng về giản đồ, lỗi hỏng tệp hoặc lỗi quy trình và không thể hoàn tất.
  • Đang xử lý (STATUS_PROCESSING): Google đang xác thực, so khớp và lưu trữ dữ liệu của nguồn cấp dữ liệu.
  • Đã bỏ qua (NOT_STARTED): Nguồn cấp dữ liệu đã bị bỏ qua (ví dụ: nếu dấu thời gian tạo cũ hơn một nguồn cấp dữ liệu đã được xử lý trước đó).

Khung hiển thị chi tiết về quy trình truyền dẫn

Nhấp vào một hàng bất kỳ trong bảng Trình xem dữ liệu đầu vào để mở Chế độ xem chi tiết về dữ liệu đầu vào. Chế độ xem này cung cấp các thẻ chẩn đoán toàn diện và bảng mở rộng để gỡ lỗi.

Bảng chi tiết

Trang thông tin chi tiết về quy trình truyền dẫn được chia thành 4 phần có thể mở rộng:

1. Thông tin cơ bản

Hiển thị siêu dữ liệu cốt lõi về lần chạy thực thi:

  • Thời gian tiếp nhận (UTC): Dấu thời gian khi Google bắt đầu tiếp nhận.
  • Loại truyền dẫn: Feed.
  • Tên: google.local_vss
  • Hành vi truyền dẫn: Batch
  • Trạng thái: Huy hiệu trạng thái có mã màu (Done, Failed, Processing, Skipped).

2. Xác nhận kết quả

Liệt kê tất cả các kết quả xác thực gặp phải trong quá trình truyền dữ liệu:

  • Lỗi tệp (Hộp chú thích): Nếu toàn bộ tệp nguồn cấp dữ liệu bị lỗi (ví dụ: do một tệp lưu trữ không đọc được hoặc cú pháp JSON bị lỗi), thì một chú thích cảnh báo nổi bật sẽ hiển thị thông báo về nguyên nhân gốc rễ.
  • Vấn đề về thực thể (Bảng dạng đàn accordion): Vấn đề xác thực ở cấp mặt hàng được nhóm theo mức độ nghiêm trọng và mã lỗi.
    • Mã vấn đề: Giá trị nhận dạng lỗi cụ thể (chẳng hạn như INVALID_ATTRIBUTE_VALUE, MISSING_RECOMMENDED_FIELD hoặc SAFE_SEARCH_POLICY_VIOLATION_TEXT).
    • Thông tin về vấn đề: Nội dung mô tả chẩn đoán giải thích nguyên nhân gốc và các trường bị ảnh hưởng.
    • Bản ghi: Tổng số thực thể tài sản chịu ảnh hưởng của vấn đề này.
    • Nhấp vào hàng vấn đề bất kỳ để mở rộng các mã nhận dạng thực thể mẫu (poi_id) có đường liên kết trực tiếp để kiểm tra các thuộc tính trong Trình xem kho hàng.

3. Mục

Cung cấp bảng điểm chênh lệch khoảng không quảng cáo ở cấp mặt hàng cho lần chạy tiếp nhận:

  • Tổng số: Tổng số cơ sở lưu trú tại địa phương đã được xử lý.
  • Đã thêm: Số lượng trang thông tin doanh nghiệp mới được phát hiện và thêm vào danh mục của bạn.
  • Đã thay đổi: Số lượng thuộc tính hiện có có các thuộc tính (ví dụ: tên, địa chỉ, toạ độ hoặc hình ảnh) đã được cập nhật.
  • Đã xoá: Số lượng tài sản bị loại bỏ hoặc bỏ qua so với đường cơ sở trước đó của nguồn cấp dữ liệu.

4. Tệp

Cho biết tên của tệp nguồn cấp dữ liệu đã tải lên:

  • Tên tệp: Tên của tệp nguồn cấp dữ liệu (ví dụ: local_feed.json.gz).

Khắc phục sự cố không truyền dẫn được

Khi khắc phục sự cố về nguồn cấp dữ liệu trong Trình xem dữ liệu đầu vào, hãy làm theo các nguyên tắc sau:

Dấu hiệu Nguyên nhân có thể xảy ra Việc nên làm
Trạng thái là Failed kèm theo Lỗi tệp Tệp lưu trữ ZIP/GZIP bị hỏng, cú pháp JSON bị lỗi hoặc mã hoá tệp không được hỗ trợ. Xác minh rằng nguồn cấp dữ liệu của bạn được đóng gói đúng cách theo Nguyên tắc đóng gói nguồn cấp dữ liệu.
Số lượng Errors lớn trong phần Xác thực Các trường lược đồ bắt buộc (chẳng hạn như poi_id, location.address có cấu trúc hoặc toạ độ WGS84) bị thiếu trong các bản ghi. Xem lại bảng Xác thực được mở rộng để xác định (các) poi_id vi phạm, chỉnh sửa quy trình nguồn cấp dữ liệu POI và nhập lại nguồn cấp dữ liệu.
Zero Items processed Tệp nguồn cấp dữ liệu bị trống hoặc bản ghi không phân tích cú pháp được mảng JSON cấp gốc. Kiểm tra để đảm bảo cấu trúc trình bao bọc nguồn cấp dữ liệu tuân thủ quy cách thông báo VssPoi. Tham khảo Nguyên tắc đóng gói nguồn cấp dữ liệu.