Fleet Debugger ( https://googlemaps.github.io/fleet-debugger/ ) — это веб-инструмент с открытым исходным кодом, позволяющий визуализировать журналы Fleet Engine из Cloud Logging. Он предоставляет интерактивную карту и временную шкалу для анализа данных о транспортных средствах, задачах или поездках, работая полностью в вашем браузере.
Основные характеристики
Fleet Debugger помогает понять сложные особенности маршрутов и поведения транспортных средств, предоставляя следующие возможности:
- Интерактивная карта и воспроизведение временной шкалы позволяют увидеть события в хронологическом порядке.
- Синхронизация между картой, таблицей данных и временной шкалой.
- Детальный анализ логов для углубленного изучения запросов и ответов API.
- Визуализация запланированных маршрутов и дорожного движения (требуется доступ к журналам ограниченного использования ).
- Сравнение запрошенных и фактических мест остановок (требуется ведение журналов ограниченного использования ).

Загрузка данных из системы облачного логирования.
Основной способ использования Fleet Debugger — это прямое подключение его к системе Cloud Logging вашего проекта Google Cloud. Для этого выполните следующие шаги:
- Откройте инструмент: перейдите в Fleet debugger .
- Выберите набор данных: нажмите кнопку «Выбрать набор данных».
- Введите параметры: укажите идентификатор проекта, идентификатор(ы) транспортного средства или идентификатор(ы) поездки или задачи, а также выбранный временной диапазон.
- Чтобы получить журналы событий: нажмите «Войти и получить журналы событий».
- Вход в систему: Аутентифицируйтесь с помощью своей учетной записи Google, имеющей необходимые разрешения для доступа к Cloud Logging (например,
roles/logging.viewer).
Примечание: Функция прямого импорта данных из облачных журналов полностью поддерживается для On-demand trips . Поддержка Scheduled tasks ограничена ( проблема отслеживания ).
Другие методы загрузки данных
Хотя прямое подключение к Cloud Logging зачастую является самым простым вариантом, вы можете использовать методы, основанные на работе с файлами, по нескольким причинам:
- Для анализа журналов, предоставленных членом команды.
- Для загрузки ранее экспортированного набора данных для повторного анализа.
Для работы с логами, когда у вас нет прямого доступа к проекту GCP.
- Импорт файлов: Вы также можете загружать данные журналов из файлов JSON или ZIP, используя кнопку «Загрузить файл JSON или ZIP вместо этого». Эти файлы могут быть ранее экспортированы из Cloud Logging или непосредственно из самого инструмента.
- Экспорт из инструмента: Чтобы поделиться набором данных, используйте выпадающее меню «Набор данных» и выберите «Экспорт». Это загрузит JSON-файл, который можно сжать. Инструмент поддерживает загрузку сжатых JSON-файлов в формате ZIP.
Все данные остаются локально в вашем браузере.
Журналы ограниченного использования
Включение журналов ограниченного использования не является обязательным для работы Fleet Debugger, но рекомендуется для наиболее полной визуализации. Эти журналы предоставляют ценную информацию, в том числе:
- Запланированный водителем навигационный маршрут из навигационного SDK.
- Данные о дорожном движении по маршрутам.
- Указаны первоначально запрошенные места посадки и высадки, а также фактические места.
Без ограниченного доступа к журналам эти конкретные детали не будут доступны в отладчике.
Ресурсы
- Отладчик флота
- Репозиторий GitHub : В этом репозитории вы можете найти исходный код и сообщить о проблемах.
Поддерживать
Данный инструмент Fleet Debugger распространяется по лицензии с открытым исходным кодом. На него не распространяются Руководящие принципы технической поддержки платформы Google Maps, соглашение об уровне обслуживания (SLA) или политика устаревания . Базовые сервисы платформы Google Maps, используемые инструментом, по-прежнему регулируются Условиями предоставления услуг платформы Google Maps.
- Чтобы сообщить об ошибках или запросить новые функции, создайте заявку на GitHub .
- Для технических вопросов и обсуждений используйте каналы сообщества разработчиков Google Maps Platform .
- Чтобы внести свой вклад в проект, ознакомьтесь с руководствами по участию в репозитории .