Documentación
Consola y mediciones
Dos formas de mirar una máquina que ya está en marcha: una conexión en directo con su pantalla o su terminal, y las gráficas que dicen qué ha estado haciendo. Las dos pasan por su agente, y ninguna exige que nada suyo sea accesible desde internet.
La consola
Una sesión de consola es un túnel: del navegador a la plataforma, de la plataforma a su agente por la conexión que ya está abierta, y de su agente a la máquina. La plataforma que está en medio nunca mira el contenido. Cuenta bytes y los reenvía.
Cómo se establece una sesión
- El panel pide un ticket para ese servidor concreto. La petición se rechaza si no hay permiso para usar la consola de ese servidor, si el agente no está conectado, si la integración está desactivada o si la máquina no está en un estado que tenga consola.
- El ticket es válido durante un minuto y se puede usar una sola vez. Nombra el servidor, así que un ticket para otra cosa no puede abrir esta consola.
- El navegador abre un socket aparte con ese ticket. Allí se vuelven a hacer todas las comprobaciones, porque las cosas pueden cambiar en ese minuto.
- El agente se conecta a la máquina e informa de qué protocolo es: una pantalla para una máquina virtual, un terminal para un servidor de juego. El navegador rechaza un protocolo que no habla, con un mensaje en lugar de un rectángulo negro.
Límites
- Una sesión dura como máximo una hora. La plataforma lo impone por su cuenta, además del agente, e indica por qué se ha cerrado.
- Si el navegador no puede seguir el ritmo, el túnel se pausa en lugar de cortarse. Solo cuando la acumulación se hace realmente grande se termina la sesión.
- La sesión queda anotada en el registro de actividad como sesión: cuánto duró y cuánto se transmitió en cada sentido. Nunca el contenido.
Qué proveedores la tienen
Aparece una pestaña de consola allí donde la integración ofrece una, y la página de integraciones indica cuáles lo hacen. Las máquinas virtuales y los servidores de juego pueden tener una pantalla o un terminal en vivo; una cuenta de hosting es una porción de una máquina compartida, sin nada propio a lo que conectarse, así que nunca la tiene.
- En Proxmox es la propia pantalla de la máquina, por el mismo puerto y con el mismo token que ya usa la integración, así que no hace falta un segundo agujero en el firewall.
- En Pterodactyl es el terminal del servidor de juego, retransmitido desde Wings. Se ve la salida de la consola, los cambios de estado y las cifras de consumo, y se pueden enviar comandos.
Mediciones
Cada servidor se mide con el mismo ritmo de veinte segundos que el sondeo. Las mediciones recientes se conservan tal cual para las gráficas rápidas; las más antiguas se agrupan en intervalos de cinco minutos con una media, un mínimo y un máximo, de modo que un pico no desaparece dentro de un promedio.
Los periodos
Una hora y seis horas se dibujan a partir de las mediciones recientes; un día y una semana, a partir de las agrupadas. Los periodos agrupados llevan además una banda con el valor más alto y el más bajo de cada intervalo.
Qué se representa
Qué gráficas tiene un servidor depende de lo que pueda medir su proveedor.
- Máquinas virtuales: procesador, memoria, disco, red y rendimiento de disco. El uso de disco dentro del sistema invitado no lo ve el hipervisor, así que esa gráfica muestra el tamaño asignado.
- Cuentas de hosting: el uso de la cuota de disco. Es lo que informa un panel de control.
- Servidores de juego: procesador, memoria, disco y red. Wings no informa del rendimiento de disco.
Huecos
Las mediciones no se reenvían a propósito después de una desconexión. Un agente que ha estado ausente deja un hueco en la gráfica en lugar de una ráfaga de puntos con fecha atrasada, y la línea se interrumpe en vez de trazarse recta por encima.
Las mediciones recientes se conservan unas horas y las agrupadas, un mes. Un servidor eliminado conserva sus gráficas hasta que caducan.
Mediciones del propio agente
Un agente tiene sus propias gráficas, en cuatro grupos: la máquina en la que se ejecuta, el proceso del agente, la conexión con la plataforma y la interfaz de red desde la que atiende las instalaciones. Cuando una familia tiene varias etiquetas, se dibujan las tres más activas y el resto se nombran.
El registro del agente
Aparte de las mediciones hay un registro operativo que el agente transmite en directo: qué están haciendo su runtime, su sesión, sus integraciones, su servicio de instalación y sus descargas. Lo compone el agente a partir de códigos y parámetros, así que se muestra en el idioma propio, y se le quita dos veces todo lo que parezca un secreto, una vez en su host y otra a la llegada.