Problemas y acciones correctivas¶
Esta página le indica las causas de los problemas frecuentes en LUC Analytics (LUCA) y las acciones que los corrigen.
Cada tabla tiene tres columnas. La columna Problema da el mensaje que muestra la aplicación o Docker, o lo que usted ve. El texto entre "comillas dobles" es el mensaje exacto. Un control o una etiqueta de la aplicación está en negrita. Una parte como {{code}} es un valor que la aplicación escribe en el mensaje.
Docker y el contenedor¶
Para los procedimientos completos, consulte 01-install-and-start.md.
| Problema | Causa | Acción |
|---|---|---|
docker run falla con un mensaje que indica que no pudo enlazar el puerto del host 127.0.0.1:8000. En Linux, el mensaje es address already in use. |
Otro programa usa el puerto 8000 de su portátil. Docker creó el contenedor, pero no lo inició. | 1. Escriba docker rm luc-analytics. 2. Escriba el comando docker run otra vez con un puerto del host diferente, por ejemplo -p 127.0.0.1:8080:8000. 3. En el enlace del registro, cambie 8000 por 8080. |
| "The container name "/luc-analytics" is already in use" (el nombre del contenedor ya está en uso) | Existe un contenedor de un comando docker run anterior. |
Inicie ese contenedor con docker start luc-analytics. O elimínelo con docker rm -f luc-analytics y escriba el comando docker run otra vez. El volumen y sus datos se conservan. |
| Docker Desktop se queda en "Engine starting" (el motor se está iniciando), o muestra un tiempo de espera agotado de WSL. | El motor de Docker o su máquina virtual WSL 2 no se inicia correctamente. | 1. Haga clic con el botón derecho en el icono de Docker en el área de notificación de la barra de tareas. 2. Seleccione Quit Docker Desktop (salir de Docker Desktop). 3. Inicie Docker Desktop otra vez. 4. Si el problema continúa, salga de Docker Desktop otra vez. 5. Escriba wsl --shutdown en PowerShell. 6. Inicie Docker Desktop otra vez. |
docker version no muestra ninguna parte Server (servidor). |
El motor de Docker no está iniciado. | Inicie Docker Desktop. Espere hasta que muestre Engine running (el motor está en funcionamiento). |
El contenedor se detiene inmediatamente. El registro, o la salida de docker run, contiene exec format error. |
La compilación de la imagen (amd64 o arm64) no corresponde al procesador de su portátil. | 1. Escriba $env:PROCESSOR_ARCHITECTURE en PowerShell. En un equipo Mac, escriba uname -m en Terminal. 2. Escriba docker image inspect luc-analytics --format "{{.Architecture}}". 3. Compare los dos valores. AMD64 corresponde a amd64. ARM64 corresponde a arm64. En un equipo Mac, x86_64 corresponde a amd64 y arm64 corresponde a arm64. 4. Si los valores no corresponden, obtenga el archivo de imagen de la compilación correcta (luc-analytics-beta-...-amd64.tar.gz o luc-analytics-beta-...-arm64.tar.gz). 5. Escriba docker rm luc-analytics. 6. Haga los pasos de "Cargar la imagen" en 01-install-and-start.md con el archivo correcto. 7. Inicie el contenedor otra vez con el comando docker run. |
| Configuración > Memoria muestra "No detectado en este host: introduzca el límite de memoria de esta máquina o VM." | La aplicación no puede encontrar el límite de memoria dentro de Docker Desktop. Además, es posible que Docker tenga muy poca memoria: de forma predeterminada, puede usar aproximadamente la mitad de la memoria del portátil. | 1. Dé a Docker 5 GB de memoria o más en el archivo .wslconfig. 2. Escriba wsl --shutdown e inicie Docker Desktop otra vez. 3. En Configuración > Memoria, escriba la memoria de Docker en Límite de memoria del host / VM (GB). 4. Cierre los otros programas grandes. |
| La aplicación no responde en el navegador. | El contenedor está detenido, o la aplicación tiene un problema. | 1. Escriba docker ps -a para ver si el contenedor está en funcionamiento. 2. Escriba docker logs luc-analytics para leer los mensajes de la aplicación. 3. Si el contenedor está detenido, escriba docker start luc-analytics. |
| La aplicación no responde después de iniciar Windows otra vez. | El contenedor no se inicia automáticamente. | Inicie Docker Desktop. Después, escriba docker start luc-analytics. |
Clave de acceso¶
ADVERTENCIA: No dé el enlace con la clave de acceso a otras personas. Una persona con el enlace puede usar la aplicación y su credencial de AWS.
| Problema | Causa | Acción |
|---|---|---|
| El navegador muestra "Se requiere la clave de acceso". | El navegador no tiene la clave de acceso. | 1. Escriba docker exec luc-analytics cat /data/state/access-key. 2. Abra http://localhost:8000/?access_key=<key>. Use la clave del paso 1. |
| El navegador muestra "Clave de acceso no disponible". La página dice que el servidor "ya no puede leerla (es posible que se haya eliminado su archivo de clave)". | El archivo de la clave no está en el volumen, o el servidor no puede leerlo. | Reinicie el contenedor con docker restart luc-analytics. La aplicación crea una clave nueva y escribe un enlace nuevo en el registro. Abra el enlace nuevo. |
Credencial de AWS (Comprobar credenciales)¶
Estos mensajes están en Configuración > Credenciales, después de pulsar Comprobar credenciales. Esta comprobación es gratuita. Para los ajustes, consulte 06-settings.md.
| Problema | Causa | Acción |
|---|---|---|
| "AWS rechazó esta credencial ({{code}}): el ID de clave de acceso o el secreto son incorrectos, o la clave no está activa. Siguiente: vuelva a introducir ambos y pulse de nuevo Comprobar credenciales." | El ID de clave de acceso de AWS o la clave secreta de acceso de AWS son incorrectos, o la clave de AWS no está activa. | Escriba los dos valores otra vez. Pulse Comprobar credenciales. |
| "No hay ninguna credencial de AWS introducida ni guardada. Siguiente: introduzca el ID de clave de acceso y el secreto y pulse Comprobar credenciales." | No hay ninguna credencial de AWS. | Escriba el ID de clave de acceso de AWS y la clave secreta de acceso de AWS. Pulse Comprobar credenciales. |
| "Existe una credencial guardada, pero no se pudo leer con la clave activa del almacén de secretos. Siguiente: vuelva a introducir el ID de clave de acceso y el secreto y guarde." | La clave del almacén cifrado cambió, o el almacén está dañado. | Escriba otra vez el ID de clave de acceso de AWS y la clave secreta de acceso de AWS. Pulse Guardar. |
| "No se pudo contactar con AWS STS (red o punto de conexión). Esto no dice nada de la credencial. Siguiente: vuelva a intentarlo." | No hay conexión de red, o AWS no responde. | Asegúrese de que el portátil tiene conexión a internet. Pulse Comprobar credenciales otra vez. |
| "AWS STS no respondió a tiempo. Esto no dice nada de la credencial. Siguiente: vuelva a intentarlo." | AWS no respondió en el tiempo permitido. | Pulse Comprobar credenciales otra vez. |
| "Introduzca tanto el ID de clave de acceso como la clave secreta de acceso, o ninguno." | Usted escribió solo uno de los dos valores. | Escriba los dos valores, o borre los dos campos. |
| "Primero compruebe las credenciales. Un par de claves que no superó la comprobación nunca se guarda." | Usted pulsó Guardar antes de una comprobación correcta. | Pulse Comprobar credenciales. Cuando la comprobación es correcta, pulse Guardar. |
Conexión del conjunto de datos (Probar conexión)¶
Estos mensajes están en una fuente de conjunto de datos, después de pulsar Probar conexión.
ADVERTENCIA: Probar conexión hace una solicitud al bucket de WRI. AWS envía el cargo de esta solicitud a su cuenta de AWS.
| Problema | Causa | Acción |
|---|---|---|
| "Su credencial está bien. La opción «Pago por solicitante» de este conjunto de datos está desactivada, por lo que la aplicación se niega a hacer una solicitud con cargo. Active «Pago por solicitante» arriba." | Pago por solicitante está desactivado. Sin este ajuste, la aplicación no hace ninguna solicitud que cueste dinero. | Active Pago por solicitante. Pulse Probar conexión otra vez. |
| "AWS rechazó esta credencial para este conjunto de datos. La clave puede haber sido revocada, puede ser incorrecta o puede no tener permiso. «Pago por solicitante» ya está activado, así que el problema es la credencial." | La credencial de AWS no es correcta, o no tiene permiso. | Pulse Comprobar credenciales. Si la comprobación falla, corrija la credencial de AWS. |
| "AWS rechazó esta credencial ({{code}}) — es la credencial, no la ubicación. Siguiente: pulse Comprobar credenciales." | AWS rechazó la credencial. | Pulse Comprobar credenciales. |
| "No se resolvió ninguna credencial de AWS para este conjunto de datos. Añada un ID de clave de acceso y una clave secreta arriba; luego guarde y pruebe de nuevo." | No hay ninguna credencial de AWS. | Escriba y guarde la credencial de AWS. Pulse Probar conexión otra vez. |
| "Existe una credencial almacenada, pero no se pudo leer con la clave activa del almacén de secretos. Vuelva a introducir el ID de clave de acceso y la clave secreta arriba y guarde." | La aplicación no puede descifrar la credencial guardada. | Escriba la credencial de AWS otra vez y guárdela. |
| "AccessDenied ({{code}}): la clave es válida, pero no tiene permiso para leer este bucket, o el bucket rechazó la solicitud de pago por solicitante. Siguiente: pulse Comprobar credenciales y luego haga la comprobación por CLI de abajo." | La clave de AWS es correcta, pero no tiene permiso para leer el bucket. | 1. Pulse Comprobar credenciales. 2. Haga la comprobación de Compruébelo usted mismo desde su propia terminal. 3. Dé a la clave de AWS el permiso para leer el bucket. |
| "No se pudo acceder al conjunto de datos (fallo de red o del punto de conexión). Esto no está relacionado con su credencial ni con la opción «Pago por solicitante»." | No hay conexión de red, o el punto de conexión no responde. | Asegúrese de que el portátil tiene conexión a internet. Pulse Probar conexión otra vez. |
| "La prueba de conexión agotó el tiempo de espera. El conjunto de datos no respondió dentro del tiempo permitido; probablemente se trate de un punto de conexión lento o inaccesible, no de su credencial ni de la opción «Pago por solicitante»." | El punto de conexión no respondió en el tiempo permitido. | Pulse Probar conexión otra vez más tarde. |
| "AWS respondió {{code}} para {{uri}}: no hay nada en esa ubicación. Siguiente: pulse Usar ruta del manifiesto ($, una solicitud facturada)." | La ruta S3 del conjunto de datos es incorrecta o antigua. | Pulse Usar ruta del manifiesto. Esto hace una solicitud que cuesta dinero. |
| "No existen objetos bajo {{uri}}: el bucket respondió, pero no hay nada guardado en ese prefijo. Siguiente: pulse Usar ruta del manifiesto ($, una solicitud facturada)." | No hay archivos en esa ruta S3. | Pulse Usar ruta del manifiesto. Esto hace una solicitud que cuesta dinero. |
| "La ubicación es accesible y está autorizada, pero no contiene un almacén Zarr legible." | La ruta S3 no contiene el conjunto de datos. | Corrija la ruta S3 del conjunto de datos. |
| "El bucket responde desde {{bucketRegion}}, no desde {{region}} — el bucket de WRI está en us-east-1. Siguiente: corrija datasets.upstream.region (o regions) en config.yaml." | La región de AWS de la configuración es incorrecta. | 1. Cambie datasets.upstream.region en /data/config.yaml a us-east-1. 2. Reinicie el contenedor. |
Credenciales de los proveedores de mapas base¶
Estos mensajes están en las tarjetas de Planet, Google Maps y Copernicus (CDSE) en Configuración > Credenciales, después de pulsar Probar conexión. El mensaje empieza con "Conexión fallida:".
| Problema | Causa | Acción |
|---|---|---|
| "El proveedor rechazó esta credencial. Compruebe el valor o que siga teniendo permiso." | La credencial es incorrecta, o no tiene permiso. | Escriba el valor correcto. Pulse Probar conexión otra vez. |
| "No se pudo acceder al proveedor (fallo de red o del punto de conexión). Esto no está relacionado con su credencial." | No hay conexión de red, o el proveedor no responde. | Asegúrese de que el portátil tiene conexión a internet. Pulse Probar conexión otra vez. |
| "El proveedor no respondió dentro del tiempo permitido. Probablemente se trate de un punto de conexión lento o inaccesible, no de su credencial." | El proveedor no respondió en el tiempo permitido. | Pulse Probar conexión otra vez más tarde. |
| "El proveedor está mal configurado en el servidor, por lo que no se pudo probar la credencial." | La configuración del servidor para este proveedor no es correcta. | Hable con la persona que instaló la aplicación. |
| "Pruebe primero la conexión. Una conexión fallida nunca se guarda." | Usted pulsó Guardar antes de una prueba correcta. | Pulse Probar conexión. Cuando la prueba es correcta, pulse Guardar. |
Cargar una lista¶
Para más información sobre las listas, consulte 02-lists.md.
| Problema | Causa | Acción |
|---|---|---|
| "Las cargas están desactivadas" | ingest.upload_enabled no es true en la configuración. Una instalación que usted actualizó conserva su archivo de configuración antiguo. |
1. Asegúrese de que la clave de acceso protege la aplicación. 2. Defina ingest.upload_enabled: true en /data/config.yaml. 3. Reinicie el contenedor. |
| "Tipo de archivo no compatible" | La aplicación no puede leer este tipo de archivo. La aplicación no acepta archivos KMZ (.kmz). |
Use un archivo CSV, Excel (.xlsx), GeoJSON, KML (.kml) o shapefile comprimido (.zip). Para usar un archivo KMZ, extraiga de él el archivo KML. |
| "Archivo demasiado grande" o "Demasiadas ubicaciones" | El archivo es mayor que el límite. | Divida el archivo en archivos más pequeños. Cargue cada archivo como una lista. |
| "Hoja de cálculo demasiado ancha" | Una fila de la hoja de cálculo tiene demasiadas columnas. | Elimine las columnas que no necesita. Cargue otra vez. |
| "No se encontraron ubicaciones" | El archivo no tiene filas. | Asegúrese de que el archivo tiene filas. |
| "No encontramos las columnas de ubicación" | La aplicación no puede encontrar las columnas con las coordenadas. | Use Cambiar la asignación de campos para seleccionar las columnas. |
| "Esa columna no está en su archivo" | Las correspondencias de columnas usan una columna que no está en el archivo. | Corrija las correspondencias de columnas. |
| "No hay ubicaciones válidas" | Las coordenadas no son correctas. | Corrija las coordenadas. |
| "No se pudo abrir el archivo comprimido" o "No se pudo leer el KML/KMZ" | El archivo está dañado. | Exporte el archivo otra vez desde su programa. Cárguelo otra vez. |
| "Las ubicaciones necesitan un tamaño" | El archivo tiene puntos sin tamaño. | Dé un tamaño (una superficie o un radio) para los puntos. |
| "Elija una unidad" | El tamaño no tiene unidad. | Seleccione Superficie o Radio. |
| "¿Qué proyección cartográfica?" o "Proyección no reconocida" | Las coordenadas no son latitud y longitud WGS 84. | Seleccione la proyección del archivo. |
| "Conjuntos de datos no disponibles" | Los conjuntos de datos no están disponibles en este momento. | Inténtelo otra vez más tarde. |
| "Carga interrumpida", "Carga vencida" o "Error al confirmar" | La carga no terminó. | Cargue el archivo otra vez. |
| "No se puede contactar con el servidor" | El navegador no puede conectarse a la aplicación. | Asegúrese de que el contenedor está en funcionamiento (docker ps -a). |
Exportaciones¶
Para más información sobre las exportaciones, consulte 05-exports.md.
| Problema | Causa | Acción |
|---|---|---|
| No puede pulsar Exportar ni ⬇ Descargar CSV. La información sobre herramientas muestra "La exportación CSV estará disponible cuando finalice el análisis de esta lista." | El análisis de la lista no está completo. | Espere hasta que el análisis de la lista está completo. Una lista con la etiqueta Incompleta después de Detener y confirmar no llega a estar completa. Para una lista así, exporte cada ubicación terminada. |
| "La exportación CSV estará disponible cuando finalice el análisis de esta lista." | El servidor rechazó una exportación de la lista, porque el análisis de la lista no está completo. | Espere hasta que el análisis de la lista está completo. Para una lista con la etiqueta Incompleta, exporte cada ubicación terminada. |
| "Exportación no disponible — aún no se ha analizado ninguna ubicación de esta lista, por lo que no hay nada para exportar." | Ninguna ubicación de la lista está terminada. | Espere hasta que el análisis está terminado. |
| "Exportación no disponible — el análisis de esta ubicación aún no ha finalizado. La exportación estará disponible cuando todos sus análisis estén completos." | Un análisis de esta ubicación no está terminado. | Espere hasta que cada análisis de la ubicación está terminado. |
| "El CSV se descargó, pero su archivo complementario «Datos usados» (las fechas de los conjuntos de datos de origen) no se pudo descargar." | El segundo archivo no se descargó. | Pulse el botón otra vez. |
| "Exportación PDF no disponible: aún no se ha analizado ninguna ubicación de esta lista." | Ninguna ubicación de la lista está terminada. | Espere hasta que el análisis está terminado. |
| "Exportación PDF no disponible: el mapa y las capas de análisis aún no están listos para capturar. Espere e inténtelo de nuevo." | El mapa no está dibujado por completo. | Espere hasta que el mapa está dibujado por completo. Pulse Descargar PDF otra vez. |
| "Exportación PDF no disponible: aún se espera: {{items}}. Espere e inténtelo de nuevo." | El mapa espera los elementos del mensaje, por ejemplo las teselas del mapa base. | Espere. Pulse Descargar PDF otra vez. Si las teselas no se cargaron, consulte Mapas más abajo. |
| "Error en la exportación PDF: no se pudo capturar la vista del mapa. Inténtelo de nuevo cuando el mapa haya terminado de dibujarse." | La aplicación no creó una imagen del mapa. | Espere hasta que el mapa está dibujado por completo. Pulse Descargar PDF otra vez. |
| "Error en la exportación PDF: no se pudo ensamblar el informe." o "Error en la exportación PDF: la solicitud de exportación no se completó. Inténtelo de nuevo." | La aplicación no creó el archivo PDF. | Pulse Descargar PDF otra vez. Si el problema continúa, lea la línea que empieza con "Causa:". |
| "No se pudieron cargar las fuentes de datos. Consulte DATA-ATTRIBUTION.md en el repositorio del proyecto." | La aplicación no obtuvo el texto de atribución. | Lea el archivo DATA-ATTRIBUTION.md. Abra Fuentes de datos y licencias otra vez más tarde. |
Mapas¶
Para más información sobre los mapas, consulte 04-maps.md.
| Problema | Causa | Acción |
|---|---|---|
| "No se pudo mostrar el mapa" | Ocurrió un error en el mapa. Las otras partes de la página siguen funcionando. | Inténtelo otra vez, o vuelva a cargar la página. |
| "No se pudieron cargar los datos de la cuadrícula del mapa." | La aplicación no obtuvo las capas de análisis para el mapa. | Vuelva a cargar la página. |
| "Se encontraron ubicaciones, pero los límites del mapa no son válidos y no se pueden mostrar." | Los límites de las ubicaciones no son correctos. | Examine las coordenadas de las ubicaciones. |
| "La comparación no está disponible: este mapa base no tiene fechas para elegir." | El mapa base no tiene fechas. | Seleccione un mapa base diferente. |
| "Las celdas nativas son más pequeñas que un píxel de pantalla a este zoom. Acerque el zoom para la resolución máxima." | Usted alejó el zoom demasiado para la resolución máxima. | Acerque el zoom. |
| "Este archivo no es JSON válido." o "Este no es un archivo de plantilla de la leyenda del mapa." | Usted seleccionó un archivo que no es una plantilla de la leyenda del mapa. | Seleccione un archivo .mpky que guardó desde la leyenda del mapa. |
Listas y resultados¶
| Problema | Causa | Acción |
|---|---|---|
| "No se pudieron cargar las listas" o "No se pudieron cargar los resultados" | La aplicación no puede leer la base de datos de resultados. | Vuelva a cargar la página. Si el problema continúa, lea la salida de docker logs luc-analytics. |
| "Lista no encontrada" | La lista no existe. Es posible que alguien la eliminó. | Vaya a la página de listas y seleccione una lista que existe. |
| "Esta ejecución no terminó: {{message}}" | Una ejecución nueva de la lista se detuvo. | Lea el mensaje. Corrija la causa. Después, pulse Volver a ejecutar con datos actuales. |
| "Esta actualización no terminó: {{message}}. Se conservan los resultados anteriores." | Una actualización de la lista se detuvo. La aplicación conserva los resultados anteriores. | Lea el mensaje. Inicie la actualización otra vez. |
| "Algo salió mal" | La página tuvo un error. | Inténtelo otra vez, o vuelva a cargar la página. |