Fleet 디버거로 로그 시각화

Fleet Debugger(https://googlemaps.github.io/fleet-debugger/)는 Cloud Logging의 Fleet Engine 로그를 시각화할 수 있는 오픈소스 웹 도구입니다. 브라우저에서 완전히 실행되는 대화형 지도와 타임라인을 제공하여 차량 및 작업 또는 이동 데이터를 분석합니다.

주요 특징

Fleet Debugger는 다음을 제공하여 복잡한 여정과 차량 동작을 이해하는 데 도움을 줍니다.

  • 이벤트를 순서대로 볼 수 있는 대화형 지도 및 타임라인 재생
  • 지도, 데이터 표, 타임라인 간 동기화
  • API 요청 및 응답을 자세히 살펴볼 수 있는 상세 로그 항목 검사
  • 계획된 경로 및 트래픽 시각화 (제한된 사용 로그 필요)
  • 요청된 정차 위치와 실제 정차 위치 비교 (제한된 사용 로그 필요)

지도와 로그 항목이 표시된 Fleet Debugger 인터페이스

Cloud Logging에서 데이터 로드

Fleet Debugger를 사용하는 기본 방법은 Google Cloud 프로젝트의 Cloud Logging에 직접 연결하는 것입니다. 이렇게 하려면 다음 단계를 따르세요.

  1. 도구 열기: Fleet 디버거로 이동합니다.
  2. 데이터 세트 선택: '데이터 세트 선택' 버튼을 클릭합니다.
  3. 매개변수 입력: 프로젝트 ID, 차량 ID 또는 여정 또는 작업 ID, 선택한 시간 범위를 입력합니다.
  4. 로그 가져오기: '로그인 및 로그 가져오기'를 클릭합니다.
  5. 로그인: Cloud Logging 액세스에 필요한 권한이 있는 Google 계정으로 인증합니다 (예: roles/logging.viewer))를 제공합니다.

참고: 직접 Cloud Logging 가져오기 기능은 On-demand trips에서 완전히 지원됩니다. Scheduled tasks 지원이 제한됩니다(추적 문제).

기타 데이터 로드 방법

Cloud Logging에 직접 연결하는 것이 가장 쉬운 방법인 경우가 많지만 다음과 같은 여러 이유로 파일 기반 방법을 사용할 수 있습니다.

  • 팀 구성원이 제공한 로그를 분석합니다.
  • 이전에 내보낸 데이터 세트를 다시 분석하기 위해 로드합니다.

  • GCP 프로젝트에 직접 액세스할 수 없는 경우 로그를 사용합니다.

    • 파일 가져오기: 'JSON 또는 ZIP 파일 대신 로드' 버튼을 사용하여 JSON 또는 ZIP 파일에서 로그 데이터를 로드할 수도 있습니다. 이러한 파일은 이전에 Cloud Logging 또는 도구 자체에서 내보낸 파일일 수 있습니다.
    • 도구에서 내보내기: 데이터 세트를 공유하려면 데이터 세트 드롭다운 메뉴를 사용하고 '내보내기'를 선택합니다. 이렇게 하면 압축할 수 있는 JSON 파일이 다운로드됩니다. 이 도구는 압축된 JSON zip 파일의 로드를 지원합니다.

모든 데이터는 브라우저에 로컬로 유지됩니다.

제한된 사용 로그

Fleet 디버거가 작동하는 데 제한된 사용 로그를 사용 설정할 필요는 없지만 가장 완전한 시각화를 위해서는 사용 설정하는 것이 좋습니다. 이러한 로그는 다음을 비롯한 유용한 컨텍스트를 제공합니다.

  • Navigation SDK에서 운전자가 계획한 내비게이션 경로입니다.
  • 경로를 따라 이동하는 교통정보 데이터입니다.
  • 실제 위치 외에 원래 요청된 승차 및 하차 위치입니다.

제한된 로그가 없으면 디버거에서 이러한 세부정보를 사용할 수 없습니다.

리소스

지원

이 Fleet Debugger 도구는 오픈소스 라이선스에 따라 제공됩니다. Google Maps Platform 지원 기술 지원 서비스 가이드라인, SLA 또는 지원 중단 정책의 적용을 받지 않습니다. 이 도구에서 사용하는 기본 Google Maps Platform 서비스에는 Google Maps Platform 서비스 약관이 계속 적용됩니다.