Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Solucionar problemas de implementación mongot

El operador de controladores de MongoDB para Kubernetes implementa mongot como un proceso independiente en su propio Pod, definido por un recurso MongoDBSearch. Los clientes nunca se conectan directamente a mongot: las consultas de MongoDB Search y Vector Search se ejecutan en mongod, que las envía a mongot. mongot se vuelve a conectar a mongod para transmitir eventos de cambio y compilar sus índices en un volumen persistente dedicado.

Esta página describe cómo diagnosticar y resolver problemas comunes de tiempo de ejecución con una implementación de mongot. Para la solución de problemas específica de la creación de índices durante la configuración inicial, consulte Utilice MongoDB Search y búsqueda vectorial. Para configurar las métricas y el registro antes de investigar, consulte Supervise su implementación.

Los procedimientos de esta página asumen que ha establecido las siguientes variables de entorno para que coincidan con su implementación:

export MDB_NS="<your-namespace>"export K8S_CTX="<your-kubectl-context>"export MDB_RESOURCE_NAME="<your-mongodbsearch-resource-name>"

Antes de trabajar en un escenario específico, recopila el estado actual del pod mongot, sus registros y los eventos recientes de Kubernetes:

# Check the status and restart count of the mongot podkubectl get pods -n ${MDB_NS} --context ${K8S_CTX} | grep search # Review the most recent mongot logskubectl logs statefulset/${MDB_RESOURCE_NAME}-search-0 \ -n ${MDB_NS} --context ${K8S_CTX} --tail=100 # Inspect the MongoDBSearch resource status and conditionskubectl describe mongodbsearch ${MDB_RESOURCE_NAME} \ -n ${MDB_NS} --context ${K8S_CTX} # List recent events in the namespacekubectl get events -n ${MDB_NS} --context ${K8S_CTX} \ --sort-by='.lastTimestamp'

Si el pod se reinicia en un bucle, consulte los registros de la instancia de contenedor anterior para capturar el error que provocó el reinicio:

kubectl logs statefulset/${MDB_RESOURCE_NAME}-search-0 \ -n ${MDB_NS} --context ${K8S_CTX} --previous

Síntomas: El pod mongot permanece en Pending, ContainerCreating o Error y nunca llega a Running, o el recurso MongoDBSearch no alcanza el estado Running.

Diagnosticar: ejecute los comandos en Recopilar información de diagnóstico y revise los eventos del pod y el estado MongoDBSearch. Los indicadores comunes incluyen errores de cronograma, errores de montaje de volumen y errores de extracción de imágenes.

Resolver:

  • Si el pod no se puede programar, confirme que haya un nodo con suficiente CPU y memoria disponible y que su StorageClass pueda vincular la Persistent Volume Claim solicitada. Para obtener más información sobre el dimensionamiento de mongot, consulte Planificación y dimensionamiento de recursos de búsqueda y búsqueda vectorial.

  • Si falta la clave secreta de la contraseña para el usuario search-sync-source, créela. El recurso MongoDBSearch espera una clave secreta denominada ${MDB_RESOURCE_NAME}-search-sync-source-password.

  • Si no se puede extraer la imagen del contenedor mongot, verifique el nombre de la imagen y sus credenciales de registro. Verifique si hay errores de extracción de imágenes con kubectl get events -n ${MDB_NS} | grep -i pull.

  • Si el set de réplicas de origen mongod no está en el estado Running, resuelva ese problema primero. El operador de Kubernetes de los controladores de MongoDB espera el recurso de origen antes de implementar mongot.

Síntomas: $search, $searchMeta o $vectorSearch queries fallan con un error que indica que mongod no puede llegar al servicio de búsqueda.

Diagnosticar: Confirme que el pod mongot es Running y que su servicio existe:

kubectl get pods,svc -n ${MDB_NS} --context ${K8S_CTX} \ | grep search

Revise los registros mongot en busca de errores de conexión o autenticación, y revise los registros mongod en busca de errores que hagan referencia al host de búsqueda.

Resolver:

Síntomas: El pod mongot muestra un recuento de reinicios alto o informa CrashLoopBackOff.

Diagnosticar: vea los registros de la instancia de contenedor anterior para capturar el error que activó el reinicio:

kubectl logs statefulset/${MDB_RESOURCE_NAME}-search-0 \ -n ${MDB_NS} --context ${K8S_CTX} --previous

Compruebe el último estado del pod y el motivo de salida:

kubectl describe pod ${MDB_RESOURCE_NAME}-search-0-0 \ -n ${MDB_NS} --context ${K8S_CTX}

Resolver:

  • Si el motivo de salida es OOMKilled, aumenta los recursos de memoria para mongot. Consulta mongot se queda sin memoria.

  • Si los registros muestran un error de configuración o autenticación, corrija la configuración y deje que los controladores de MongoDB para el operador de Kubernetes concilien el cambio.

  • Si los registros muestran que mongot no puede leer ni guardar sus datos de índice, confirme que la reclamación de volumen persistente está vinculada y se puede guardar. Consulte El pod mongot no se inicia.

Síntomas: El pod mongot se termina con un motivo OOMKilled y el recuento de reinicios aumenta.

Diagnosticar: Confirme el motivo de la terminación del pod:

kubectl describe pod ${MDB_RESOURCE_NAME}-search-0-0 \ -n ${MDB_NS} --context ${K8S_CTX}

mongot es una carga de trabajo asignada a la memoria basada en Lucene. La presión de la memoria suele deberse a límites de memoria insuficientes en relación con el tamaño del índice y la carga de queries.

Resolver:

Síntomas: Los índices recién creados permanecen en estado de compilación durante mucho tiempo, o los resultados de las query se retrasan con respecto a las guardadas recientes en mongod.

Diagnosticar: revise los registros de mongot para ver el progreso de la replicación y los errores. Utilice las métricas que configuró en Supervisar su implementación para rastrear el progreso de la creación de índices y el atraso de la replicación a lo largo del tiempo.

Resolver:

  • Permita que se complete la sincronización inicial. El tiempo para compilar un índice se escala con el tamaño de los datos de origen.

  • Si el retraso persiste bajo una carga constante, es posible que la instancia mongot no tenga recursos suficientes para el volumen de guardado. Revisa Planificación y dimensionamiento de recursos de búsqueda y búsqueda vectorial.

  • Confirme que el rendimiento del almacenamiento cumple con las recomendaciones para una carga de trabajo de Lucene con muchas lecturas aleatorias. El almacenamiento lento es una causa común de retraso sostenido.

Síntomas: Los registros de mongot muestran errores de enlace TLS o de validación de certificados, y mongod no puede establecer una conexión con mongot.

Diagnóstico: Revisión el registro mongot para detectar errores de certificado y confirme que los secretos TLS a los que hace referencia el recurso MongoDBSearch existen:

kubectl get secrets -n ${MDB_NS} --context ${K8S_CTX} \ | grep -i tls

Resolver:

  • Confirme que mongod y mongot confían en la misma CA.

  • Después de reemplazar o rotar un certificado, reinicie mongot para que lea el nuevo certificado. mongot lee los certificados al iniciar y no los vuelve a cargar mientras se ejecuta.

  • Para obtener más información, consulte Proteja la conexión de MongoDB a Search.

Nota

La incrustación automatizada es una funcionalidad de vista previa y solo se integra con los modelos de Voyage AI.

Síntomas: Los índices que utilizan la incrustación automatizada no se compilan o las solicitudes de incrustación devuelven errores en los registros mongot.

Diagnosticar: revise los registros de mongot en busca de errores que hagan referencia al proveedor de incrustación, como fallas de autenticación o tiempos de espera de solicitudes.

Resolver:

  • Verifique que su clave de API de Voyage AI sea válida y que el secreto que la contiene exista en el namespace.

  • Confirme que mongot puede llegar al punto de conexión del proveedor de incrustación desde su clúster de Kubernetes.

Si se pone en contacto con el soporte de MongoDB, incluya los registros de mongot, la descripción del recurso de MongoDBSearch y los eventos recientes del namespace:

kubectl logs statefulset/${MDB_RESOURCE_NAME}-search-0 \ -n ${MDB_NS} --context ${K8S_CTX} > mongot.log kubectl describe mongodbsearch ${MDB_RESOURCE_NAME} \ -n ${MDB_NS} --context ${K8S_CTX} > mongodbsearch-describe.txt kubectl get events -n ${MDB_NS} --context ${K8S_CTX} \ --sort-by='.lastTimestamp' > events.txt

También puede incluir archivos FTDC de cada pod de búsqueda afectado. mongot guardar archivos FTDC en /mongot/data/diagnostic.data/ dentro del pod.

La ruta /mongot/data es un PersistentVolumeClaim que el operador de Kubernetes monta en el pod a través de un volumeClaimTemplate en el StatefulSet de búsqueda, por lo que los datos de diagnóstico persisten en los reinicios del pod. Cuando se reemplaza un pod, el StatefulSet vuelve a adjuntar el mismo PersistentVolumeClaim, por lo que se conservan los datos de diagnóstico.

Copie los datos FTDC del pod de búsqueda en su máquina local. Para los clústeres particionados, copie los datos FTDC de cada pod de búsqueda por partición en su máquina local. Repita para cada partición:

kubectl cp -n ${MDB_NS} --context ${K8S_CTX} \ ${MDB_SEARCH_RESOURCE_NAME}-search-0-${MDB_EXTERNAL_SHARD_0_NAME}-0:/mongot/data/diagnostic.data \ ./mongot-diagnostic.data-${MDB_EXTERNAL_SHARD_0_NAME}