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, que se ejecutan por completo 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 de mapas y líneas 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 analizar en profundidad las solicitudes y respuestas de la API
  • Visualización de las rutas planificadas y el tráfico (requiere registros de uso restringido).
  • Comparación de las ubicaciones de detención 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 conectarlo directamente a Cloud Logging de tu proyecto de Google Cloud. Para ello, sigue estos pasos:

  1. Abre la herramienta: Ve a Fleet Debugger.
  2. Selecciona el conjunto de datos: Haz clic en el botón "Select Dataset".
  3. Ingresa los parámetros: Ingresa el ID del proyecto, los IDs de los vehículos o los IDs de los viajes o las tareas, y el período seleccionado.
  4. Recupera los registros: Haz clic en "Sign in and Fetch Logs".
  5. Accede: 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:

  • Para analizar los registros que proporciona un miembro del equipo
  • Para cargar un conjunto de datos exportado anteriormente para volver a analizarlo

  • Para 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 "Load JSON or ZIP file instead". Estos archivos pueden ser los que exportaste anteriormente desde Cloud Logging o desde la herramienta.
    • Exportación desde la herramienta: Para compartir un conjunto de datos, usa el menú desplegable del conjunto de datos y selecciona "Export". Se descargará un archivo JSON que se puede comprimir. La herramienta admite la carga de archivos ZIP JSON comprimidos.

Todos los datos permanecen locales en tu navegador.

Registros de uso restringido

Habilitar los registros de uso restringido no es necesario para que Fleet Debugger funcione, pero se recomienda para obtener la visualización más completa. Estos registros proporcionan un contexto valioso, que incluye lo siguiente:

  • La ruta de navegación planificada del conductor desde el SDK de Navigation
  • Datos de tráfico en 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

Asistencia

Esta herramienta de Fleet Debugger se ofrece con una licencia de código abierto. No se rige por los Lineamientos de los Servicios de Asistencia Técnica de Google Maps Platform , el ANS ni la Política de Baja. Los servicios subyacentes de Google Maps Platform que usa la herramienta siguen sujetos a las Condiciones del Servicio de Google Maps Platform.