Skip to main content

Paneles de monitorización de la red ISBE

La red ISBE cuenta con paneles de monitorización diseñados para que los equipos técnicos puedan consultar información esencial sobre el estado de la red y de sus nodos regulares.
Esta información proviene de sistemas internos de métricas (Prometheus, Grafana u otros equivalentes según entorno).

El objetivo de esta guía es explicar qué puede consultar cada caso de uso y qué información resulta relevante para validar el funcionamiento de su nodo o de la red en general.


1. Acceso a los paneles de monitorización

Cada entorno (dev, pre, pro) puede disponer de paneles independientes.
El equipo ISBE proporcionará los enlaces correspondientes a cada caso de uso cuando su entorno esté activo.

Ejemplo de estructura (no real):

  • ISBE-DEV: https://monitor.dev.isbe.network
  • ISBE-PRE: https://monitor.pre.isbe.network
  • ISBE-PRO: https://monitor.pro.isbe.network

El acceso puede estar protegido mediante usuario/contraseña o IP whitelisting según el caso.


2. Paneles disponibles

Los paneles suelen agruparse en cuatro categorías:

2.1. Panel general de red

Incluye métricas globales:

  • Altura de bloque en tiempo real
  • Block time promedio
  • Nodos validadores activos
  • Estado del consenso IBFT
  • Alertas críticas (si aplica)

Este panel permite identificar de un vistazo si la red está estable.


2.2. Panel de nodos regulares

Permite ver información relevante de cada nodo regular conectado a la red:

  • Peer count
  • Latencia
  • Tasa de transacciones procesadas
  • Logs de errores comunes
  • Estado del RPC
  • Uso de CPU/RAM (si el nodo es gestionado por ISBE)

Los nodos operados por los propios casos de uso sólo mostrarán métricas si el participante ha configurado los exportadores correspondientes.


2.3. Panel de bloques y transacciones

Útil para desarrolladores:

  • Número de transacciones por bloque
  • Tiempos de confirmación
  • Eventos on-chain detectados
  • Contratos con mayor volumen de actividad
  • Históricos de gas usado

Ayuda a detectar:

  • Reintentos de transacción
  • Bloques con fallos anómalos
  • Uso excesivo de gas por parte de un contrato

2.4. Panel de alertas (si está habilitado)

Incluye:

  • Alertas de altura estancada
  • Alertas de falta de peers
  • Alertas de variación anormal del block time
  • Alertas de caída de un nodo validador

En muchos casos este panel es interno y no visible para los casos de uso, pero ISBE notifica incidentes relevantes.


3. Qué deben revisar los casos de uso

Los equipos no necesitan monitorizar toda la red; solo deben revisar:

Para nodos proporcionados por ISBE:

  • Estado del RPC
  • Peer count
  • Block time
  • Altura de bloque
  • Alertas relacionadas con su nodo

Para nodos desplegados por el propio equipo:

  • CPU y RAM del host
  • Disponibilidad del puerto 30303/tcp
  • Disco libre en el data-path
  • Logs relevantes del nodo Besu

Estas métricas permiten detectar el 90% de los problemas típicos.


4. Ejemplos de análisis rápidos

Caso A: Mi nodo marca 0 peers

Interpretación:

  • No está permisionado o la IP <IP_NODO> no coincide.
  • Puerto 30303/tcp bloqueado. Acciones:
  • Revisar net_peerCount.
  • Verificar firewall.
  • Revisar datos enviados en la solicitud de permisionado.

Caso B: La red muestra block time >5 segundos

Interpretación:

  • Posible incidencia en validadores.
  • Congestión o actualización de red. Acciones:
  • Verificar en Blockscout si afecta a todos.
  • Escalar a ISBE si persiste.

Caso C: Eventos no llegan por WebSocket

Interpretación:

  • Nodo con latencia alta.
  • WebSocket desconectado. Acciones:
  • Revisar panel de nodos regulares.
  • Reiniciar servicio si es nodo propio.

5. Resumen

PanelPropósitoRelevancia para casos de uso
General de redEstado global, block timeAlta
Nodos regularesSalud del RPC y P2PMuy alta
Bloques y transaccionesActividad on-chainMedia
AlertasIncidencias críticasAlta (si accesible)

Los paneles permiten a los participantes detectar problemas comunes de forma autónoma y validar el comportamiento de sus despliegues sin necesidad de acceso interno a la infraestructura.