Fleet Debugger (https://googlemaps.github.io/fleet-debugger/) es una herramienta web de código abierto que te permite visualizar los registros de Fleet Engine desde Cloud Logging. Proporciona un mapa y una línea de tiempo interactivos para analizar los datos de vehículos, tareas o viajes, y se ejecuta completamente en tu navegador.
Características clave
El depurador de flotas te ayuda a comprender los comportamientos complejos de los viajes y los vehículos, ya que ofrece lo siguiente:
- Reproducción interactiva del mapa y la línea de tiempo para ver los eventos en secuencia
- Sincronización entre el mapa, una tabla de datos y una línea de tiempo
- Inspección detallada de las entradas de registro para análisis exhaustivos de las solicitudes y respuestas de la API
- Visualización del tráfico y las rutas planificadas (requiere Registros de uso restringido)
- Comparación de las ubicaciones de parada solicitadas con las reales (requiere Registros de uso restringido).
Carga datos desde Cloud Logging
La forma principal de usar Fleet Debugger es conectarlo directamente a Cloud Logging de tu proyecto de Google Cloud. Para ello, sigue estos pasos:
- Abre la herramienta: Ve al Depurador de flotas.
- Selecciona el conjunto de datos: Haz clic en el botón "Seleccionar conjunto de datos".
- Enter Parameters: Ingresa tu ID del proyecto, los IDs de los vehículos o los IDs de los viajes o las tareas, y el período seleccionado.
- Recuperar registros: Haz clic en "Acceder y recuperar registros".
- Acceder: Autentícate con tu Cuenta de Google que tenga los permisos necesarios para acceder a Cloud Logging (p.ej.,
roles/logging.viewer).
Otros métodos de carga de datos
Si bien la conexión directa a Cloud Logging suele ser la más sencilla, puedes usar métodos basados en archivos por varios motivos:
- Analizar los registros proporcionados por un miembro del equipo
- Carga un conjunto de datos exportado previamente para volver a analizarlo.
Trabajar con registros cuando no tienes acceso directo al proyecto de GCP
- Importación de archivos: También puedes cargar datos de registro desde archivos JSON o ZIP con el botón "Cargar archivo JSON o ZIP". Estos archivos pueden ser los que exportaste antes desde Cloud Logging o desde la herramienta.
- Exportar desde la herramienta: Para compartir un conjunto de datos, usa el menú desplegable del conjunto de datos y selecciona "Exportar". Se descargará un archivo JSON que se puede comprimir. La herramienta admite la carga de archivos ZIP comprimidos en formato JSON.
Todos los datos permanecen locales en tu navegador.
Registros de uso restringido
No es necesario habilitar los Registros de uso restringido para que funcione Fleet Debugger, pero se recomienda para obtener la visualización más completa. Estos registros proporcionan un contexto valioso, que incluye lo siguiente:
- Es la ruta de navegación planificada del conductor desde el SDK de Navigation.
- Datos de tráfico a lo largo de las rutas
- Las ubicaciones de partida y destino solicitadas originalmente, además de las ubicaciones reales.
Sin los registros restringidos, estos detalles específicos no estarán disponibles en el depurador.
Recursos
- Depurador de flota
- Repositorio de GitHub: En este repositorio, puedes encontrar el código fuente y, también, informar problemas.
Asistencia
Esta herramienta de Fleet Debugger se ofrece bajo una licencia de código abierto. No se rige por los Lineamientos de los Servicios de Asistencia Técnica, el ANS ni la Política de Baja de la asistencia de Google Maps Platform. Los servicios subyacentes de Google Maps Platform que utiliza la herramienta siguen sujetos a las Condiciones del Servicio de Google Maps Platform.
- Para informar errores o solicitar funciones, presenta un problema en GitHub.
- Si tienes preguntas o quieres participar en debates técnicos, usa los canales de la comunidad de desarrolladores de Google Maps Platform.
- Para contribuir con el proyecto, consulta las guías de colaboración en el repositorio.