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 hình dung 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 và nhiệm vụ hoặc dữ liệu 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

Fleet Debugger giúp bạn hiểu được hành vi phức tạp của hành trình và xe bằng cách cung cấp:

  • Bản đồ tương tác và 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 của API.
  • Hình ảnh trực quan về các tuyến đường đã lên kế hoạch và tình trạng giao thông (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ế (yêu cầu Nhật ký sử dụng bị 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 Fleet Debugger.
  2. Chọn tập dữ liệu: Nhấp vào nút "Chọn tập dữ liệu".
  3. Nhập tham số: Nhập Mã dự án, Mã xe hoặc Mã chuyến đi/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 Cloud Logging (ví dụ: roles/logging.viewer).

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

Mặc dù việc kết nối trực tiếp với Cloud Logging thường là 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.

  • Để làm việc với 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 "Tải tệp JSON hoặc ZIP thay thế". Đây có thể là những tệp mà 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ể được 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 nằm cục bộ trong trình duyệt của bạn.

Nhật ký sử dụng bị hạn chế

Bạn không bắt buộc phải bật Nhật ký sử dụng bị hạn chế để Fleet Debugger hoạt động, nhưng bạn nên bật để 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:

  • Tuyến đường điều hướng đã lên kế hoạch của tài xế từ Navigation SDK.
  • Dữ liệu giao thông dọc theo các tuyến đường.
  • Vị trí đón và trả khách ban đầu theo yêu cầu, ngoài vị trí thực tế.

Nếu không có nhật ký bị hạn chế, thì những thông tin chi tiết 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ở. Công cụ này không chịu sự điều chỉnh của Nguyên tắc dịch vụ hỗ trợ kỹ thuật của Google Maps Platform , thỏa thuận mức dịch vụ (SLA) hoặc Chính sách ngừng sử dụng. 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 theo Điều khoản dịch vụ của Nền tảng Google Maps.