Ir para o conteúdo

Documentação

Consola e métricas

Duas formas de olhar para uma máquina que já está em execução: uma ligação em direto à sua consola gráfica ou ao seu terminal, e os gráficos que dizem o que tem feito. Ambas passam pelo seu agente, e nenhuma exige que algo seu esteja acessível a partir da internet.

A consola

Uma sessão de consola é um túnel: do seu navegador para a plataforma, da plataforma para o seu agente pela ligação que já está aberta, e do seu agente para a máquina. A plataforma que está no meio nunca olha para o conteúdo. Conta bytes e reencaminha-os.

Como se estabelece uma sessão

  1. O painel pede um ticket para este servidor específico. O pedido é recusado se não tiver permissão para usar a consola deste servidor, se o agente não estiver ligado, se a integração estiver desativada ou se a máquina não estiver num estado que tenha consola.
  2. O ticket é válido durante um minuto e pode ser usado uma única vez. Nomeia o servidor, pelo que um ticket para outra coisa não pode abrir esta consola.
  3. O seu navegador abre um socket separado com esse ticket. Aí, todas as verificações são feitas de novo, porque as coisas podem mudar nesse minuto.
  4. O agente liga-se à máquina e comunica de que protocolo se trata: uma consola gráfica para uma máquina virtual, um terminal para um servidor de jogos. O seu navegador recusa um protocolo que não fala, com uma mensagem em vez de um retângulo preto.

Limites

  • Uma sessão dura no máximo uma hora. A própria plataforma impõe esse limite, além do agente, e indica porque foi fechada.
  • Se o navegador não conseguir acompanhar, o túnel é pausado em vez de ser cortado. A sessão só é terminada quando a acumulação se torna realmente grande.
  • A sessão fica registada no registo de atividade como sessão: quanto tempo durou e quanto passou em cada sentido. Nunca o conteúdo.

Que fornecedores a têm

Aparece um separador de consola sempre que a integração oferece uma, e a página de integrações indica quais o fazem. As máquinas virtuais e os servidores de jogos podem ter um ecrã ou um terminal ao vivo; uma conta de alojamento é uma fração de uma máquina partilhada, sem nada de próprio a que se ligar, por isso nunca tem uma.

  • No Proxmox, esta é a própria consola gráfica da máquina, pela mesma porta e com o mesmo token que a integração já utiliza, pelo que não é preciso um segundo buraco na sua firewall.
  • No Pterodactyl, é o terminal do servidor de jogos, retransmitido a partir do Wings. Vê a saída da consola, as mudanças de estado e os números de utilização, e pode enviar comandos.

Métricas

Cada servidor é medido no mesmo ritmo de vinte segundos da sondagem. As medições recentes são guardadas tal como estão, para gráficos rápidos; as mais antigas são agrupadas em blocos de cinco minutos com uma média, um mínimo e um máximo, para que um pico não desapareça numa média.

Os intervalos

Uma hora e seis horas são desenhadas a partir das medições recentes, um dia e uma semana a partir das agrupadas. Os intervalos agrupados trazem também uma banda com o valor mais alto e o mais baixo de cada bloco.

O que é representado

Os gráficos que um servidor tem decorrem daquilo que o seu fornecedor consegue medir.

  • Máquinas virtuais: processador, memória, disco, rede e taxa de transferência do disco. A utilização do disco dentro do sistema convidado não é visível para o hipervisor, pelo que esse gráfico mostra o tamanho atribuído.
  • Contas de alojamento: a utilização da quota de disco. É o que um painel de controlo comunica.
  • Servidores de jogos: processador, memória, disco e rede. O Wings não comunica a taxa de transferência do disco.

Lacunas

Deliberadamente, as medições não são reenviadas depois de uma quebra de ligação. Um agente que esteve ausente deixa uma lacuna no gráfico em vez de uma rajada de pontos com data retroativa, e a linha é interrompida em vez de ser traçada em linha reta por cima.

As medições recentes são guardadas durante algumas horas e as agrupadas durante um mês. Um servidor eliminado mantém os seus gráficos até estes expirarem.

Métricas sobre o próprio agente

Um agente tem os seus próprios gráficos, em quatro grupos: o host onde é executado, o processo do agente, a ligação à plataforma e a interface de rede a partir da qual serve as instalações. Quando uma família tem várias etiquetas, são desenhadas as três mais ativas e as restantes são nomeadas.

Os números da ligação são calculados pela plataforma, não medidos no seu host: o tempo de ida e volta, a diferença de relógio e os dias até o certificado expirar.
O histórico guardado das métricas do agente é uma funcionalidade que o seu fornecedor ativa. Se estiver desativada, o separador mostra a janela em direto das últimas horas e nada mais antigo.

O registo do agente

Além das métricas, existe um registo operacional que o agente transmite em direto: o que fazem o seu runtime, a sua sessão, as suas integrações, o seu serviço de instalação e os seus downloads. É composto pelo agente a partir de códigos e parâmetros, pelo que é apresentado no seu idioma, e tudo o que se pareça com um segredo é removido duas vezes, uma no seu host e outra à chegada.

Esta é uma funcionalidade que o seu fornecedor ativa e que, além disso, exige uma permissão própria. Não é uma janela para o host: não há no protocolo nenhum lugar onde uma linha arbitrária do diário do sistema pudesse caber.