> 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óstico de nodos

Referencia completa de las herramientas de diagnóstico de nodos de VergeOS, incluidos comandos IPMI, pruebas SMART, diagnósticos de red, configuración de fabric y resolución de problemas de hardware.

## Descripción general

La herramienta de diagnóstico de nodos de Node proporciona funciones completas de diagnóstico y resolución de problemas de hardware y del sistema para nodos individuales de VergeOS. Estos comandos de diagnóstico permiten a los administradores del sistema analizar el hardware en detalle, supervisar el rendimiento del sistema y resolver problemas específicos de cada nodo directamente desde la interfaz de VergeOS.

{% hint style="info" %}
**Qué aprenderás**

* Cómo acceder a las herramientas de diagnóstico de nodos y utilizarlas
* Comprender cada comando de diagnóstico y su enfoque en el hardware
* Prácticas recomendadas para resolver problemas a nivel de nodo
* Cuándo utilizar 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
* Conocimientos básicos de los componentes de hardware de un servidor
* Conocimientos de conceptos de redes y almacenamiento

{% hint style="info" %}
**Acceso a los nodos**

Los diagnósticos de nodos proporcionan acceso profundo a nivel de hardware y deben ser utilizados por administradores de sistemas con experiencia.
{% endhint %}

## Acceso a los diagnósticos de nodos

1. **Ve a Diagnósticos de nodos:**
   * Selecciona **Infraestructura** > **Nodos** en el menú superior.
   * Selecciona el **node** de la lista
   * Haz clic en **Diagnósticos** en el menú de la izquierda
2. **Uso de los comandos de diagnóstico:**
   * Selecciona el comando deseado del **Consulta** menú desplegable
   * Configura los parámetros disponibles en el lado derecho
   * Haz clic **Enviar →** para ejecutar el comando

{% hint style="success" %}
**Visibilidad de comandos**

Habilitar **«Mostrar comando»** para ver el comando exacto que se está ejecutando; resulta útil para ejecutar comandos por SSH o automatizar scripts.
{% endhint %}

## Referencia de comandos de diagnóstico

### Escaneo ARP

**Propósito:** Detecta dispositivos activos en las interfaces de red del nodo mediante paquetes ARP.

**Cuándo usarlo:**

* Verificar la conectividad de red desde la perspectiva del nodo
* Identificar dispositivos en los segmentos de red local del nodo
* Solucionar problemas de configuración de red del nodo

**Parámetros:**

* **Interfaz:** Interfaz de red desde la que realizar el análisis

**Sintaxis de la CLI:**

```bash
nmap -sn [NETWORK_RANGE]
```

***

### Tabla ARP

**Propósito:** Muestra la caché ARP del nodo, con las correspondencias entre direcciones IP y MAC.

**Cuándo usarlo:**

* Solución de problemas de conectividad de red del nodo
* Verificación de la detección de vecinos de red
* Comprobación de conflictos ARP que afectan al nodo

**Sintaxis de la CLI:**

```bash
arp -a
```

***

### Direcciones de puente

**Propósito:** Muestra las tablas de direcciones MAC de los puentes de red del nodo.

**Cuándo usarlo:**

* Solución de problemas de la configuración del puente de red
* Verificación del aprendizaje de direcciones MAC en los conmutadores virtuales
* Análisis de la topología de red

**Sintaxis de la CLI:**

```bash
brctl showmacs [BRIDGE_NAME]
```

***

### Borrar el almacenamiento persistente

**Propósito:** Borra las cachés del almacenamiento persistente y los datos temporales del nodo.

**Cuándo usarlo:**

* Solución de problemas de rendimiento relacionados con el almacenamiento
* Borrado de datos de caché dañados
* Preparación para reconfigurar el almacenamiento

{% hint style="danger" %}
**Advertencia sobre el impacto en los datos**

Este comando puede afectar al rendimiento del sistema y solo debe utilizarse siguiendo las indicaciones del equipo de soporte.
{% endhint %}

**Sintaxis de la CLI:**

```bash
sync && echo 3 > /proc/sys/vm/drop_caches
```

***

### Tabla DMI

**Propósito:** Muestra información de la interfaz de administración del escritorio (DMI), incluidos detalles del hardware.

**Cuándo usarlo:**

* Inventario e identificación del hardware
* Verificación de las especificaciones del sistema
* Solución de problemas de compatibilidad del hardware

**Sintaxis de la CLI:**

```bash
dmidecode
```

***

### Búsqueda DNS

**Propósito:** Prueba la resolución DNS desde la perspectiva del nodo.

**Cuándo usarlo:**

* 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 que se resolverá
* **Servidor DNS:** Servidor DNS específico al que se enviará la consulta

**Sintaxis de la CLI:**

```bash
nslookup [HOSTNAME]
dig [HOSTNAME]
```

***

### Herramienta de Ethernet

**Propósito:** Proporciona información detallada y configuración de la interfaz Ethernet.

**Cuándo usarlo:**

* Diagnóstico de problemas de la interfaz de red
* Comprobación de la velocidad del enlace y la configuración dúplex
* Solución de problemas de conectividad física de red

**Parámetros:**

* **Interfaz:** Interfaz de red que se examinará

**Sintaxis de la CLI:**

```bash
ethtool [INTERFACE]
```

***

### Configuración de fabric

**Propósito:** Muestra la configuración de la red fabric de VergeOS para el nodo.

**Cuándo usarlo:**

* 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 la CLI:**

```bash
verge fabric show
```

***

### IP

**Propósito:** Acceso avanzado a los comandos de IP para diagnosticar interfaces y rutas.

**Cuándo usarlo:**

* Análisis detallado de las interfaces 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 la CLI:**

```bash
ip [COMMAND] [OPTIONS]
```

***

### Información del BMC de IPMI

**Propósito:** Muestra información del controlador de administración de la placa base.

**Cuándo usarlo:**

* Solución de problemas de administración del hardware
* Verificación de la configuración de IPMI
* Diagnóstico de la administración remota

**Sintaxis de la CLI:**

```bash
ipmitool bmc info
```

***

### Estado del chasis de IPMI

**Propósito:** Muestra el estado físico del chasis y la información de alimentación.

**Cuándo usarlo:**

* Solución de problemas de administración de energía
* Verificación del estado del hardware
* Diagnóstico del sistema físico

**Sintaxis de la CLI:**

```bash
ipmitool chassis status
```

***

### Información de FRU de IPMI

**Propósito:** Muestra información de las unidades reemplazables en campo (FRU) obtenida mediante IPMI.

**Cuándo usarlo:**

* Administración del inventario de hardware
* Identificación de componentes
* Información de garantía y soporte

**Sintaxis de la CLI:**

```bash
ipmitool fru print
```

***

### Información de LAN de IPMI

**Propósito:** Muestra los detalles de la configuración de red de IPMI.

**Cuándo usarlo:**

* Solución de problemas de red de IPMI
* Problemas de conectividad de la administración remota
* Verificación de la configuración de red del BMC

**Sintaxis de la CLI:**

```bash
ipmitool lan print
```

***

### Restablecimiento del MC de IPMI

**Propósito:** Restablece el controlador de administración (BMC).

**Cuándo usarlo:**

* 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 la CLI:**

```bash
ipmitool mc reset cold
```

***

### Repositorio de datos de sensores de IPMI

**Finalidad:** Muestra información completa del repositorio de datos de sensores.

**Cuándo usarlo:**

* Supervisión detallada del hardware
* Verificación de la configuración de los sensores
* Diagnóstico y análisis del hardware

**Sintaxis de la CLI:**

```bash
ipmitool sdr list
```

***

### Sensores IPMI

**Finalidad:** Muestra las lecturas actuales de los sensores (temperatura, voltaje, ventiladores, etc.).

**Cuándo usarlo:**

* Supervisión del estado del hardware
* Diagnóstico de temperatura y alimentación
* Solución de problemas ambientales

**Sintaxis de la CLI:**

```bash
ipmitool sensor list
```

***

### Registros de eventos del sistema IPMI

**Finalidad:** Muestra los registros de eventos del sistema de IPMI.

**Cuándo usarlo:**

* Análisis de errores del hardware
* Solución de problemas relacionados con eventos del sistema
* Investigación de problemas históricos del hardware

**Sintaxis de la CLI:**

```bash
ipmitool sel list
```

***

### Control de LED (unidad)

**Finalidad:** Controla los indicadores LED de las unidades de almacenamiento para identificarlas físicamente.

**Cuándo usarlo:**

* Identificación física de unidades
* Procedimientos de reemplazo de unidades
* Tareas de mantenimiento del hardware

**Parámetros:**

* **Unidad:** Identificador de la unidad de destino
* **Acción:** LED encendido/apagado/intermitente

**Sintaxis de la CLI:**

```bash
ledctl locate=[DRIVE_PATH]
```

***

### Registros

**Finalidad:** Muestra los registros del sistema del nodo y las entradas del diario.

**Cuándo usarlo:**

* Solución de problemas del sistema
* Análisis de errores
* Investigación de problemas de rendimiento

**Sintaxis de la CLI:**

```bash
journalctl -n 100
dmesg
```

***

### Agrupación de interfaces de red

**Finalidad:** Muestra la configuración y el estado de la agrupación de interfaces de red.

**Cuándo usarlo:**

* Solución de problemas de redundancia de red
* Diagnóstico de interfaces agrupadas
* Verificación de la agregación de enlaces

**Sintaxis de la CLI:**

```bash
cat /proc/net/bonding/[BOND_NAME]
```

***

### Velocidad de OpenSSL

**Propósito:** Prueba el rendimiento criptográfico de la CPU del nodo.

**Cuándo usarlo:**

* Evaluación comparativa del rendimiento
* Pruebas de capacidad criptográfica
* Verificación de la aceleración por hardware

**Sintaxis de la CLI:**

```bash
openssl speed
```

***

### Ping

**Propósito:** Prueba la conectividad de red desde el nodo.

**Cuándo usarlo:**

* Pruebas básicas de conectividad
* Verificación de la ruta de red
* Medición de la latencia

**Parámetros:**

* **Destino:** IP o nombre de host de destino
* **Cantidad:** Número de paquetes ping

**Sintaxis de la CLI:**

```bash
ping -c [COUNT] [DESTINATION]
```

***

### Consulta RAS

**Propósito:** Consulta información sobre fiabilidad, disponibilidad y facilidad de servicio.

**Cuándo usarlo:**

* Evaluación de la fiabilidad del hardware
* Estado de la corrección de errores
* Diagnóstico de memoria y procesador

**Sintaxis de la 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 usarlo:**

* Pruebas proactivas del estado de las unidades
* Solución de problemas de almacenamiento
* Mantenimiento preventivo

**Parámetros:**

* **Unidad:** Unidad de destino para las pruebas
* **Tipo de prueba:** Prueba corta, larga o de transporte

**Sintaxis de la CLI:**

```bash
smartctl -t [TEST_TYPE] [DRIVE_PATH]
```

{% 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 los atributos SMART y la información sobre el estado de las unidades.

**Cuándo usarlo:**

* Evaluación del estado de las unidades
* Análisis predictivo de fallos
* Supervisión del rendimiento del almacenamiento

**Parámetros:**

* **Unidad:** Identificador de la unidad de destino

**Sintaxis de la CLI:**

```bash
smartctl -a [DRIVE_PATH]
```

***

### Mostrar dispositivos de bloques

**Propósito:** Enumera todos los dispositivos de bloques visibles para el nodo.

**Cuándo usarlo:**

* Inventario de dispositivos de almacenamiento
* Solución de problemas de reconocimiento de unidades
* Verificación de la configuración del almacenamiento

**Sintaxis de la CLI:**

```bash
lsblk
fdisk -l
```

***

### Prueba de conexión TCP

**Propósito:** Prueba la conectividad TCP con hosts y puertos remotos.

**Cuándo usarlo:**

* Verificación de la conectividad de servicios
* Prueba de reglas de firewall
* Solución de problemas de red

**Parámetros:**

* **Host:** Nombre de host o dirección IP de destino
* **Puerto:** Número de puerto TCP

**Sintaxis de la CLI:**

```bash
telnet [HOST] [PORT]
nc -zv [HOST] [PORT]
```

***

### Volcado TCP

**Propósito:** Captura paquetes de red para analizar el tráfico en detalle.

**Cuándo usarlo:**

* Solución de problemas de red
* Análisis de seguridad
* Depuración de protocolos

**Parámetros:**

* **Número de paquetes:** Paquetes que se capturarán (de 100 a 1000; predeterminado: 100)
* **Tiempo de espera en segundos:** Duración de la captura (de 1 a 30; predeterminada: 15)
* **Tipo de interfaz:** ***Física***, ***VXLAN***, ***Puentes***, o ***dispositivos TAP***
* **Nombre:** La interfaz en la que se realizará la captura, filtrada por **Tipo de interfaz**.
* **Salida detallada:** ***Ninguna***, ***Baja***, ***Media***, o ***Alta***
* **Mostrar encabezado de nivel de enlace (VLAN, MAC):** Añade `-e` al comando para que cada paquete muestre sus direcciones MAC y su etiqueta VLAN 802.1Q
* **Expresión:** Expresión de filtro de paquetes (por ejemplo, `vlan 210` o `not vlan 1`), añadida al comando tal como se introduce

{% hint style="info" %}
**Lista de nombres de interfaces**

La **lista** de interfaces físicas muestra las NIC físicas del nodo. **Los** y los **dispositivos TAP** solo muestran los puentes y los dispositivos TAP de las redes y las máquinas virtuales que se estén ejecutando en el nodo seleccionado, así que ejecuta la captura en el nodo donde se esté ejecutando la red o la máquina virtual.
{% endhint %}

{% hint style="info" %}
**Ver etiquetas VLAN**

De forma predeterminada, la captura no muestra las cabeceras de nivel de enlace, por lo que las tramas etiquetadas con VLAN aparecen como tráfico IP normal, sin ID de VLAN. Marca **Mostrar cabecera de nivel de enlace (VLAN, MAC)** para ver las etiquetas; por ejemplo, `ethertype 802.1Q (0x8100) ... vlan 210, p 0`.
{% endhint %}

**Sintaxis de la CLI:**

Activa **Mostrar comando** para ver el comando exacto que se utiliza. El comando predeterminado es:

```bash
busybox timeout 15 tcpdump -lni [INTERFACE] -c 100
```

Con **Mostrar cabecera de nivel de enlace (VLAN, MAC)** marcada y una **expresión** introducida:

```bash
busybox timeout 15 tcpdump -lni [INTERFACE] -c 100 -e [EXPRESSION]
```

{% hint style="warning" %}
**Impacto en el rendimiento**

La captura de paquetes puede afectar al rendimiento del nodo. Úsala con precaución en producción.
{% endhint %}

***

### Mayor uso de CPU

**Propósito:** Muestra los procesos que consumen más recursos de CPU.

**Cuándo usarlo:**

* Solución de problemas de rendimiento
* Análisis del uso de recursos
* Supervisión de procesos

**Sintaxis de la CLI:**

```bash
top -o %CPU
```

***

### Mayor uso de red

**Propósito:** Muestra los procesos con mayor uso de la red.

**Cuándo usarlo:**

* Análisis del rendimiento de la red
* Solución de problemas relacionados con el uso del ancho de banda
* Identificación de procesos con alto consumo de red

**Sintaxis de la CLI:**

```bash
iftop
nethogs
```

***

### Ruta de seguimiento

**Propósito:** Traza la ruta de red desde el nodo hasta un destino.

**Cuándo usarlo:**

* Solución de problemas de enrutamiento de red
* Análisis de rutas
* Diagnóstico de problemas de conectividad

**Parámetros:**

* **Destino:** IP o nombre de host de destino

**Sintaxis de la CLI:**

```bash
traceroute [DESTINATION]
mtr [DESTINATION]
```

***

### Cuál es mi IP

**Propósito:** Muestra la dirección IP externa del nodo.

**Cuándo usarlo:**

* Verificación de la conectividad externa
* Solución de problemas de configuración de NAT
* Validación de la configuración de red

**Sintaxis de la CLI:**

```bash
curl ifconfig.me
```

## Prácticas recomendadas

### 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 del estado:** Revise los sensores IPMI y los registros de eventos del sistema
3. **Análisis del almacenamiento:** Use la información y las pruebas S.M.A.R.T.
4. **Verificación de la red:** Compruebe la vinculación de red y el estado de las interfaces
5. **Evaluación del rendimiento:** Supervise el uso de la CPU y de la red

### Mantenimiento preventivo

* **Comprobaciones periódicas del estado:** Supervise los sensores 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 la CPU y de la red
* **Estado de las unidades:** Programe pruebas de diagnóstico S.M.A.R.T. 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 el soporte:** Recurra al soporte de VergeOS para problemas complejos de hardware
* **Documentación:** Conserve los resultados de diagnóstico para analizar tendencias
* **Control de cambios:** Siga los procedimientos de gestión de cambios para las modificaciones de hardware

## Solución de problemas comunes de los nodos

### Problemas de hardware

1. Compruebe los **sensores IPMI** para detectar problemas de temperatura, voltaje y ventiladores
2. Revise los **registros de eventos del sistema IPMI** para detectar errores de hardware
3. Use la **información S.M.A.R.T.** para evaluar el estado de las unidades

### Problemas de red

1. Verifique el estado y la configuración de la **vinculación de red** .
2. Usa **Herramienta Ethernet** para comprobar la configuración de la interfaz
3. Prueba la conectividad con **Ping** y **Ruta de seguimiento**

### Problemas de rendimiento

1. Supervisa **Uso máximo de CPU** para detectar limitaciones de recursos
2. Comprueba **Uso máximo de red** para evaluar el uso del ancho de banda
3. Revisa **los registros** para encontrar errores relacionados con el rendimiento

### Problemas de almacenamiento

1. Usa **Mostrar dispositivos de bloques** para verificar que se reconozcan las unidades
2. Ejecuta **Pruebas de diagnóstico S.M.A.R.T.** para realizar pruebas exhaustivas de las unidades
3. Comprueba **Consulta RAS** para obtener información sobre errores de memoria y almacenamiento

## Próximos pasos

Cuando domines el diagnóstico de nodos, considera explorar lo siguiente:

* Supervisión avanzada del hardware y alertas
* Creación de scripts de diagnóstico automatizados
* Integración con sistemas externos de supervisión
* Programación del mantenimiento preventivo

Si tienes problemas de hardware complejos o resultados de diagnóstico inusuales, ponte en contacto con [el soporte de VergeOS](https://docs.verge.io/overview/es/support-and-services.md) y proporciona información detallada del diagnóstico y 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/run-the-platform/es/administracion-del-sistema/node-diagnostics.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
