Trực quan hoá nhật ký bằng Trình gỡ lỗi nhóm

Fleet Debugger (https://googlemaps.github.io/fleet-debugger/) là một công cụ web nguồn mở cho phép bạn trực quan hoá nhật ký Fleet Engine từ Cloud Logging. Công cụ này cung cấp một bản đồ và dòng thời gian tương tác để phân tích dữ liệu về xe, nhiệm vụ hoặc chuyến đi, chạy hoàn toàn trong trình duyệt của bạn.

Các tính năng chính

Trình gỡ lỗi đội xe giúp bạn hiểu rõ hành trình và hành vi phức tạp của xe bằng cách cung cấp:

  • Bản đồ tương tác và tính năng phát lại dòng thời gian để xem các sự kiện theo trình tự.
  • Đồng bộ hoá giữa bản đồ, bảng dữ liệu và dòng thời gian.
  • Kiểm tra chi tiết mục nhập nhật ký để tìm hiểu sâu về các yêu cầu và phản hồi API.
  • Hình ảnh trực quan về các tuyến đường và lưu lượng truy cập đã lên kế hoạch (yêu cầu Nhật ký sử dụng bị hạn chế).
  • So sánh vị trí dừng theo yêu cầu với vị trí dừng thực tế (cần có Nhật ký sử dụng có hạn chế).

Giao diện Trình gỡ lỗi đội xe cho thấy bản đồ và các mục nhật ký

Tải dữ liệu từ Cloud Logging

Cách chính để sử dụng Fleet Debugger là kết nối trực tiếp công cụ này với Cloud Logging của dự án Google Cloud. Để thực hiện việc này, hãy làm theo các bước tiếp theo:

  1. Mở công cụ: Chuyển đến Trình gỡ lỗi đội xe.
  2. Chọn tập dữ liệu: Nhấp vào nút "Chọn tập dữ liệu".
  3. Nhập thông số: Nhập mã dự án, (các) mã xe hoặc(các) mã chuyến đi hoặc mã nhiệm vụ và phạm vi thời gian đã chọn.
  4. Tìm nạp nhật ký: Nhấp vào "Đăng nhập và tìm nạp nhật ký".
  5. Đăng nhập: Xác thực bằng Tài khoản Google có các quyền cần thiết để truy cập vào tính năng Ghi nhật ký trên đám mây (ví dụ: roles/logging.viewer).

Lưu ý: Tính năng nhập trực tiếp Cloud Logging được hỗ trợ đầy đủ cho On-demand trips. Scheduled tasks hỗ trợ có giới hạn (vấn đề theo dõi).

Các phương thức tải dữ liệu khác

Mặc dù kết nối trực tiếp với Cloud Logging thường là cách dễ nhất, nhưng bạn có thể sử dụng các phương thức dựa trên tệp vì một số lý do:

  • Để phân tích nhật ký do một thành viên trong nhóm cung cấp.
  • Để tải một tập dữ liệu đã xuất trước đó để phân tích lại.

  • Để xử lý nhật ký khi bạn không có quyền truy cập trực tiếp vào dự án GCP.

    • Nhập tệp: Bạn cũng có thể tải dữ liệu nhật ký từ tệp JSON hoặc ZIP bằng nút "Thay vào đó, hãy tải tệp JSON hoặc ZIP". Những tệp này có thể là tệp bạn đã xuất trước đó từ Cloud Logging hoặc từ chính công cụ này.
    • Xuất từ công cụ: Để chia sẻ một tập dữ liệu, hãy sử dụng trình đơn thả xuống tập dữ liệu rồi chọn "Xuất". Thao tác này sẽ tải một tệp JSON có thể nén xuống. Công cụ này hỗ trợ tải các tệp zip JSON đã nén.

Tất cả dữ liệu vẫn được lưu trữ cục bộ trên trình duyệt của bạn.

Nhật ký sử dụng có giới hạn

Nhật ký sử dụng có hạn chế không bắt buộc đối với Fleet Debugger để hoạt động, nhưng bạn nên sử dụng nhật ký này để có hình ảnh trực quan đầy đủ nhất. Các nhật ký này cung cấp bối cảnh có giá trị, bao gồm:

  • Lộ trình di chuyển đã lên kế hoạch của người lái xe từ Navigation SDK.
  • Dữ liệu giao thông dọc theo các tuyến đường.
  • Vị trí đón và trả khách được yêu cầu ban đầu, ngoài vị trí thực tế.

Nếu không có nhật ký bị hạn chế, những thông tin cụ thể này sẽ không có trong trình gỡ lỗi.

Tài nguyên

Hỗ trợ

Công cụ Fleet Debugger này được cung cấp theo giấy phép nguồn mở. Dịch vụ này không chịu sự điều chỉnh của Nguyên tắc về dịch vụ hỗ trợ kỹ thuật của Nền tảng Google Maps, SLA hoặc Chính sách ngừng cung cấp. Các dịch vụ cơ bản của Nền tảng Google Maps mà công cụ này sử dụng vẫn phải tuân thủ Điều khoản dịch vụ của Nền tảng Google Maps.