Visualiza registros con Fleet Debugger

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

Fleet Debugger 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)

Interfaz de Fleet Debugger que muestra un mapa y entradas de registro

Carga datos desde Cloud Logging

La forma principal de usar Fleet Debugger es conectándolo directamente a Cloud Logging de tu proyecto de Google Cloud. Para ello, sigue estos pasos:

  1. Abre la herramienta: Ve a Fleet debugger.
  2. Seleccionar conjunto de datos: Haz clic en un botón "Seleccionar conjunto de datos".
  3. 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.
  4. Recuperar registros: Haz clic en "Acceder y recuperar registros".
  5. Sign In: Autentícate con tu Cuenta de Google que tiene los permisos necesarios para acceder a Cloud Logging (p.ej., roles/logging.viewer).

Nota: La función de importación directa de Cloud Logging es totalmente compatible con On-demand trips. La compatibilidad con Scheduled tasks es limitada (problema de seguimiento).

Otros métodos de carga de datos

Si bien la conexión directa a Cloud Logging suele ser la más sencilla, es posible que uses 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 anteriormente desde Cloud Logging o desde la herramienta misma.
    • 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 que se obtiene del SDK de Navigation.
  • Datos de tráfico a lo largo de las rutas
  • Son las ubicaciones de partida y llegada solicitadas originalmente, además de las ubicaciones reales.

Sin los registros restringidos, estos detalles específicos no estarán disponibles en el depurador.

Recursos

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 del Centro de 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.