ProxMenux/web/messages/es/docs/monitor/dashboard/system-overview.json

{
  "meta": {
    "title": "ProxMenux Monitor — Panel: pestaña Resumen del sistema | ProxMenux Documentation",
    "description": "La pestaña por defecto al abrir ProxMenux Monitor: cuatro tarjetas de métricas (CPU, memoria, VMs y LXCs activos, temperatura) con actualizaciones en vivo y sparkline, la gráfica de métricas históricas y los paneles condensados de Almacenamiento y Red con acceso directo a sus pestañas dedicadas."
  },
  "header": {
    "title": "Panel: pestaña Resumen del sistema",
    "description": "La primera pestaña que abre el panel. Cuatro tarjetas de métricas en vivo arriba, la gráfica de métricas históricas en el medio y paneles condensados de almacenamiento / red abajo — todo derivado de las mismas APIs que alimentan las pestañas dedicadas.",
    "section": "ProxMenux Monitor · Panel"
  },
  "readOnly": {
    "title": "Un vistazo de solo lectura",
    "body": "Nada en esta pestaña es una superficie de control — todos los paneles son informativos. Las acciones viven en las pestañas dedicadas a las que enlazan: entra en Almacenamiento para gestionar discos, en VMs y LXCs para arrancar / parar guests, en la pestaña Seguridad para configurar autenticación, y así sucesivamente."
  },
  "captureAlt": "Pestaña Resumen del sistema — cuatro tarjetas de métricas (CPU, Memoria, VMs activos, Temperatura), gráfica de métricas del nodo y tarjetas resumen de Almacenamiento / Red",
  "captureCaption": "La pestaña Resumen del sistema — la que abre el panel. Las cuatro tarjetas están en vivo, la gráfica de debajo es histórica y las dos tarjetas de abajo resumen Almacenamiento y Red.",
  "topRow": {
    "heading": "Fila superior: tarjetas de métricas en vivo",
    "intro": "Cuatro tarjetas en una rejilla 2×2 en móvil, una sola fila en escritorio. Cada una se actualiza desde <code>/api/system</code> cada pocos segundos.",
    "headerCard": "Tarjeta",
    "headerWhat": "Qué muestra",
    "headerSource": "Fuente",
    "rows": [
      {
        "card": "CPU Usage",
        "what": "Porcentaje actual con barra de progreso. Se actualiza cada ~1 s vía el sampler de signos vitales.",
        "source": "psutil.cpu_percent()"
      },
      {
        "card": "Memory Usage",
        "what": "GB usados, porcentaje, GB totales. La barra de progreso sigue al porcentaje.",
        "source": "psutil.virtual_memory()"
      },
      {
        "card": "Active VM & LXC",
        "what": "Recuento de guests actualmente en ejecución, con una insignia de desglose Running / Stopped y una línea al pie con los totales de VMs y LXCs.",
        "source": "/api/vms (consolidado)"
      },
      {
        "card": "Temperature",
        "what": "Temperatura de CPU en °C con insignia de estado (cool / warm / hot) y un sparkline de 5 minutos detrás. Muestra <em>N/A</em> cuando no se detecta sensor. Pulsa para abrir la modal de detalle de temperatura.",
        "source": "sensors / coretemp"
      }
    ],
    "thresholdsTitle": "Colores de estado y umbrales aplicados aquí",
    "thresholdsIntro": "Cada anillo, barra y sparkline en las cuatro tarjetas de métricas sigue la misma clasificación — <green/> <strong>verde</strong> por debajo de Warning, <amber/> <strong>ámbar</strong> entre Warning y Critical, <red/> <strong>rojo</strong> en Critical y por encima. Valores por defecto recomendados que vienen con ProxMenux:",
    "thresholdsItems": [
      "<strong>Uso de CPU</strong> — Warning 85 %, Critical 95 %.",
      "<strong>Memoria</strong> — Warning 85 %, Critical 95 % (el swap también dispara Critical al 5 % usado — un host Proxmox sano apenas debería tocar swap).",
      "<strong>Temperatura de CPU</strong> — Warning 80 °C, Critical 90 °C."
    ],
    "thresholdsOutro": "Cada valor es configurable por host — <link>Settings → Health Monitor Thresholds</link> es la fuente única de verdad y explica cómo ajustarlos.",
    "sparklineTitle": "El sparkline es significativo",
    "sparklineBody": "La tarjeta de temperatura dibuja una traza de 5 minutos bajo el valor, con la línea y el degradado siguiendo el mismo par Warning/Critical documentado arriba. Es la forma más rápida de ver si el host está en escalada térmica sin abrir la modal de detalle."
  },
  "processes": {
    "heading": "Acceso directo: top procesos por CPU / Memoria",
    "intro": "Las tarjetas CPU Usage y Memory son clicables. Al pulsar cualquiera de ellas se abre una lista ordenable con los 25 procesos top — la tarjeta de CPU ordena por <code>%CPU</code>, la de Memory ordena por memoria residente (RSS). Ambas tiran de <code>/api/processes?sort=cpu|mem&limit=25</code>, que ejecuta un único <code>ps -eo pid,user,pcpu,pmem,rss,comm</code> por refresco.",
    "listTitle": "La modal con la lista",
    "listItems": [
      "<strong>Auto-refresco</strong> — la lista vuelve a obtener datos cada 5 s mientras el diálogo está abierto. Al cerrar el diálogo se detiene todo el polling.",
      "<strong>Caja de filtro</strong> — busca por command, user o PID sin volver a pedir datos al servidor.",
      "<strong>Barra de progreso en línea</strong> — la columna de la métrica primaria dibuja una barra escalada al mayor valor de la lista filtrada, para que el orden visual se mantenga aunque ningún proceso esté cerca del 100 %.",
      "<strong>Layout móvil</strong> — por debajo de 640 px las columnas PID y User desaparecen para que Command, CPU % y Memory sigan cabiendo sin scroll horizontal."
    ],
    "captureListAlt": "Modal Top processes by Memory — tabla con columnas PID, USER, COMMAND, CPU %, Memory ordenada por RSS",
    "captureListCaption": "La tarjeta Memory abre la lista ordenada por RSS (acento índigo). La tarjeta CPU abre la misma lista ordenada por %CPU (acento azul).",
    "detailTitle": "Detalle por proceso",
    "detailIntro": "Al pulsar cualquier fila de la lista se abre una segunda modal con la foto en vivo completa de ese proceso, servida desde <code>/api/processes/&lt;pid&gt;</code>. Cuatro secciones:",
    "detailItems": [
      "<strong>Overview</strong> — estado (<code>R</code>/<code>S</code>/<code>D</code>/<code>Z</code>/…), proceso padre (<code>PPid</code> + <code>comm</code> del padre), número de hilos, FDs abiertos, usuario y grupo.",
      "<strong>Resources</strong> — CPU %, Memoria %, Resident (RSS), Virtual size, Swap, bytes de I/O de lectura y escritura.",
      "<strong>Command</strong> — nombre corto (<code>comm</code>), línea de comandos completa, ruta del ejecutable y directorio de trabajo.",
      "<strong>Lifetime</strong> — timestamp de arranque y tiempo transcurrido en ejecución."
    ],
    "detailRefresh": "La modal de detalle se refresca cada 3 s mientras está abierta. Si el proceso termina con la modal abierta, el polling se detiene, aparece un banner ámbar <em>This process has finished</em> y el último snapshot capturado se queda en pantalla (atenuado) para que sigas viendo qué estaba pasando justo antes de que terminara — esperable para procesos efímeros como <code>pct exec</code>, subprocesos de backup o el propio <code>ps</code> que alimenta la lista.",
    "captureDetailAlt": "Modal de detalle de proceso — secciones Overview, Resources, Command y Lifetime para un único PID",
    "captureDetailCaption": "Modal de detalle por proceso abierta desde una fila de la lista. El color de acento sigue al de la tarjeta que la abrió (azul para CPU, índigo para Memory).",
    "sourceTitle": "De dónde salen los datos",
    "sourceBody": "<code>/api/processes/&lt;pid&gt;</code> lee directamente <code>/proc/&lt;pid&gt;/cmdline</code>, <code>/exe</code>, <code>/cwd</code>, <code>/status</code>, <code>/io</code> y <code>/fd</code>, y llama a <code>ps -o lstart=,etime=,pcpu=,pmem= -p &lt;pid&gt;</code> para los campos en vivo que el kernel no expone en <code>/proc</code>. UID y GID se resuelven a nombre de usuario / grupo con los módulos <code>pwd</code> / <code>grp</code> de Python. Ambos endpoints son handlers HTTP puros bajo demanda — sin daemon, sin sampling en background. No corre nada en el servidor mientras la modal esté cerrada."
  },
  "middle": {
    "heading": "Medio: gráficas de métricas del nodo",
    "body1": "Bajo la fila superior se encuentra el componente <code>NodeMetricsCharts</code> — gráficas históricas de CPU, memoria y E/S de disco tomadas del propio almacén RRD de Proxmox vía <code>/api/node/metrics</code>. Un selector de timeframe alterna entre <em>1 hora / 24 horas / 7 días / 30 días / 1 año</em>; la resolución de los datos baja a medida que crece la ventana para que la gráfica se mantenga fluida.",
    "body2": "Son las mismas gráficas que la UI web de Proxmox renderiza para un nodo, simplemente consolidadas en el tema oscuro del Monitor y alineadas con el resto de paneles."
  },
  "bottom": {
    "heading": "Fila inferior: resúmenes de Almacenamiento y Red",
    "storageTitle": "Tarjeta Storage Overview",
    "storageIntro": "Una vista condensada del estado de almacenamiento del host, dividida en tres bloques:",
    "storageItems": [
      "<strong>Total Node Capacity</strong> — suma de todos los almacenamientos de VM/LXC más el almacenamiento local de sistema, con una barra de progreso en degradado del reparto total usado / libre.",
      "<strong>Total Capacity / Physical Disks</strong> — titular de capacidad bruta y el recuento de discos físicos descubiertos.",
      "<strong>VM/LXC Storage</strong> — usado / libre / porcentaje para los almacenamientos donde viven los guests, más un contador cuando hay más de uno configurado.",
      "<strong>Local Storage (System)</strong> — el propio mount raíz / sistema del host, separado del pool de guests."
    ],
    "storageDrillIn": "La vista en detalle vive en la <link>pestaña Almacenamiento</link> — SMART por disco, detalles de pool ZFS, historial de observaciones, etc.",
    "networkTitle": "Tarjeta Network Overview",
    "networkBody1": "La línea superior muestra el recuento de interfaces activas (físicas + bridges combinados). Debajo, dos filas de insignias coloreadas para las interfaces en <code>up</code> — NICs físicas en azul, bridges en un color secundario. Un selector de timeframe arriba a la derecha (1 hora / 24 horas / 7 días / 30 días / 1 año) controla una pequeña gráfica de tráfico RX / TX.",
    "networkBody2": "La vista en detalle por interfaz (IP/MAC, gráfica RRD, miembros del bridge, modo del bond, etc.) vive en la <link>pestaña Red</link>."
  },
  "refresh": {
    "heading": "Modelo de refresco",
    "intro": "Cada panel gestiona su propio estado de carga (<code>loadingStates.cpu</code>, <code>loadingStates.storage</code>, …) para que una fuente lenta no bloquee al resto. Mientras un panel está obteniendo datos, muestra un skeleton con animación pulse; los fetchs fallidos degradan con elegancia — por ejemplo, un sensor de temperatura ausente renderiza la tarjeta como <em>N/A</em> en vez de un error.",
    "items": [
      "<strong>Tarjetas de métricas superiores</strong> — refresco cada ~5 s. Los paneles de CPU y temperatura también reciben un push de 1 s del sampler de signos vitales.",
      "<strong>Gráfica de métricas del nodo</strong> — refresco cada 30 s, o al cambiar de timeframe.",
      "<strong>Tarjeta de almacenamiento</strong> — refresco cada 60 s. Los datos SMART se cachean más tiempo (la pestaña Almacenamiento dispara una lectura fresca bajo demanda).",
      "<strong>Tarjeta de red</strong> — refresco cada 5 s en el timeframe activo.",
      "<strong>Refresco manual</strong> — el botón Refresh en la cabecera fuerza a todos los paneles a recargar inmediatamente."
    ]
  },
  "dataCollected": {
    "heading": "Cómo se recopilan los datos",
    "headerCard": "Tarjeta",
    "headerEndpoint": "Endpoint",
    "headerSource": "Fuente",
    "rows": [
      {
        "card": "Pastilla de estado de la cabecera",
        "endpoint": "/api/health",
        "source": "El estado global cacheado que produce el Monitor de salud en cada ciclo."
      },
      {
        "card": "CPU / RAM / Swap / Uptime",
        "endpoint": "/api/system",
        "source": "<code>/proc/stat</code>, <code>/proc/meminfo</code>, <code>/proc/uptime</code> con muestreo de CPU en ventana corta."
      },
      {
        "card": "Info del host (kernel, BIOS, distro)",
        "endpoint": "/api/info",
        "source": "<code>uname -a</code>, <code>dmidecode</code>, versión de PVE. Cacheado por proceso."
      },
      {
        "card": "Tarjetas de almacenamiento / red / VMs",
        "endpoint": "/api/storage/summary, /api/network/summary, /api/vms",
        "source": "Mira las pestañas dedicadas para cada una. Las tarjetas de la cabecera muestran una vista compactada de los mismos endpoints."
      },
      {
        "card": "Cadencia de refresco",
        "endpoint": "—",
        "source": "CPU / red 5 s; almacenamiento / VMs 30 s; info estática cada 5 min. El botón Refresh de la cabecera fuerza una recarga inmediata en todos los paneles."
      }
    ],
    "codeComment1": "# Llamada única que alimenta la pastilla de la cabecera",
    "codeComment2": "# pública, sin token",
    "codeComment3": "# Snapshot autenticada que usan las tarjetas"
  },
  "whereNext": {
    "heading": "Por dónde seguir",
    "items": [
      {
        "label": "Monitor de salud",
        "href": "/docs/monitor/health-monitor",
        "tail": " — la modal detrás de la pastilla de estado de la cabecera (diez categorías, descartes, supresión)."
      },
      {
        "label": "Referencia de la API",
        "href": "/docs/monitor/api",
        "tail": " — los endpoints system, info y health."
      },
      {
        "label": "Notificaciones",
        "href": "/docs/monitor/notifications",
        "tail": " — cómo los mismos estados se convierten en mensajes de Telegram / Discord / Email."
      },
      {
        "label": "Índice del panel",
        "href": "/docs/monitor/dashboard",
        "tail": " — las otras ocho pestañas de un vistazo."
      },
      {
        "label": "Arquitectura",
        "href": "/docs/monitor/architecture",
        "tail": " — los hilos en background y las APIs que alimentan esta vista."
      }
    ]
  }
}