Logs remotos DJI

Cuando algo sale mal en un dock o aeronave — un vuelo fallido, una cadena de warnings HMS, una cubierta atascada — los logs de diagnóstico de DJI son la única forma de saber qué ocurrió en el dispositivo. ARGUS dispara y recoge esos logs mediante Admin → Gestión DJI → Debug → Logs remotos.

Quién puede disparar una extracción

Sólo admin. Los archivos de log del dock contienen números de serie, datos de escaneo inalámbrico y diagnósticos de firmware — trátalos como sensibles.

Paso 1 — Refrescar la lista de archivos

1. Elige el dock en Admin → DJI → Docks.
2. Abre la pestaña Debug.
3. En Logs remotos, confirma que al menos un chip de módulo está marcado (ver abajo).
4. Haz clic en Refrescar lista de archivos.

ARGUS llama a POST /api/dji/docks/{sn}/logs/list con los módulos seleccionados. argus-dji publica el servicio DJI fileupload_list; el dock enumera sus archivos de log en disco por módulo y responde. argus-dji espeja la respuesta en dji_docks/{sn}.remoteLog.fileList y la UI re-renderiza con una rejilla de archivos.

Chips de módulo

La DJI Cloud API enumera los módulos por id numérico, no por la cadena all (que varias revisiones de firmware rechazan con un 400 silencioso). ARGUS siempre envía módulos individuales:

Módulo	Id	Contenidos
dock	0	Logs core del dock — MQTT, máquina de estado, motor de cubierta, carga, sensores meteo, eSIM / módem.
aircraft	3	Controlador de vuelo, IMU, compass, ESC, pack de batería, gimbal, cámara de payload, black-box de FlightRecorder.
rc	4	Logs del remote controller (sólo poblado cuando un RC físico ha sido vinculado a la aeronave).
psdk	5	Payload SDK — dispositivos adjuntos de terceros (altavoz, foco, sensores personalizados). Dock 3 / M3x.

Marca sólo los módulos que necesitas — cada módulo extra añade ~30–90 s al tiempo de enumeración del dock e incrementa el tamaño de subida cuando confirmes.

Rejilla de archivos

Cada fila en la rejilla devuelta muestra:

• Un checkbox — elige los archivos a subir.
• Módulo — uno de dock / aircraft / rc / psdk.
• Nombre de archivo — nombre interno del log DJI (con fecha, con un tag de módulo, .txt.gz típico).
• Tamaño — megabytes, un decimal.

Los logs de aeronave son con mucho los más grandes (el flight recorder puede ser 50–300 MB por vuelo). Empieza pequeño si estás en una conexión de dock con consumo limitado.

Paso 2 — Subir seleccionados

1. Marca los checkboxes de los archivos que quieras.
2. Haz clic en Subir seleccionados (N) — el recuento refleja tus selecciones.

ARGUS llama a POST /api/dji/docks/{sn}/logs/upload con los archivos agrupados, indexados por módulo. argus-dji publica el servicio DJI fileupload_start con una URL S3 presigned por archivo; el dock sube directamente a S3 (no a través de ARGUS). El progreso se espeja en dji_docks/{sn}.remoteLog.progress y se expone como una barra de progreso en la pestaña Debug.

Mientras corre una subida, la pestaña Debug muestra Subida: subiendo y un botón Cancelar.

Cancelar

Haz clic en Cancelar en cualquier momento. ARGUS llama a POST /api/dji/docks/{sn}/logs/cancel; argus-dji publica fileupload_cancel. El dock se detiene a mitad de archivo y cualquier subida S3 multipart es abortada por la regla del ciclo de vida.

Qué hay en cada módulo de log

• dock — transiciones de estado del motor de cubierta, marcas de tiempo del ciclo de carga, temperatura y humedad interna, MQTT keepalive / reconexión, eventos de módem celular, aprovisionamiento eSIM, ejecuciones de calibración RTK.
• aircraft — black-box de FlightRecorder (stream de telemetría comprimida de DJI — mismo formato que DJI Support pide), diagnósticos de salud IMU / compass / GPS, temperaturas de ESC / motor, cuentas de ciclo de pack de batería y curvas de descarga, calibración de gimbal, logs de exposición de cámara.
• rc — batería del controlador, calibración de sticks, eventos de lost-link. Vacío para aeronaves sólo-docked.
• psdk — tráfico de payload SDK de terceros; sólo poblado en docks con un altavoz, foco, searchlight o sensor personalizado adjunto.

Retención

Los logs del lado del dock rotan según la política local del dock — aproximadamente 14–30 días de logs de aeronave y 7 días de logs de dock antes de que la rotación de DJI los pode. Los logs subidos aterrizan en el bucket S3 de la organización bajo dji-logs/{dockSn}/{yyyymmdd}/{module}/ y se retienen durante 90 días por política de ciclo de vida. Extráelos en un ticket antes de que se cierre la ventana de retención.

Solución de problemas

• Refrescar devuelve vacío. No hay logs en ese módulo (p. ej. rc en un dock sin RC vinculado). Prueba un módulo diferente.
• La subida se bloquea en 0%. El dock no puede alcanzar S3 — verifica la red del dock en la pantalla física, confirma que la salida está abierta.
• La subida alcanza el 100% y luego failed. S3 rechazó el put (normalmente una expiración de la URL presigned durante un enlace muy lento). Vuelve a elegir los archivos y reintenta; la URL presigned se regenera cada intento.

Relacionado

• Firmware — cuándo extraer logs tras una actualización fallida.
• Tile del dock — panel de alertas HMS que a menudo motiva una extracción de log.
• Vinculación — prerrequisito.