> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/es/almacenamiento/vsan-diagnostics.md). # Guía de diagnósticos de vSAN ## Descripción general La herramienta de diagnósticos de vSAN proporciona análisis integral del sistema de almacenamiento y capacidades de resolución de problemas para las redes de área de almacenamiento virtuales de VergeOS. Estos comandos de diagnóstico permiten a los administradores del sistema supervisar el rendimiento del almacenamiento, solucionar problemas de almacenamiento y mantener un estado óptimo de vSAN en todo el clúster. {% hint style="info" %} **Lo que aprenderás** * Cómo acceder y usar las herramientas de diagnóstico de vSAN * Comprensión de cada comando de diagnóstico y su enfoque en el almacenamiento * Mejores prácticas para la resolución de problemas y el mantenimiento de vSAN * Cuándo usar comandos de diagnóstico específicos para problemas de almacenamiento {% endhint %} ## Requisitos previos * Acceso a la interfaz de VergeOS con privilegios de administración de vSAN * Comprensión básica de los conceptos de almacenamiento distribuido * Conocimiento de la arquitectura de vSAN de VergeOS {% hint style="info" %} **Acceso a vSAN** Los diagnósticos de vSAN solo están disponibles a nivel raíz/padre. Los inquilinos no tienen acceso a las herramientas de diagnóstico de vSAN. {% endhint %} ## Acceso a diagnósticos de vSAN 1. **Navegar a Diagnósticos de vSAN:** * Seleccione **Sistema** → **Diagnósticos de vSAN** en el menú superior. * O, alternativamente: Desde el Panel Principal, haga clic en el **Niveles de vSAN** cuadro de conteo → **Diagnósticos de vSAN** en el menú de la izquierda. 2. **Uso de comandos de diagnóstico:** * Seleccione el comando deseado en el **Consulta** menú desplegable * Configure los parámetros disponibles en el lado derecho * Haga clic en **Enviar →** para ejecutar el comando {% hint style="success" %} **Visibilidad del comando** Habilite **"Mostrar comando"** para ver el comando exacto que se está ejecutando, útil para la ejecución por SSH o la automatización de scripts. {% endhint %} ## Referencia de comandos de diagnóstico ### Buscar inodo **Propósito:** Localiza inodos específicos dentro del sistema de archivos de vSAN para un análisis detallado. **Cuándo usar:** * Solución de problemas de corrupción del sistema de archivos * Localización de bloques de datos específicos * Solución avanzada de problemas de almacenamiento **Parámetros:** * **Número de inodo:** Identificador de inodo específico para localizar **Sintaxis de CLI:** ```bash vcmd find --inode=[NÚMERO_DE_INODO] ``` *** ### Obtener información de caché **Propósito:** Muestra información y estadísticas completas del sistema de caché. **Cuándo usar:** * Optimización del rendimiento * Análisis de la relación de aciertos/fallos de caché * Evaluación del uso de memoria * Solución de problemas de rendimiento del almacenamiento **Sintaxis de CLI:** ```bash vcmd cache info ``` *** ### Obtener clientes **Propósito:** Muestra los clientes activos de vSAN y los detalles de su conexión. **Cuándo usar:** * Solución de problemas de conexión * Análisis del rendimiento del cliente * Verificación de conectividad de red * Evaluación de la distribución de carga **Sintaxis de CLI:** ```bash vcmd clients list ``` *** ### Obtener tasas del clúster **Propósito:** Muestra métricas de rendimiento y tasas de rendimiento de todo el clúster. **Cuándo usar:** * Supervisión del rendimiento del clúster * Análisis del rendimiento * Establecimiento de una línea base de rendimiento * Planificación de capacidad **Sintaxis de CLI:** ```bash vcmd cluster rates ``` *** ### Obtener uso del clúster **Propósito:** Muestra estadísticas completas de utilización del almacenamiento del clúster. **Cuándo usar:** * Planificación de capacidad * Supervisión de la utilización del almacenamiento * Análisis de la asignación de espacio * Evaluación de la tendencia de crecimiento **Sintaxis de CLI:** ```bash vcmd cluster usage ``` *** ### Obtener maestro actual **Propósito:** Identifica el nodo maestro actual de vSAN en el clúster. **Cuándo usar:** * Solución de problemas de liderazgo del clúster * Análisis de la conmutación por error del maestro * Problemas de coordinación del clúster * Optimización del rendimiento **Sintaxis de CLI:** ```bash vcmd master current ``` *** ### Obtener lista de dispositivos **Propósito:** Enumera todos los dispositivos de almacenamiento que participan en vSAN. **Cuándo usar:** * Gestión del inventario de dispositivos * Verificación de la configuración de almacenamiento * Supervisión del estado de los dispositivos * Evaluación de capacidad **Sintaxis de CLI:** ```bash vcmd devices list ``` *** ### Obtener estado del dispositivo **Propósito:** Muestra información detallada del estado de los dispositivos de almacenamiento de vSAN. **Cuándo usar:** * Supervisión del estado del dispositivo * Detección de fallos * Análisis de rendimiento * Planificación del mantenimiento **Parámetros:** * **ID del dispositivo:** Dispositivo específico a consultar **Sintaxis de CLI:** ```bash vcmd device status [ID_DE_DISPOSITIVO] ``` *** ### Obtener uso del dispositivo **Propósito:** Muestra estadísticas de uso de dispositivos de almacenamiento individuales. **Cuándo usar:** * Supervisión de la utilización del dispositivo * Análisis del balanceo de carga * Optimización del rendimiento * Evaluación del nivelado de desgaste **Parámetros:** * **ID del dispositivo:** Dispositivo objetivo para el análisis **Sintaxis de CLI:** ```bash vcmd device usage [ID_DE_DISPOSITIVO] ``` *** ### Obtener estado del archivo **Propósito:** Recupera información detallada del estado de archivos específicos en vSAN. **Cuándo usar:** * Verificación de la integridad de archivos * Comprobación del estado de replicación * Seguimiento de la ubicación de los datos * Investigación de corrupción **Parámetros:** * **Ruta del archivo:** Archivo objetivo para el análisis **Sintaxis de CLI:** ```bash vcmd file status [RUTA_DEL_ARCHIVO] ``` *** ### Obtener información de FUSE **Propósito:** Muestra información de montaje y funcionamiento de FUSE (Filesystem in Userspace). **Cuándo usar:** * Solución de problemas de montaje del sistema de archivos * Análisis del rendimiento de FUSE * Verificación del punto de montaje * Diagnóstico de problemas de acceso **Sintaxis de CLI:** ```bash vcmd fuse info ``` *** ### Obtener estado de comprobación de integridad **Propósito:** Muestra el estado de las operaciones de comprobación de integridad en curso o completadas. **Cuándo usar:** * Supervisión de la integridad de los datos * Seguimiento del proceso de verificación * Detección de corrupción * Comprobación del estado del mantenimiento **Sintaxis de CLI:** ```bash vcmd integcheck status ``` *** ### Obtener estado del journal **Propósito:** Muestra el estado del journal de vSAN y la información de operación. **Cuándo usar:** * Solución de problemas de rendimiento de escritura * Supervisión del espacio del journal * Análisis del registro de transacciones * Optimización del rendimiento **Sintaxis de CLI:** ```bash vcmd journal status ``` *** ### Obtener lista de dispositivos del nodo **Propósito:** Enumera los dispositivos de almacenamiento de nodos específicos del clúster. **Cuándo usar:** * Inventario de dispositivos específico del nodo * Planificación de capacidad por nodo * Análisis de la distribución de dispositivos * Preparación del mantenimiento del nodo **Parámetros:** * **ID del nodo:** Nodo objetivo para listar los dispositivos **Sintaxis de CLI:** ```bash vcmd node devices [ID_DEL_NODO] ``` *** ### Obtener información del nodo **Propósito:** Muestra información completa sobre nodos específicos de vSAN. **Cuándo usar:** * Evaluación del estado del nodo * Verificación de la configuración * Análisis de rendimiento * Solución de problemas de nodos **Parámetros:** * **ID del nodo:** Identificador del nodo objetivo **Sintaxis de CLI:** ```bash vcmd node info [ID_DEL_NODO] ``` *** ### Obtener lista de nodos **Propósito:** Enumera todos los nodos que participan en el clúster de vSAN. **Cuándo usar:** * Verificación de la pertenencia al clúster * Gestión del inventario de nodos * Análisis de la topología del clúster * Resumen del estado de salud **Sintaxis de CLI:** ```bash vcmd nodes list ``` *** ### Obtener ruta desde inodo **Propósito:** Resuelve rutas del sistema de archivos a partir de números de inodo. **Cuándo usar:** * Navegación del sistema de archivos * Asignación de inodo a ruta * Análisis de corrupción * Solución avanzada de problemas **Parámetros:** * **Número de inodo:** Inodo de origen para la resolución de la ruta **Sintaxis de CLI:** ```bash vcmd path from-inode [NÚMERO_DE_INODO] ``` *** ### Obtener read ahead **Propósito:** Muestra la configuración y las estadísticas de la caché de lectura anticipada (read-ahead). **Cuándo usar:** * Optimización del rendimiento de lectura * Ajuste de caché * Análisis del acceso secuencial * Solución de problemas de rendimiento **Sintaxis de CLI:** ```bash vcmd readahead status ``` *** ### Obtener estado de reparación **Propósito:** Muestra el estado de las operaciones de reparación en curso y la reconstrucción de datos. **Cuándo usar:** * Supervisión de la reparación de datos * Seguimiento del proceso de recuperación * Evaluación de la recuperación tras fallos * Comprobación del estado del mantenimiento **Sintaxis de CLI:** ```bash vcmd repair status ``` *** ### Obtener configuración en ejecución **Propósito:** Muestra la configuración en ejecución actual del sistema vSAN. **Cuándo usar:** * Verificación de la configuración * Solución de problemas de configuración * Referencia de la configuración de respaldo * Gestión de cambios **Sintaxis de CLI:** ```bash vcmd config show ``` *** ### Obtener lista de sincronización **Propósito:** Enumera las operaciones de sincronización y su estado. **Cuándo usar:** * Supervisión de la sincronización de datos * Seguimiento del estado de la replicación * Verificación de la consistencia * Análisis de rendimiento **Sintaxis de CLI:** ```bash vcmd sync list ``` *** ### Obtener mapas de dispositivos por nivel **Propósito:** Muestra la asignación de dispositivos en los distintos niveles de almacenamiento. **Cuándo usar:** * Verificación de la configuración de niveles * Análisis de la ubicación de los dispositivos * Optimización del rendimiento * Planificación de capacidad **Sintaxis de CLI:** ```bash vcmd tier device-maps ``` *** ### Obtener mapas de nodos por nivel **Propósito:** Muestra cómo se distribuyen los niveles de almacenamiento en los nodos del clúster. **Cuándo usar:** * Análisis de la distribución por niveles * Verificación del balanceo de carga * Optimización del rendimiento * Planificación de capacidad **Sintaxis de CLI:** ```bash vcmd tier node-maps ``` *** ### Obtener estado del nivel **Propósito:** Muestra información completa del estado de los niveles de almacenamiento. **Cuándo usar:** * Supervisión de la salud del nivel * Análisis de rendimiento * Seguimiento de la utilización de capacidad * Optimización del nivel **Sintaxis de CLI:** ```bash vcmd tier status ``` *** ### Obtener las tasas de uso principales **Propósito:** Identifica a los principales consumidores de recursos de almacenamiento y rendimiento. **Cuándo usar:** * Identificación de cuellos de botella de rendimiento * Análisis de utilización de recursos * Planificación de capacidad * Optimización del uso **Sintaxis de CLI:** ```bash vcmd usage top-rates ``` *** ### Obtener uso **Propósito:** Muestra estadísticas y métricas completas de uso de vSAN. **Cuándo usar:** * Supervisión general de la utilización del sistema * Planificación de capacidad * Establecimiento de una línea base de rendimiento * Análisis de la asignación de recursos **Sintaxis de CLI:** ```bash vcmd usage show ``` *** ### Obtener uso del volumen **Propósito:** Muestra estadísticas de uso de volúmenes individuales dentro de vSAN. **Cuándo usar:** * Supervisión de la capacidad específica del volumen * Análisis de rendimiento * Verificación de la asignación de espacio * Seguimiento del crecimiento **Parámetros:** * **ID del volumen:** Volumen objetivo para el análisis **Sintaxis de CLI:** ```bash vcmd volume usage [ID_DEL_VOLUMEN] ``` *** ### Comprobación de integridad **Propósito:** Inicia una comprobación integral de la integridad de los datos en todo vSAN. **Cuándo usar:** * Mantenimiento programado * Investigación de corrupción de datos * Comprobaciones preventivas de estado * Verificación posterior a fallos {% hint style="warning" %} **Impacto en el rendimiento** Las comprobaciones de integridad pueden afectar significativamente al rendimiento del sistema y deben programarse durante ventanas de mantenimiento. {% endhint %} **Sintaxis de CLI:** ```bash vcmd integcheck start ``` *** ### Comprobación de integridad del dispositivo **Propósito:** Realiza comprobaciones de integridad en dispositivos de almacenamiento específicos. **Cuándo usar:** * Verificación de integridad específica del dispositivo * Solución de problemas dirigida * Verificación posterior a la reparación * Mantenimiento selectivo **Parámetros:** * **ID del dispositivo:** Dispositivo objetivo para la comprobación de integridad **Sintaxis de CLI:** ```bash vcmd integcheck device [ID_DE_DISPOSITIVO] ``` *** ### Resumir el uso del disco **Propósito:** Proporciona un resumen completo del uso del disco en todo vSAN. **Cuándo usar:** * Generación de informes de capacidad * Análisis de tendencias de uso * Planificación de la optimización del almacenamiento * Informes ejecutivos **Sintaxis de CLI:** ```bash vcmd usage summarize ``` ## Mejores prácticas ### Flujo de trabajo de supervisión de la salud de vSAN 1. **Descripción general del sistema:** Comience con Obtener uso del clúster y Obtener tasas del clúster 2. **Análisis del rendimiento:** Revise Obtener las tasas de uso principales y las métricas específicas del dispositivo 3. **Evaluación del estado de salud:** Compruebe Obtener estado de reparación y Obtener estado de comprobación de integridad 4. **Planificación de capacidad:** Utilice Resumir el uso del disco e información de niveles 5. **Solución de problemas:** Emplee comandos específicos del dispositivo y del nodo según sea necesario ### Mantenimiento preventivo * **Comprobaciones periódicas de estado:** Supervise el uso del clúster, el estado de reparación y la salud de los dispositivos * **Supervisión del rendimiento:** Haga seguimiento de las tasas del clúster y de los patrones de uso principales * **Verificación de integridad:** Programe comprobaciones periódicas de integridad durante las ventanas de mantenimiento * **Planificación de capacidad:** Revise regularmente las tendencias de uso y los patrones de crecimiento ### Optimización del rendimiento * **Análisis de caché:** Supervise la información de caché y las tasas de aciertos para identificar oportunidades de optimización * **Gestión de niveles:** Revise los mapas de dispositivos por nivel y los mapas de nodos para una distribución equilibrada * **Balanceo de carga:** Utilice la información de clientes y uso para optimizar la distribución de la carga de trabajo * **Optimización de lectura:** Ajuste la configuración de read-ahead según los patrones de acceso ## Solución de problemas comunes de vSAN ### Problemas de rendimiento 1. Compruebe **Obtener tasas del clúster** y **Obtener las tasas de uso principales** para cuellos de botella 2. Revise **Obtener información de caché** para la eficiencia de la caché 3. Analice **Obtener uso del dispositivo** para el rendimiento de dispositivos individuales ### Problemas de capacidad 1. Use **Obtener uso del clúster** y **Resumir el uso del disco** para el análisis de espacio 2. Revise **Obtener estado del nivel** para la capacidad específica del nivel 3. Compruebe **Obtener uso del volumen** para el consumo individual de volúmenes ### Problemas de integridad de datos 1. Revise **Obtener estado de comprobación de integridad** para comprobaciones recientes de integridad 2. Compruebe **Obtener estado de reparación** para reparaciones en curso 3. Use **Obtener estado del archivo** para la verificación de la integridad de archivos específicos ### Problemas de salud del clúster 1. Verifique **Obtener maestro actual** para el estado de liderazgo 2. Compruebe **Obtener lista de nodos** y **Obtener información del nodo** para la salud del nodo 3. Revise **Obtener lista de sincronización** para problemas de sincronización ### Problemas de dispositivos 1. Use **Obtener lista de dispositivos** y **Obtener estado del dispositivo** para el estado del dispositivo 2. Compruebe **Obtener lista de dispositivos del nodo** para problemas de dispositivos específicos del nodo 3. Ejecutar **Comprobación de integridad del dispositivo** para posibles problemas del dispositivo ## Diagnósticos avanzados ### Análisis del sistema de archivos * Use **Buscar inodo** y **Obtener ruta desde inodo** para la investigación del sistema de archivos * Emplee **Obtener estado del archivo** para un análisis detallado de archivos * Compruebe **Obtener información de FUSE** para problemas relacionados con el montaje ### Gestión de la configuración * Revise **Obtener configuración en ejecución** para la configuración actual * Verifique las asignaciones de niveles y dispositivos con los comandos de mapeo * Cruce la información de nodos y dispositivos para comprobar la coherencia ### Ajuste del rendimiento * Analice las estadísticas de caché y read-ahead para la optimización * Supervise las conexiones de clientes y los patrones de uso * Revise el estado del journal para optimizar el rendimiento de escritura ## Próximos pasos Después de dominar los diagnósticos de vSAN, considere explorar: * Técnicas avanzadas de ajuste del rendimiento de vSAN * Sistemas automatizados de supervisión y alertas * Integración con herramientas externas de gestión del almacenamiento * Estrategias de recuperación ante desastres y copias de seguridad Para problemas complejos de vSAN o para orientación sobre optimización del rendimiento, contacte con [Soporte de VergeOS](/overview/es/support-and-services.md) con resultados de diagnóstico detallados e información de la configuración del sistema. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/run-the-platform/es/almacenamiento/vsan-diagnostics.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.