Fleet Debugger (https://googlemaps.github.io/fleet-debugger/) – это веб-инструмент с открытым исходным кодом, который позволяет визуализировать журналы Fleet Engine из Cloud Logging. Она предоставляет интерактивную карту и хронологию для анализа данных о транспортных средствах, задачах и поездках, работая полностью в браузере.
Основные функции
Отладчик автопарка помогает понять сложные маршруты и поведение транспортных средств, предлагая:
- Интерактивная карта и временная шкала для просмотра событий в хронологическом порядке.
- Синхронизация между картой, таблицей данных и временной шкалой.
- Подробный анализ записей в журнале для углубленного изучения запросов к API и ответов.
- Визуализация запланированных маршрутов и трафика (требуются журналы ограниченного использования).
- Сравнение запрошенных и фактических местоположений остановок (требуются журналы ограниченного использования).
Загрузка данных из Cloud Logging
Основной способ использования Fleet Debugger – подключить его напрямую к Cloud Logging вашего облачного проекта Google Cloud. Для этого выполните следующие действия:
- Откройте инструмент. Перейдите в Fleet debugger.
- Выбрать набор данных. Нажмите кнопку "Выбрать набор данных".
- Введите параметры. Укажите идентификатор проекта, идентификаторы транспортных средств, поездок или задач, а также выбранный временной диапазон.
- Получить журналы. Нажмите "Войти и получить журналы".
- Войдите в аккаунт Google с необходимыми разрешениями для доступа к Cloud Logging (например,
roles/logging.viewer).
Другие способы загрузки данных
Хотя прямое подключение к Cloud Logging часто является самым простым, вы можете использовать методы на основе файлов по нескольким причинам:
- Чтобы анализировать журналы, предоставленные участником команды.
- Чтобы загрузить ранее экспортированный набор данных для повторного анализа.
Для работы с журналами, когда у вас нет прямого доступа к проекту GCP.
- Импорт файла. Вы также можете загрузить данные журнала из файлов JSON или ZIP, нажав кнопку "Загрузить файл JSON или ZIP". Это могут быть файлы, которые вы ранее экспортировали из Cloud Logging или самого инструмента.
- Экспорт из инструмента. Чтобы поделиться набором данных, откройте раскрывающееся меню набора данных и выберите "Экспортировать". Будет скачан JSON-файл, который можно сжать. Инструмент поддерживает загрузку сжатых ZIP-файлов JSON.
Все данные остаются в браузере.
Журналы ограниченного использования
Включать журналы ограниченного использования для работы Fleet Debugger необязательно, но рекомендуется для получения наиболее полной визуализации. Эти журналы содержат ценную информацию, в том числе:
- Запланированный маршрут водителя, полученный из Navigation SDK.
- Данные о дорожной обстановке на маршрутах.
- Исходные запрошенные места посадки и высадки, а также фактические местоположения.
Без ограниченных журналов эти данные не будут доступны в отладчике.
Ресурсы
- Отладчик автопарка
- Хранилище GitHub. Здесь вы найдете исходный код и сможете сообщить о проблемах.
Поддержка
Инструмент Fleet Debugger предлагается на условиях лицензии открытого ПО. На нее не распространяются Рекомендации по использованию услуг технической поддержки, Соглашение об уровне обслуживания и Правила прекращения поддержки. На базовые сервисы платформы Google Карт, используемые инструментом, распространяются Условия использования платформы Google Карт.
- Чтобы сообщить об ошибке или запросить добавление новой функции, создайте проблему на GitHub.
- Для обсуждения технических вопросов используйте каналы сообщества разработчиков платформы Google Карт.
- Чтобы внести свой вклад в проект, ознакомьтесь с руководством для участников в репозитории.