> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plasma.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Solución de problemas
> Problemas comunes, diagnósticos y procedimientos de resolución
Esta guía describe los problemas comunes que afectan a los nodos no validadores, con diagnósticos prácticos y pasos de resolución. La solución rápida de problemas es crítica para mantener la disponibilidad de RPC y el acceso confiable a los datos de transacciones de stablecoins.
La mayoría de los problemas provienen de límites de recursos del sistema, conectividad de red con los endpoints de consenso o configuraciones incorrectas. Comienza siempre con verificaciones básicas de salud antes de investigar casos límite específicos de Plasma.
## Problemas de sincronización
Si tu nodo se queda atrás del head de la red:
* **Revisa la carga del sistema**: La CPU, memoria e I/O deben ser suficientes para la producción de bloques de alta frecuencia de Plasma.
* **Verifica la latencia del endpoint de consenso**: La alta latencia impacta la velocidad de ingestión de bloques.
* **Monitorea el rendimiento de la base de datos**: Las consultas lentas o la contención por bloqueos pueden ser un cuello de botella en la sincronización.
**Diagnósticos:** Revisa `block_height` vs el head de la red, el tiempo de aplicación de estado por bloque y la latencia hacia cada endpoint de consenso.
Si la sincronización se detiene:
* **Revisa el espacio en disco**: Los discos llenos detienen las escrituras a la base de datos.
* **Verifica la conectividad del endpoint**: Asegúrate de que la resolución DNS, las reglas de firewall y el enrutamiento no estén bloqueando el tráfico de consenso.
* **Revisa los límites de recursos del contenedor**: La memoria o CPU insuficiente pueden crashear los procesos de sincronización.
**Verificaciones específicas de Plasma:** Verifica la accesibilidad del endpoint, la validez de los tokens JWT / estado de allowlist y la compatibilidad de versión del nodo no validador.
Las conexiones limitadas o inestables con los endpoints de consenso reducen la frescura de los datos para los consumidores RPC.
**Revisa:** Restricciones de IP o políticas de enrutamiento, conteo de conexiones de endpoint y uptime, y comportamiento de failover entre múltiples endpoints.
**Métricas clave:** Conexiones activas, tasa de desconexiones y lag en la llegada de bloques.
## Conectividad de red
### Acceso a puertos y firewall
Asegúrate de que los puertos requeridos estén abiertos para ambos:
* **Comunicación de consenso**
* **Servicio RPC a las aplicaciones**
Los bloqueadores comunes incluyen firewalls corporativos, grupos de seguridad en la nube o reglas iptables mal configuradas.
**Verifica:**
* Accesibilidad del puerto desde fuera y dentro del contenedor
* Tráfico de salida permitido para la sincronización del consenso
### Fallos de DNS
Los dominios de consenso no resueltos rompen la sincronización.
* Confirma la resolución DNS para todos los dominios de servicios de Plasma
* Monitorea la latencia y confiabilidad del resolver
* Agrega resolvers de respaldo según sea necesario
### Problemas de proxy y NAT
Entornos de red complejos (VPNs, proxies, NATs) pueden interferir con:
* Sincronización de consenso
* Acceso RPC entrante
**Valida:**
* Reglas de autenticación del proxy
* Reenvío de puertos NAT para RPC entrante
* Rutas hacia la infraestructura de Plasma
## Errores de configuración
Los errores de inicio a menudo son causados por endpoints de consenso incorrectos o faltantes, URLs o tokens JWT malformados, o flags obsoletas.
**Revisa los logs en busca de:** Errores de parseo de configuración, desajustes de chain ID y flags u opciones desconocidas.
Los contenedores mal configurados pueden impedir la operación normal.
**Valida:** Volúmenes montados para la persistencia de la base de datos, acceso a la red dentro del contenedor, límites de recursos (CPU, memoria) y compatibilidad de versión de la imagen.
Variables de entorno conflictivas o mal ordenadas pueden anular la configuración deseada.
**Verifica:** URLs y tokens de endpoints de consenso, red y chain ID, y feature flags (por ejemplo, soporte de gas personalizado). Documenta el uso de variables de entorno para evitar deriva entre despliegues.
## Límites de recursos
### Espacio en disco
Monitorea el crecimiento del uso de disco debido a:
* Datos del blockchain
* Logs y archivos temporales
**Buenas prácticas:**
* Implementa rotación de logs
* Programa trabajos de limpieza
* Monitorea alertas de uso
### Descriptores de archivo
Los ulimits bajos pueden romper:
* Conexiones de consenso
* Sesiones RPC
Aumenta los límites de descriptores de archivo vía `ulimit`, systemd o configuraciones de runtime de contenedores.
## Diagnósticos
### Análisis de logs
Usa los logs para rastrear:
* Progreso de sincronización
* Errores de RPC
* Conectividad de consenso
* Crashes relacionados con recursos
**Buenas prácticas:**
* **Logs de sincronización del consenso**: Rastrea la conectividad y el progreso de sincronización con Plasma.
* **Logs de procesamiento de transacciones**: Monitorea el manejo de transacciones y errores.
* **Logs de solicitudes RPC**: Analiza los patrones de solicitudes y el rendimiento de las aplicaciones de pago.
* **Logs de utilización de recursos**: Identifica cuellos de botella que afectan el procesamiento de pagos.
### Perfilado de rendimiento
Perfila las cargas de trabajo no validadoras para identificar cuellos de botella en:
* Rendimiento de RPC
* Latencia de consultas a la DB
* Aplicación de estado de consenso
**Áreas de enfoque:**
* Throughput de verificación de saldos
* Latencia de confirmación de transferencias
* Uso de recursos bajo carga
Mantén líneas base y rastrea los cambios a través de las actualizaciones o cambios de configuración.
La solución sistemática de problemas y la observabilidad son esenciales para la operación confiable de nodos no validadores. Los diagnósticos adecuados, el registro y la higiene de la configuración aseguran un rendimiento estable y uptime para los servicios RPC que soportan la infraestructura de stablecoins.