> 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/administracion-del-sistema/node-diagnostics.md). # Guía de diagnósticos de nodo ## Descripción general La herramienta de diagnósticos del nodo proporciona capacidades integrales de resolución de problemas a nivel de hardware y sistema para nodos VergeOS individuales. Estos comandos de diagnóstico permiten a los administradores del sistema realizar un análisis detallado del hardware, supervisar el rendimiento del sistema y resolver problemas específicos del nodo directamente desde la interfaz de VergeOS. {% hint style="info" %} **Lo que aprenderás** * Cómo acceder y usar las herramientas de diagnóstico del nodo * Comprensión de cada comando de diagnóstico y su enfoque de hardware * Mejores prácticas para la resolución de problemas a nivel de nodo * Cuándo usar comandos de diagnóstico específicos para problemas de hardware {% endhint %} ## Requisitos previos * Acceso a la interfaz de VergeOS con privilegios de administración de nodos * Comprensión básica de los componentes de hardware del servidor * Conocimientos de conceptos de redes y almacenamiento {% hint style="info" %} **Acceso al nodo** Los diagnósticos del nodo proporcionan acceso profundo a nivel de hardware y deben ser utilizados por administradores de sistemas experimentados. {% endhint %} ## Acceso a diagnósticos del nodo 1. **Navegue hasta Diagnósticos del nodo:** * Seleccione **Infraestructura** > **Nodos** en el menú superior. * Seleccione el **nodo** deseado de la lista * Haga clic en **Diagnósticos** en el menú izquierdo 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 ### Escaneo ARP **Propósito:** Descubre dispositivos activos en las interfaces de red del nodo mediante paquetes ARP. **Cuándo usar:** * Verificación de la conectividad de red desde la perspectiva del nodo * Identificación de dispositivos en los segmentos de red locales del nodo * Solución de problemas de la configuración de red del nodo **Parámetros:** * **Interfaz:** Interfaz de red desde la que escanear **Sintaxis de CLI:** ```bash nmap -sn [RANGO_DE_RED] ``` *** ### Tabla ARP **Propósito:** Muestra la caché ARP del nodo con las asignaciones de dirección IP a MAC. **Cuándo usar:** * Solución de problemas de conectividad de red del nodo * Verificación del descubrimiento de vecinos de red * Comprobación de conflictos ARP que afectan al nodo **Sintaxis de CLI:** ```bash arp -a ``` *** ### Direcciones de puente **Propósito:** Muestra las tablas de direcciones MAC de los puentes de red del nodo. **Cuándo usar:** * Solución de problemas de la configuración del puente de red * Verificación del aprendizaje de MAC en los switches virtuales * Análisis de topología de red **Sintaxis de CLI:** ```bash brctl showmacs [NOMBRE_DEL_PUENTE] ``` *** ### Limpiar almacenamiento persistente **Propósito:** Borra las cachés de almacenamiento persistente y los datos temporales del nodo. **Cuándo usar:** * Resolución de problemas de rendimiento relacionados con el almacenamiento * Limpieza de datos de caché dañados * Preparación para la reconfiguración del almacenamiento {% hint style="danger" %} **Advertencia sobre impacto en los datos** Este comando puede afectar al rendimiento del sistema y solo debe usarse bajo la guía del soporte. {% endhint %} **Sintaxis de CLI:** ```bash sync && echo 3 > /proc/sys/vm/drop_caches ``` *** ### Tabla DMI **Propósito:** Muestra información de la Interfaz de Administración de Escritorio (DMI), incluidos los detalles de hardware. **Cuándo usar:** * Inventario e identificación de hardware * Verificación de las especificaciones del sistema * Solución de problemas de compatibilidad de hardware **Sintaxis de CLI:** ```bash dmidecode ``` *** ### Búsqueda DNS **Propósito:** Prueba la resolución DNS desde la perspectiva del nodo. **Cuándo usar:** * Solución de problemas de la configuración DNS del nodo * Verificación de la conectividad externa desde el nodo * Prueba de los servicios de resolución de nombres **Parámetros:** * **Nombre de host:** Nombre de host de destino para resolver * **Servidor DNS:** Servidor DNS específico que consultar **Sintaxis de CLI:** ```bash nslookup [NOMBRE_DE_HOST] dig [NOMBRE_DE_HOST] ``` *** ### Herramienta Ethernet **Propósito:** Proporciona información y configuración detalladas de la interfaz Ethernet. **Cuándo usar:** * Diagnóstico de problemas de la interfaz de red * Comprobación de la velocidad del enlace y los ajustes de dúplex * Solución de problemas de conectividad física de red **Parámetros:** * **Interfaz:** Interfaz de red a examinar **Sintaxis de CLI:** ```bash ethtool [INTERFAZ] ``` *** ### Configuración de la estructura **Propósito:** Muestra la configuración de la red fabric de VergeOS para el nodo. **Cuándo usar:** * Solución de problemas de comunicación entre nodos * Verificación de la configuración de la red fabric * Diagnóstico de problemas de conectividad del clúster **Sintaxis de CLI:** ```bash verge fabric show ``` *** ### IP **Propósito:** Acceso avanzado al comando IP para diagnósticos de interfaces y enrutamiento. **Cuándo usar:** * Análisis detallado de la interfaz de red * Examen de la tabla de enrutamiento * Solución avanzada de problemas de red **Parámetros:** * **Comando:** Opciones del comando IP (route, addr, link, etc.) **Sintaxis de CLI:** ```bash ip [COMANDO] [OPCIONES] ``` *** ### Información del BMC de IPMI **Propósito:** Muestra información del Controlador de Administración de la Placa Base. **Cuándo usar:** * Solución de problemas de administración de hardware * Verificación de la configuración de IPMI * Diagnósticos de administración remota **Sintaxis de CLI:** ```bash ipmitool bmc info ``` *** ### Estado del chasis de IPMI **Propósito:** Muestra el estado físico del chasis e información de energía. **Cuándo usar:** * Solución de problemas de administración de energía * Verificación del estado del hardware * Diagnósticos físicos del sistema **Sintaxis de CLI:** ```bash ipmitool chassis status ``` *** ### Información FRU de IPMI **Propósito:** Muestra información de la Unidad Reemplazable en Campo de IPMI. **Cuándo usar:** * Administración de inventario de hardware * Identificación de componentes * Información de garantía y soporte **Sintaxis de CLI:** ```bash ipmitool fru print ``` *** ### Información de LAN de IPMI **Propósito:** Muestra detalles de la configuración de red de IPMI. **Cuándo usar:** * Solución de problemas de red de IPMI * Problemas de conectividad de administración remota * Verificación de la configuración de red del BMC **Sintaxis de CLI:** ```bash ipmitool lan print ``` *** ### Reinicio de MC de IPMI **Propósito:** Reinicia el Controlador de Administración (BMC). **Cuándo usar:** * Resolución de problemas de comunicación de IPMI * Solución de problemas del BMC * Recuperación de la interfaz de administración {% hint style="warning" %} **Impacto en la administración** Esto interrumpirá temporalmente la funcionalidad de IPMI/BMC durante el reinicio. {% endhint %} **Sintaxis de CLI:** ```bash ipmitool mc reset cold ``` *** ### Repositorio de datos de sensores de IPMI **Propósito:** Muestra información completa del repositorio de datos de sensores. **Cuándo usar:** * Supervisión detallada del hardware * Verificación de la configuración de los sensores * Diagnóstico y análisis de hardware **Sintaxis de CLI:** ```bash ipmitool sdr list ``` *** ### Sensores de IPMI **Propósito:** Muestra las lecturas actuales de los sensores (temperatura, voltaje, ventiladores, etc.). **Cuándo usar:** * Supervisión del estado del hardware * Diagnósticos de temperatura y energía * Solución de problemas ambientales **Sintaxis de CLI:** ```bash ipmitool sensor list ``` *** ### Registros de eventos del sistema de IPMI **Propósito:** Muestra los registros de eventos del sistema de IPMI. **Cuándo usar:** * Análisis de errores de hardware * Solución de problemas de eventos del sistema * Investigación histórica de problemas de hardware **Sintaxis de CLI:** ```bash ipmitool sel list ``` *** ### Control de LED (unidad) **Propósito:** Controla los indicadores LED de las unidades de almacenamiento para su identificación física. **Cuándo usar:** * Identificación física de la unidad * Procedimientos de reemplazo de unidades * Tareas de mantenimiento de hardware **Parámetros:** * **Unidad:** Identificador de la unidad objetivo * **Acción:** LED encendido/apagado/parpadeo **Sintaxis de CLI:** ```bash ledctl locate=[RUTA_DE_LA_UNIDAD] ``` *** ### Registros **Propósito:** Muestra los registros del sistema del nodo y las entradas del journal. **Cuándo usar:** * Solución de problemas del sistema * Análisis de errores * Investigación de problemas de rendimiento **Sintaxis de CLI:** ```bash journalctl -n 100 dmesg ``` *** ### Bonding de red **Propósito:** Muestra la configuración y el estado del bonding de red. **Cuándo usar:** * Solución de problemas de redundancia de red * Diagnósticos de la interfaz bond * Verificación de agregación de enlaces **Sintaxis de CLI:** ```bash cat /proc/net/bonding/[NOMBRE_DEL_BOND] ``` *** ### Velocidad de OpenSSL **Propósito:** Prueba el rendimiento criptográfico de la CPU del nodo. **Cuándo usar:** * Evaluación comparativa del rendimiento * Prueba de capacidades criptográficas * Verificación de aceleración de hardware **Sintaxis de CLI:** ```bash openssl speed ``` *** ### Ping **Propósito:** Prueba la conectividad de red desde el nodo. **Cuándo usar:** * Prueba básica de conectividad * Verificación de la ruta de red * Medición de latencia **Parámetros:** * **Destino:** IP o nombre de host de destino * **Cantidad:** Número de paquetes ping **Sintaxis de CLI:** ```bash ping -c [CANTIDAD] [DESTINO] ``` *** ### Consulta RAS **Propósito:** Consulta información de fiabilidad, disponibilidad y mantenibilidad. **Cuándo usar:** * Evaluación de la fiabilidad del hardware * Estado de corrección de errores * Diagnósticos de memoria y procesador **Sintaxis de CLI:** ```bash ras-mc-ctl --summary ``` *** ### Prueba de diagnóstico S.M.A.R.T. **Propósito:** Inicia pruebas de diagnóstico SMART en las unidades de almacenamiento. **Cuándo usar:** * Pruebas proactivas del estado de la unidad * Solución de problemas de almacenamiento * Mantenimiento preventivo **Parámetros:** * **Unidad:** Unidad objetivo para la prueba * **Tipo de prueba:** Prueba corta, larga o de traslado **Sintaxis de CLI:** ```bash smartctl -t [TIPO_DE_PRUEBA] [RUTA_DE_LA_UNIDAD] ``` {% hint style="info" %} **Duración de la prueba** Las pruebas SMART pueden tardar bastante en completarse, especialmente las pruebas largas. {% endhint %} *** ### Información S.M.A.R.T. **Propósito:** Muestra atributos SMART e información de estado de las unidades. **Cuándo usar:** * Evaluación del estado de la unidad * Análisis predictivo de fallos * Supervisión del rendimiento del almacenamiento **Parámetros:** * **Unidad:** Identificador de la unidad objetivo **Sintaxis de CLI:** ```bash smartctl -a [RUTA_DE_LA_UNIDAD] ``` *** ### Mostrar dispositivos de bloque **Propósito:** Enumera todos los dispositivos de bloque visibles para el nodo. **Cuándo usar:** * Inventario de dispositivos de almacenamiento * Solución de problemas de reconocimiento de unidades * Verificación de la configuración de almacenamiento **Sintaxis de CLI:** ```bash lsblk fdisk -l ``` *** ### Prueba de conexión TCP **Propósito:** Prueba la conectividad TCP con hosts y puertos remotos. **Cuándo usar:** * Verificación de conectividad de servicios * Prueba de reglas de firewall * Solución de problemas de red **Parámetros:** * **Host:** Nombre de host o IP de destino * **Puerto:** Número de puerto TCP **Sintaxis de CLI:** ```bash telnet [HOST] [PUERTO] nc -zv [HOST] [PUERTO] ``` *** ### Captura TCP **Propósito:** Captura paquetes de red para un análisis detallado del tráfico. **Cuándo usar:** * Solución de problemas de red * Análisis de seguridad * Depuración de protocolos **Parámetros:** * **Interfaz:** Interfaz de red a supervisar * **Filtro:** Expresión de filtro de paquetes **Sintaxis de CLI:** ```bash tcpdump -i [INTERFAZ] [FILTRO] ``` {% hint style="warning" %} **Impacto en el rendimiento** La captura de paquetes puede afectar al rendimiento del nodo. Úsela con cuidado en producción. {% endhint %} *** ### Mayor uso de CPU **Propósito:** Muestra los procesos que consumen más recursos de CPU. **Cuándo usar:** * Solución de problemas de rendimiento * Análisis de utilización de recursos * Supervisión de procesos **Sintaxis de CLI:** ```bash top -o %CPU ``` *** ### Mayor uso de red **Propósito:** Muestra los procesos con mayor utilización de red. **Cuándo usar:** * Análisis del rendimiento de la red * Solución de problemas de utilización del ancho de banda * Identificación de procesos con uso intensivo de red **Sintaxis de CLI:** ```bash iftop nethogs ``` *** ### Seguimiento de ruta **Propósito:** Traza la ruta de red desde el nodo hasta un destino. **Cuándo usar:** * Solución de problemas de enrutamiento de red * Análisis de ruta * Diagnóstico de problemas de conectividad **Parámetros:** * **Destino:** IP o nombre de host de destino **Sintaxis de CLI:** ```bash traceroute [DESTINO] mtr [DESTINO] ``` *** ### Cuál es mi IP **Propósito:** Muestra la dirección IP externa del nodo. **Cuándo usar:** * Verificación de conectividad externa * Solución de problemas de configuración de NAT * Validación de la configuración de red **Sintaxis de CLI:** ```bash curl ifconfig.me ``` ## Mejores prácticas ### Flujo de trabajo de diagnóstico de hardware 1. **Descripción general del sistema:** Comience con la tabla DMI y el estado del chasis IPMI 2. **Comprobación de estado:** Revise los sensores de IPMI y los registros de eventos del sistema 3. **Análisis de almacenamiento:** Use la información y las pruebas S.M.A.R.T. 4. **Verificación de red:** Compruebe el bonding de red y el estado de la interfaz 5. **Evaluación del rendimiento:** Supervise el uso de CPU y red ### Mantenimiento preventivo * **Comprobaciones periódicas de estado:** Supervise los sensores de IPMI y los datos SMART * **Revisión de registros:** Revise periódicamente los registros de eventos del sistema * **Supervisión del rendimiento:** Realice un seguimiento de las tendencias de uso de CPU y red * **Estado de la unidad:** Programe pruebas de diagnóstico SMART periódicas ### Consideraciones de seguridad * **Evaluación del impacto:** Considere el impacto de los comandos de diagnóstico en los sistemas de producción * **Coordinación con soporte:** Involucre al soporte de VergeOS para problemas de hardware complejos * **Documentación:** Mantenga registros de los resultados de diagnóstico para el análisis de tendencias * **Control de cambios:** Siga los procedimientos de gestión de cambios para modificaciones de hardware ## Solución de problemas comunes del nodo ### Problemas de hardware 1. Compruebe **Sensores de IPMI** para problemas de temperatura, voltaje y ventiladores 2. Revise **Registros de eventos del sistema de IPMI** para errores de hardware 3. Use **Información S.M.A.R.T.** para evaluar el estado de la unidad ### Problemas de red 1. Verifique **Bonding de red** estado y configuración 2. Use **Herramienta Ethernet** para verificar la configuración de la interfaz 3. Probar conectividad con **Ping** y **Seguimiento de ruta** ### Problemas de rendimiento 1. Supervise **Mayor uso de CPU** para restricciones de recursos 2. Compruebe **Mayor uso de red** para la utilización del ancho de banda 3. Revise **Registros** para errores relacionados con el rendimiento ### Problemas de almacenamiento 1. Use **Mostrar dispositivos de bloque** para verificar el reconocimiento de la unidad 2. Ejecutar **Pruebas de diagnóstico S.M.A.R.T.** para pruebas completas de la unidad 3. Compruebe **Consulta RAS** para información sobre errores de memoria y almacenamiento ## Próximos pasos Después de dominar los diagnósticos del nodo, considere explorar: * Supervisión y alertas avanzadas de hardware * Scripting de diagnóstico automatizado * Integración con sistemas de supervisión externos * Programación de mantenimiento preventivo Para problemas de hardware complejos o resultados de diagnóstico inusuales, póngase en contacto con [Soporte de VergeOS](/overview/es/support-and-services.md) con la salida detallada del diagnóstico y la informació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/administracion-del-sistema/node-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.