Introducción
Una vez que ha construido un sistema de búsqueda y lo ha puesto a disposición de los usuarios, se convierte en un sistema que «no se puede detener». Cuando los usuarios dependen de la búsqueda en su trabajo diario, cualquier tiempo de inactividad se traduce directamente en una interrupción del negocio.
Este artículo proporciona un manual práctico sobre monitorización, copias de seguridad y recuperación ante fallos para mantener Fess funcionando de forma fiable.
Audiencia objetivo
Administradores que operan Fess en un entorno de producción
Personas que desean garantizar la operación estable de un sistema de búsqueda
Personas con conocimientos básicos de operaciones de sistemas
Visión general de la operación
La operación estable de Fess se basa en los siguientes tres pilares:
Monitorización: Detectar problemas de forma temprana
Copias de seguridad: Proteger los datos
Recuperación ante fallos: Restaurar el servicio rápidamente cuando ocurren problemas
Monitorización
Health Check
Fess proporciona un endpoint de health check a través de la API REST.
En condiciones normales, devuelve HTTP 200. Al llamar periódicamente a este endpoint desde una herramienta de monitorización externa (como Nagios, Zabbix o Datadog), puede supervisar el estado operativo de Fess.
Consulta de información del sistema
Desde [Información del sistema] en la consola de administración, puede consultar la siguiente información.
Información de rastreo
Puede revisar los resultados de la última ejecución de rastreo (número de documentos procesados, número de errores, etc.). Utilice esta función para verificar que los rastreos se completan correctamente.
Información del sistema
Puede consultar las versiones de Fess y OpenSearch, el uso de memoria JVM, el número de documentos en el índice y más.
Métricas a monitorizar
Notificación de finalización de rastreo
Fess cuenta con una función que envía notificaciones cuando se detectan registros de error o fallos en el motor de búsqueda. Al configurar un Webhook para Slack o Google Chat, puede ser informado inmediatamente de cualquier anomalía.
Copias de seguridad
Objetos de copia de seguridad
Los objetos de copia de seguridad de un entorno Fess se dividen en dos categorías principales.
1. Datos de configuración
Incluye la configuración de rastreo, información de usuarios, datos de diccionario y otra información configurada a través de la consola de administración. Puede obtener una copia de seguridad de los datos de configuración desde [Información del sistema] > [Copia de seguridad] en la consola de administración de Fess.
2. Datos del índice
Es el índice de documentos recopilados mediante rastreo. Utilice la función de snapshots de OpenSearch para realizar la copia de seguridad del índice.
Estrategia de copias de seguridad
Automatización de la copia de seguridad de configuración
Puede automatizar la copia de seguridad de los datos de configuración utilizando la API de administración de Fess. Configúrelo como un trabajo del programador o ejecútelo como un trabajo cron externo.
Procedimiento de restauración
Es importante verificar el procedimiento de restauración con antelación para estar preparado en caso de fallo.
Detener Fess
Restaurar los datos de configuración (a través de la consola de administración o API)
Restaurar desde un snapshot de OpenSearch si es necesario
Iniciar Fess
Verificar el funcionamiento
Realice ensayos del procedimiento de restauración periódicamente para confirmar su exactitud y conocer el tiempo necesario.
Recuperación ante fallos
Fallos comunes y soluciones
Fess no arranca
Revise el archivo de log (logs/fess.log)
Memoria JVM insuficiente: Ajuste el parámetro
-XmxConflicto de puertos: Verifique si el puerto 8080 está siendo utilizado por otro proceso
Fallo de conexión con OpenSearch: Verifique que OpenSearch este en ejecución
El rastreo falla
Revise el registro de trabajos ([Información del sistema] > [Registro de trabajos])
Conectividad de red: Verifique la conectividad con el objetivo de rastreo
Error de autenticación: Verifique la validez de las credenciales (contraseña, token)
URLs con fallo: Consulte los detalles en [Información del sistema] > [URLs con fallo]
La búsqueda es lenta
Verifique el estado del clúster de OpenSearch (si está en yellow/red, se requiere acción)
Verifique el tamaño del índice (si ha crecido excesivamente)
Verifique el heap JVM (si la recolección de basura ocurre con frecuencia)
Si hay un rastreo en curso, verifique si el rendimiento mejora tras su finalización
Los resultados de búsqueda están desactualizados
Verifique el calendario de rastreo (si se ejecuta normalmente)
Verifique si el número máximo de accesos en la configuración de rastreo es insuficiente
Verifique si el sitio objetivo está bloqueando los rastreos (robots.txt)
Gestión de URLs con fallo
Las URLs a las que no se pudo acceder durante el rastreo se registran como «URLs con fallo». Puede revisarlas en [Información del sistema] > [URLs con fallo] en la consola de administración.
Si hay muchas URLs con fallo, verifique lo siguiente:
Si el servidor objetivo está caído
Si hay problemas con la ruta de red
Si las credenciales siguen siendo válidas
Si el intervalo de rastreo es demasiado corto, causando una carga excesiva en el servidor objetivo
Gestión de logs
Los archivos de log de Fess se generan en las siguientes ubicaciones:
Log de Fess:
logs/fess.log(Log de aplicación)Información de rastreo: [Información del sistema] > [Información de rastreo] en la consola de administración
Registro de trabajos: [Información del sistema] > [Registro de trabajos] en la consola de administración
Registro de búsqueda: [Información del sistema] > [Registro de búsqueda] en la consola de administración
Asegúrese de que la rotación de logs este configurada para evitar que los archivos de log crezcan excesivamente.
Lista de verificación operativa
A continuación se presenta una lista de verificación de los elementos que deben comprobarse durante las operaciones rutinarias.
Verificaciones diarias
¿Se completó el rastreo correctamente?
¿El health check devuelve resultados normales?
¿El uso de disco está por debajo del umbral?
Verificaciones semanales
Tasa de resultados vacíos en los registros de búsqueda (véase Parte 8)
Revisión y tratamiento de URLs con fallo
¿Se están realizando las copias de seguridad correctamente?
Verificaciones mensuales
Tendencias del tamaño del índice
Tendencias del uso de memoria JVM
Actualizaciones del diccionario (véase Parte 9)
Revisión de parches de seguridad
Resumen
Este artículo cubrió la monitorización, las copias de seguridad y la recuperación ante fallos para la operación estable de Fess.
Monitorización con la Health API y la consola de administración
Estrategia de copias de seguridad para datos de configuración y datos del índice
Patrones de fallos comunes y soluciones
Listas de verificación operativas diarias, semanales y mensuales
Para mantener la expectativa de que «la búsqueda simplemente funciona», establezca un marco operativo proactivo.
En el próximo artículo se tratarán patrones de integración con sistemas existentes utilizando la API de búsqueda.