A consola é a ferramenta de quem põe uma instalação Merydion a funcionar. Mostra se cada serviço funciona, como estão os nós e se as bases de dados estão atualizadas, e gere contas, códigos de convite, organizações e a governação da partilha, ao lado do feedback, das solicitações de suporte e das mensagens que as pessoas enviam.
Este guia percorre as secções uma a uma. Governar uma única organização por dentro está descrito no guia de administração da organização.
Primeiros passos
Quem pode abrir a consola, o que diz a sua visão geral e como funcionam as suas secções.
Abrir a consola
A consola só abre para os administradores da instalação: as contas que constam, uma por linha, do seu ficheiro ADMINISTRATORS. O ficheiro volta a ser lido em cada verificação, por isso adicionar ou retirar uma linha tem efeito de imediato.
- Entre com uma conta de administrador.
- Abra o menu da conta no canto superior direito e escolha Consola de administração: só os administradores da instalação a veem. Também pode abrir diagnostics.html.
- Qualquer outra pessoa recebe, em vez da consola, uma página no idioma da página pedida que diz porquê. Sem sessão iniciada, Entrar leva-o de volta à consola depois de entrar; com outra conta, escolha Voltar ao seu espaço de trabalho ou Entrar com outra conta.
Sugestão Como designar o primeiro administrador é explicado no guia de instalação.
Ler a visão geral
A consola abre em Visão geral, que diz o que na instalação pede atenção: os serviços que não respondem, as bases de dados a atualizar, os pedidos de suporte recebidos e os utilizadores à espera de verificação.
- Leia os quatro números: um número num cartão colorido pede atenção, um num cartão simples não; um traço significa que ainda está a ser lido.
- Sob Bases de dados a atualizar, Serviços não verificados conta os serviços cujas bases de dados não puderam ser verificadas.
- Clique num número para abrir a secção onde é tratado; Retroceder leva-o de volta à visão geral.
- Atualizar volta a ler todos os números.
Sugestão Os números dos serviços e das bases de dados são os de Estado e de Atualização das bases de dados: leem-se uma vez para ambas as secções e renovam-se enquanto os observa.
Deslocar-se entre as secções
A consola agrupa as suas secções por ofício — Saúde (Visão geral, Estado), Topologia (Visão geral, Nós, Células, Encaminhamento, Armazenamento, Eventos), Pessoas e organizações (Utilizadores, Organizações, Códigos de convite, Partilha), Operações (Atualização das bases de dados) e A voz dos utilizadores (Suporte, Feedback, Mensagens) — e mostra uma de cada vez.
- Clique numa secção na coluna da esquerda para a abrir.
- Com o foco numa secção, as setas para cima e para baixo abrem a seguinte ou a anterior, de um grupo para o outro; Início e Fim abrem a primeira e a última.
- O endereço acompanha a secção que abre — por exemplo diagnostics.html#diag-scope-status —, pelo que o pode guardar nos marcadores ou enviar, e recarregar a página mantém-no.
- Num ecrã estreito, a coluna passa a ser uma lista no topo da página: escolha aí a secção.
Sugestão Uma secção lê o que mostra na primeira vez que a abre, e a consola não pede nada antes de verificar que a sua conta pode administrar. Cada secção tem o seu próprio Atualizar; a que não consegue ler diz o quê e porquê, e Tentar novamente volta a lê-la.
Orientar-se na consola
A consola é uma app da suite: a barra de título no topo, a coluna das secções à esquerda, a barra de estado em baixo. A barra de título nomeia a instalação e diz o seu estado; a barra de estado diz se os serviços respondem, quando chegou o último anúncio e por que canal a consola fala com o gateway.
- Leia o nome da instalação na barra de título, junto ao quadrante: por baixo, um ponto e o estado dos seus nós — todos em linha, ou quantos estão em cada estado — e o número de alertas atuais.
- A pílula junto ao sino indica a versão do Merydion a partir da qual a consola foi criada.
- Na barra de estado, leia se todos os serviços respondem ou qual não responde, e há quanto tempo chegou o último anúncio.
- À direita da barra de estado, «TLS 1.3» é o canal que o gateway leu para os pedidos da consola; «Sem TLS» indica que a ligação não está cifrada.
- O sol ou a lua junto ao idioma alterna entre o tema claro e o escuro; o idioma abre a lista de idiomas do Portal.
Sugestão Na página de um serviço ou de um nó a coluna das secções mantém-se: a secção de onde vem a página está marcada, e um clique noutra secção abre-a na consola.
Pesquisar na consola e nos seus comandos
O campo ao centro da barra de título encontra as secções da consola, os nós da instalação e os comandos da consola.
- Prima Ctrl+F ou clique no campo; num ecrã estreito é a lupa à direita da barra de título.
- Escreva algumas letras: os resultados surgem agrupados — secções, nós, comandos.
- Mova-se com as setas para cima e para baixo e prima Enter para abrir o resultado escolhido, ou clique nele.
- Uma secção abre na consola, um nó abre a sua página, um comando abre onde vive — a sua caixa de diálogo, ou o seu controlo com o foco nele, que depois prime.
- Esc fecha os resultados e mantém o que escreveu; um segundo Esc esvazia o campo.
Sugestão O campo nunca executa um comando por si: Enter sem um resultado escolhido não faz nada, e um comando que atua espera que prima o seu botão ou o confirme.
Ler os alertas atuais
O sino na barra de título conta os alertas da topologia da instalação — um nó ou um serviço que não responde, uma função que nenhum nó em linha desempenha, serviços que executam versões diferentes — e lista-os.
- Veja o número no sino: é o número de alertas atuais; sem número, sem alertas.
- Clique no sino para abrir a lista: cada alerta é uma frase que nomeia o nó, o serviço ou a função.
- Siga «Abrir a visão geral da topologia» no fim da lista para ver os nós e os serviços.
- Esc, ou um clique noutro sítio, fecha a lista.
Sugestão Os alertas são os de agora: um alerta desaparece sozinho quando se resolve o que o causou. A consola volta a lê-los a cada 30 segundos enquanto o separador está visível.
Dar nome à instalação
O nome da instalação aparece na barra de título da consola. A topologia da instalação guarda-o, com quem o definiu e quando; sem nome, a consola mostra o nome do anfitrião a que chegou.
- Clique na roda à direita da barra de título: abre-se Definições da instalação.
- Escreva o nome, até 64 caracteres — por exemplo Produção.
- Escolha Guardar: a barra de título mostra o novo nome de imediato.
- Para remover o nome, esvazie o campo e guarde.
Sugestão Os espaços no início e no fim são removidos. Cada alteração fica registada entre os eventos da topologia, com a conta que a fez.
Serviços e bases de dados
O estado dos serviços, o seu detalhe e registos, a topologia com os seus nós, células, encaminhamento, armazenamento e eventos, e a atualização das bases de dados.
Verificar o estado dos serviços
Estado lista os onze serviços da instalação, cada um com o ícone, o nome, a descrição e o endereço de saúde.
- Leia a luz de cada linha: Operacional quando o serviço responde à verificação de saúde em menos de 6 segundos, Inacessível quando não.
- As verificações repetem-se sozinhas a cada 30 segundos enquanto Estado ou Visão geral estão à vista, e descansam enquanto o separador do navegador está oculto; Atualizar repete-as de imediato e atualiza Última verificação.
- Clique no estado de um serviço para abrir o seu detalhe de saúde, ou no ícone de registos para os ler.
- Runtimes servidos lista o que o navegador executa a partir de ficheiros do front-end, como os efeitos de vídeo, com Servido ou Não servido.
Sugestão Quando um serviço está Inacessível, os seus registos dizem muitas vezes porquê.
Ler o detalhe de saúde de um serviço
Cada serviço tem uma página com o seu detalhe de saúde: um estado global e um cartão para cada um dos seus subsistemas.
- Abra-a clicando no estado do serviço em Estado.
- A pastilha em cima diz Operacional, Degradado ou Não operacional.
- Cada cartão mostra um subsistema com a luz, o nome, um resumo e os seus números.
- A página não se atualiza sozinha: clique em Atualizar. O caminho no topo da página leva de volta a Estado e à consola.
Sugestão Degradado significa que o serviço funciona mas uma das suas partes não: o cartão desse subsistema diz qual.
Ler os registos de um serviço
Cada serviço tem uma página com os seus registos, numa consola com o aspeto de um terminal.
- Abra-a com o ícone de registos do serviço em Estado.
- Escolha o dia em Dia: a lista mostra os dias que têm registos, do mais recente para o mais antigo.
- A consola mostra as últimas linhas desse dia, coloridas por nível — ERROR, WARN, INFO, DEBUG, TRACE — e desloca-se até à última.
- As linhas mais antigas foram omitidas. significa que o servidor cortou as linhas mais antigas; Sem entradas de registo para este dia. que o dia não tem ficheiro; O registo em ficheiro não está ativado para este serviço. que o serviço não escreve registos em ficheiro.
Sugestão Atualizar volta a ler o dia escolhido.
Ler a topologia da instalação
Em Topologia a consola mostra a instalação tal como a descrevem o registo da topologia e os anúncios dos serviços. A sua Visão geral diz em seis números como está, que funções tem cada nó e que serviços se anunciaram.
- Leia os seis números: os nós, os serviços Rust anunciados, as células SQLite, os destinos dos bytes, a última ronda das cópias e os alertas. Os nós e os alertas aparecem na cor da consola quando tudo corre bem, em ocre ou em vermelho quando algo pede atenção; um traço significa que o dado ainda não existe.
- Última hora e Hoje, ao lado do título, mostram para cada número que tem uma série o pior valor do período e a hora a que foi atingido; os números sem série continuam a ser os de agora e dizem-no. Agora volta ao estado presente.
- Funções × nós tem uma linha por função e uma coluna por nó: um quadrado cheio é uma função ligada nesse nó. O nome de um nó abre a sua página; Mostrar mais acrescenta as colunas dos nós seguintes, e a tabela desloca-se dentro do seu cartão.
- Sob a tabela, três verificações — nenhuma função sem nós, nenhuma versão mista, todos respondem — tornam-se o alerta em palavras quando falham.
- Serviços anunciados lista cada serviço com o nome do seu binário, quantas instâncias se anunciaram, a versão e um ponto, verde quando todas respondem; a primeira linha é a entrada, caddy.
- A secção relê-se sozinha a cada 30 segundos enquanto a consola está aberta, e pára quando o separador do navegador está oculto; Atualizar relê-a de imediato.
Sugestão Perante um alerta, abra a página do nó que ele nomeia: as suas funções e serviços dizem qual serviço não responde. Versões diferentes costumam significar uma atualização ainda em curso em algum nó.
Vigiar os nós
Nós lista os nós que o registo da topologia conhece, ordenados por função com os novos no topo: de cada um o endereço, as funções, o estado, a CPU e a memória que anunciou, as células que tem e a idade do seu último anúncio. Cada linha abre a página do nó, e um nó que entra na instalação aparece sozinho.
- Escolha um estado acima da lista — Todos, Em linha, Novos, A esvaziar, Fora de linha e Inacessíveis quando há pelo menos um —: ao lado de cada um, o número de nós. Filtrar os nós, ao lado do título, procura no nome e na identidade.
- Um nó novo fica no topo, com o ponto ocre: anunciou-se sozinho e não tem trabalho, e a sua linha oferece Pôr em linha e Rejeitar.
- A CPU acima de 70 % fica a ocre, e também as células acima de 80 % da capacidade declarada; um traço entre as células significa que o nó não tem a função Dados. Quando a instalação tem mais nós do que a lista mostra, Mostrar mais acrescenta os seguintes.
- Pesos e capacidades, ao lado do título, abre os pesos das funções e as capacidades do nó que escolher: um peso vai de 1 a 1000, e 100 é o nó normal da função; um campo de capacidade vazio deixa-a não declarada. Guardar só vale se ninguém tiver alterado o nó entretanto.
- A página de um nó tem à esquerda as sete funções: a que está ligada leva a barrinha, e os serviços da função são fichas acesas quando correm lá e respondem; uma ficha abre, mais abaixo, a configuração e os recursos desse serviço. À direita, a Configuração efetiva, agrupada por origem: a semente do primeiro arranque, o que decide a topologia, o que diz a configuração, o estado do nó e os segredos, ocultados.
- Configurar altera o nome, as funções, os pesos e as capacidades do nó; ao lado estão as ações que o seu estado permite, cada uma com confirmação prévia.
- Recursos mostra o anfitrião do nó: em Agora CPU, memória, rede, disco, tráfego mensal e processos, atualizados a cada 5 segundos pelo serviço de identidade do nó; em Última hora e Hoje a CPU e a memória minuto a minuto, como os serviços as anunciaram.
Sugestão Um segredo nunca sai do processo que o tem: a página mostra apenas o seu nome, de onde vem e a etiqueta de ocultado. A configuração só muda quando um serviço reinicia.
Pôr nós em linha, esvaziá-los e desativá-los
Cada estado de um nó oferece apenas as ações que o registo da topologia admite a partir dele: na linha de um nó novo em Nós, e no cabeçalho da página de cada nó, ao lado de Configurar. Cada ação pergunta primeiro, nomeando o nó e dizendo o que vai realmente acontecer; o que nada desfaz — Rejeitar, Desativar e Declarar caído — confirma-se escrevendo a identidade do nó.
- Novo: Pôr em linha dá trabalho ao nó — células novas, as células que a topologia desloca, salas, trabalhos de renderização, montagens —, e a topologia só o aceita quando tem notícias do nó: pelo menos um dos seus serviços se anuncia ou, para um nó só com a função Entrada, que não tem serviços a anunciar, a sua entrada responde. Até lá o botão fica desativado e diz porquê. Rejeitar é a desativação do nó: sai de todas as vistas, a sua identidade e a sua época nunca mais são reutilizadas, e um processo seu que tente juntar-se de novo fica de fora.
- Em linha: Esvaziar faz com que o nó deixe de receber trabalho de imediato e desloca as suas células para os nós menos carregados, no máximo 4 de cada vez; um bucket que monta é montado noutro nó de armazenamento, enquanto uma pasta no seu disco fica e terá de a mover a partir de Armazenamento. Quando não lhe resta nada e os seus pedidos em curso terminaram, no máximo em 30 segundos, fica fora de linha por si só. Um nó inacessível não se esvazia.
- A esvaziar: o cartão Esvaziamento em curso acompanha o esvaziamento a cada 5 segundos enquanto está à vista — quem o iniciou e quando, as células ainda no nó em relação às que tinha, com os seus tipos, as deslocações abertas por fase, e o que o retém, por palavras: células cuja deslocação foi recusada ou cancelada, tipos que nenhum nó em linha pode receber, uma pasta no seu disco, serviços que não fecharam o recenseamento das suas células, um nó que ficou em silêncio —, ou Nada o retém. Interromper o esvaziamento volta a pôr o nó em linha: as deslocações do esvaziamento ainda não atribuídas são canceladas e as suas células ficam nele.
- Inacessível, ou a esvaziar e em silêncio: Declarar caído, que nunca é oferecido para um nó que tenha a função Controlo. A confirmação diz primeiro a política de recuperação em vigor, lida nesse momento. A topologia só aceita a declaração quando o lease do nó expirou há mais de 10 segundos, e recusa-a antes disso: com a recuperação automática, declara o nó caído por si nesse momento, por isso confirmar nunca o faz mais cedo; com a recuperação manual, a sua confirmação é a única forma de as células do nó recomeçarem noutro sítio. A política é uma chave de Encaminhamento.
- Caído: o cartão Recuperação do nó caído acompanha as suas células enquanto recomeçam noutros nós a partir do seu último instante copiado; as montagens que tinha perdem-se, e um destino que desde então ninguém serve é nomeado até que o monte noutro nó de armazenamento. Pôr em linha fica desativado, e diz porquê, até que a topologia volte a ter notícias do nó: então interrompe a recuperação, e o que já recomeçou noutro sítio fica lá.
- Fora de linha: Pôr em linha volta a dar trabalho ao nó; Desativar remove-o para sempre, como Rejeitar faz para um nó novo, e a topologia recusa enquanto o nó ainda tiver células, deslocações, montagens ou leases.
- Um sucesso aparece num aviso e a página volta a ler o nó: o seu cabeçalho diz em que estado o nó ficou. Uma recusa aparece sob o cabeçalho, com as palavras do seu motivo.
Sugestão A topologia nunca declara caído o seu próprio nó nem um que tenha a função Controlo, e recusa esvaziar o último nó em linha com a função Controlo, Identidade ou Dados, ou o último que escreve num destino ativo: a recusa nomeia a função ou o destino.
Ler as células
Células mostra onde residem os dados da instalação: cada célula é uma base de dados SQLite com um único nó proprietário. A linha sob o título conta as células, os seus tipos e os nós de dados; o gráfico, os tipos e as tabelas dizem como as células se distribuem e qual o seu tamanho.
- Escolha, ao lado do título, o que o gráfico mostra: Por nó desenha uma coluna para cada nó de dados e a linha da capacidade em células que cada nó declara — um nó acima de 80 % da sua capacidade fica a ocre, um nó novo, ainda sem trabalho, na cor da consola —; Por tipo desenha uma linha para cada tipo de célula, com os nós que o guardam; Por organização mostra as organizações com mais células, com os seus nós e, para uma organização dividida, os serviços em que as suas entidades têm células próprias.
- Células por tipo tem um mosaico para cada tipo, com a sua contagem e o seu tamanho. Um tamanho são os bytes das bases de dados das células, o que uma deslocação transfere: os serviços só os medem enquanto alguém observa a secção, por isso numa primeira visita os tamanhos estão a chegar e aparecem com os próximos anúncios; a linha sob os tipos diz depois de quantos nós vem o recenseamento que os dá e há quanto tempo foi feito. Um tamanho medido numa parte das células diz quantas foram medidas.
- Maiores células lista as células com as maiores bases de dados e Escritas mais recentemente as que foram escritas por último, cada uma com o nó que a guarda. Ninguém conta as escritas de uma célula: as células mais ativas mostram-se como as escritas mais recentemente.
- Células e tamanhos por nó é o gráfico por nó em palavras: para cada nó o seu estado, as suas células, a sua capacidade com a parte usada, ou não declarada, o tamanho das suas células, a idade do seu recenseamento e as células postas de parte. Um nó que regressa depois de uma recuperação põe de parte uma célula cujas cópias não tinham todas as suas escritas: fica à espera de um operador, e a tabela di-lo.
- A secção volta a ler-se sozinha enquanto está à vista — a cada 10 segundos enquanto algo chega ou se desloca, a cada 30 segundos caso contrário —; Atualizar lê-a de imediato.
- Num ecrã estreito os cartões ficam uns sob os outros, e o gráfico por nó desloca-se lateralmente dentro do seu cartão; para um leitor de ecrã, os valores do gráfico são os da tabela Células e tamanhos por nó.
Sugestão As contagens vêm do registo da topologia e são exatas; os tamanhos vêm do último recenseamento dos serviços, e ninguém mede os discos enquanto ninguém está a ver.
Reequilibrar as células
Plano de reequilíbrio mostra o que o reequilibrador deslocaria para nivelar os nós de dados: apenas o próximo lote, porque ninguém mede a carga de uma única célula e o reequilíbrio completo não se pode prever. Ao lado, o interruptor do reequilibrador automático e o cartão Porque, seguido do nome de um nó, que diz para onde vão as células novas e porquê.
- Leia a etiqueta do plano: simulação é o próximo lote tal como o reequilibrador o calcula agora; autorizado, depois de um operador o ter aplicado; em curso, com quantas deslocações do lote já chegaram; aplicado, quando todas chegaram. O lote é descrito pelas suas células, os seus bytes, os nós que deixa e os que alcança, e depois por uma linha para cada tipo e percurso.
- Leia sob o plano o que o reequilibrador está a fazer e porquê — equilibrado, à espera de que a diferença se mantenha, desligado, a assentar depois do lote anterior, sem orçamento —, com a diferença entre os nós de dados e o limiar, e o orçamento da última hora: deslocações, bytes e deslocações em simultâneo.
- Aplicar o plano, oferecido enquanto um reequilíbrio é devido, autoriza o reequilibrador: na sua próxima ronda, dentro de segundos, pede o lote tal como o calcular então, que pode ser diferente do mostrado, e sempre dentro do seu orçamento. Vale mesmo com o reequilibrador automático desligado, e não espera a duração mínima. A etiqueta acompanha depois o lote, e a linha sob o plano diz quem o autorizou e o que o reequilibrador fez.
- Quando o reequilibrador já não pediria um lote — menos de dois nós de dados com pontuação, um esvaziamento em curso, uma diferença dentro do limiar, o lote anterior a assentar, o orçamento esgotado, tamanhos ainda em falta, nenhuma célula medida que se possa deslocar —, a topologia recusa e o cartão diz porquê, por palavras.
- Reequilibrador automático: Desligar mantém o plano calculado e mostrado aqui, mas não desloca nada por si — um plano ainda se pode aplicar, e os esvaziamentos e as recuperações deslocam as suas células como sempre —; Ligar deixa o reequilibrador pedir lotes por si quando a diferença se mantém acima do limiar durante a duração mínima. Ambos perguntam primeiro.
- Leia o cartão Porque: a pontuação de carga do nó para onde vão as células novas dos serviços de dados — a parte livre: mais alta, mais livre — com o seu motivo, as medidas que a compõem, cada uma com a sua parte em uso e o seu peso, os candidatos mais livres e a histerese, que mantém o trabalho novo no nó escolhido antes enquanto este se mantiver perto do melhor.
Sugestão Os esvaziamentos e as deslocações dos operadores não contam no orçamento do reequilibrador. Limiar, duração mínima, orçamento e quando uma célula conta como fria são chaves da política, em Encaminhamento.
Deslocar uma célula e acompanhar as deslocações
Deslocações em curso lista as deslocações abertas das células, seja quem for que as pediu — o reequilibrador, um esvaziamento, uma recuperação ou um operador —, e a partir de Células pode deslocar uma célula por si para o nó de dados que escolher.
- Leia cada deslocação: a célula pelo seu tipo e a sua chave, o nó que deixa e o que alcança, a sua fase — Em transferência, Copiadas, Atribuídas — com uma barra, quem a pediu e quando; um passo que continua a falhar é indicado sob a fase, com quantas vezes falhou.
- Parar interrompe uma deslocação em transferência ou copiada pedida por um operador ou pelo reequilibrador: a célula continua ativa no seu nó, na mesma época, e o que o destino restaurou até então é descartado; uma célula cuja deslocação do reequilibrador pare não volta a ser escolhida por ele durante um dia. Uma deslocação de um esvaziamento ou de uma recuperação não tem Parar e diz de quem é: um esvaziamento interrompe-se a partir da página do nó, uma recuperação voltando a pôr o nó em linha. Uma deslocação atribuída já não se pode parar.
- Deslocar… numa linha de Maiores células ou de Escritas mais recentemente abre a caixa de diálogo com a célula e o nó que a guarda: escolha o destino entre os outros nós de dados em linha e prima Deslocar.
- Deslocar uma célula…, ao lado do título, pede o tipo, a chave tal como o registo a escreve — uma organização, um utilizador, ou organização/impressão digital para uma entidade — e o nó de destino, e lê qual nó guarda a célula antes de perguntar. A pesquisa da consola também encontra Deslocar uma célula…, e abre a sua caixa de diálogo.
- A confirmação nomeia a célula, o nó que deixa e o que alcança: as suas escritas esperam enquanto a origem a entrega e o destino a restaura, a origem remove os seus ficheiros depois do período de carência, e uma deslocação de um operador não conta no orçamento do reequilibrador.
- Uma recusa é indicada na caixa de diálogo, por palavras: uma célula que já se está a deslocar ou que já está nesse nó, um destino que não aceita células novas ou não tem a função, demasiadas deslocações abertas desse serviço no nó, uma célula sem um lugar próprio — uma entidade de uma organização não dividida desloca-se com a sua organização.
Sugestão Enquanto uma célula se desloca, as suas escritas esperam e é-lhes pedido que tentem de novo, e a sua época recusa uma escrita atrasada: nada se perde.
Ver para onde vai o trabalho novo
Encaminhamento diz para onde vai o trabalho novo e porquê: a política da topologia, a pontuação de cada nó, o nó escolhido para cada atribuição e as últimas escolhas com a sua motivação. A linha sob o título conta os nós e as atribuições, e lembra que uma pontuação é a parte livre: mais alta, mais livre.
- Pontuações lista cada nó em cada função que recebe trabalho — Dados, Computação, Armazenamento — com o seu estado, o peso da função quando não é 100, a sua pontuação e as suas medidas, cada uma com a sua parte em uso e a sua parte dos pesos da função; uma medida acima de 70 % para a CPU, ou de 80 % para as outras, fica a ocre. Um nó que ainda não anunciou uma carga di-lo; Carregar mais nós lê os seguintes.
- Nós escolhidos diz para onde vai agora o trabalho novo — as células novas de cada serviço de dados, as salas novas das chamadas, os trabalhos de renderização, as leituras e as escritas de cada destino montado —, cada um com o seu nó, o seu motivo e desde quando está escolhido. Uma atribuição que nenhum nó em linha pode receber é nomeada sob a lista.
- Abra Porque sob uma linha para ler a motivação da escolha: a pontuação com o seu motivo — o mais livre, o único candidato, o nó que pede ou o escolhido antes dentro da histerese —, as medidas com a sua parte em uso e o seu peso, os candidatos mais livres e a histerese. Uma motivação deixada aberta continua aberta quando a secção volta a ler.
- Escolhas recentes lista as últimas escolhas, da mais recente para a mais antiga: a hora, a atribuição, o nó escolhido com o seu motivo, e a célula e o nó que pediu, quando existem. Atribuição restringe-as a uma atribuição, e Carregar mais lê as mais antigas. A motivação de uma escolha passada mostra as medidas desse momento, não os pesos com que foi feita, que o registo não guarda.
- A secção volta a ler-se a cada 30 segundos enquanto está à vista; Atualizar lê-a de imediato.
Sugestão Quantas escolhas o registo guarda é uma chave da política, Escolhas guardadas: Escolhas recentes mostra apenas as que foram guardadas.
Alterar a política da topologia
Política, em Encaminhamento, contém as chaves da topologia em três partes — Carga, Reequilíbrio e Nós —, cada uma com o seu valor, o valor predefinido quando o valor difere dele, e quem a alterou e quando. Alterar… ao lado de uma chave abre o seu formulário.
- Carga: Pesos das medidas, quanto conta cada medida na pontuação de um nó de dados, de computação e de armazenamento — 0 exclui uma medida, e cada função mantém pelo menos uma acima de zero; Saturação, onde um nó conta como cheio em ligações, pedidos em curso e células abertas; Histerese, quão perto da melhor pontuação o nó que pede, ou o escolhido antes, mantém o trabalho novo; Escolhas guardadas, quantas escolhas o registo guarda para Escolhas recentes.
- Reequilíbrio: Reequilibrador automático, o mesmo interruptor de Células; Limiar da diferença, a diferença entre as pontuações dos nós de dados que inicia um reequilíbrio, que termina quando ela desce para metade; Duração mínima, quanto tempo a diferença tem de durar antes de o reequilibrador pedir um lote por si; Orçamento, as deslocações e os bytes por hora e as deslocações em simultâneo; Fria após, ao fim de quanto tempo sem escritas uma célula está fria — o reequilibrador desloca primeiro as frias, e 0 torna fria cada célula.
- Nós: Nós que se juntam, se um nó que se junta fica em linha por si ou fica novo até que um operador o ponha em linha a partir de Nós; Recuperação, se a topologia declara caído por si um nó em silêncio quando o seu lease expirou há mais de 10 segundos, ou espera que um operador o faça a partir da página do nó — até lá, as células do nó não podem ser alcançadas.
- No formulário cada campo indica os limites que a topologia aceita, e um valor errado é indicado sob o seu campo e não é enviado. Guardar pergunta primeiro, dizendo o que a alteração faz realmente — para onde vai o trabalho novo, o que o reequilibrador poderá pedir, quem declara um nó caído —, depois escreve a chave e volta a ler a secção.
- Cada alteração fica escrita no registo da topologia com o seu nome: a linha sob a chave diz quem a alterou e quando, e Eventos mostra-a.
Sugestão A consola verifica cada valor com os limites da topologia e não escreve um valor que fique fora deles; a topologia só recusa um valor quando é uma topologia de outra versão, com limites diferentes, e a recusa é dita com as palavras da secção.
Rastrear um pedido
Rastreios dos pedidos, em Encaminhamento, lista as janelas de recolha e os rastreios que recolheram. Um pedido só é rastreado dentro de uma janela aberta por um administrador: fora dela, nenhum serviço regista nada sobre ele.
- Abrir uma janela… pergunta o que recolher — um utilizador, pela identidade pseudónima que os eventos mostram; uma app, pelo client_id a que o seu token se destina; ou um caminho como o gateway o recebe, a começar por /api/ —, durante quantos minutos, no máximo 30, e porquê. O motivo fica nos eventos da topologia com o seu nome, e há no máximo quatro janelas abertas ao mesmo tempo.
- Os serviços começam a recolher no anúncio seguinte, em 5 segundos, e param quando a janela termina ou quando a fecha antes com Fechar.
- Cada rastreio recolhido é uma linha: quando, o pedido, o seu resultado, a app e o utilizador, o tempo no sistema. A linha leva à página do rastreio.
- A página do rastreio mostra o percurso: uma linha por etapa — a entrada pelo gateway, o encaminhamento para o nó que possui a célula, as verificações do token, a célula em SQLite, os bytes do armazenamento —, cada uma com o seu nó e serviço, o seu tempo e o seu resultado, depois o tempo no sistema. Enquanto ainda puderem chegar mais etapas, a página volta a ler o rastreio sozinha.
- Access token mostra o que viu o serviço que verificou o token: o cabeçalho e o conteúdo, os primeiros caracteres da assinatura e cada verificação com a sua regra. Os pedidos recusados com o mesmo token na janela são listados com o motivo por extenso, e as etiquetas sob o percurso só se acendem quando uma sonda do serviço de identidade as confirma.
- Copiar o rastreio copia a página como texto, sem a assinatura.
Sugestão O token nunca é guardado: um rastreio contém o seu cabeçalho e conteúdo descodificados, o resultado de cada verificação e os primeiros 12 caracteres da assinatura. Os rastreios vivem apenas na memória da topologia, no máximo uma hora depois de a sua janela terminar.
Consultar o armazenamento
Armazenamento mostra onde residem os bytes da instalação: uma coluna por classe — ficheiros dos utilizadores, anexos, pré-visualizações e cópias das bases de dados — com os seus destinos, quão cheio está cada um face aos seus limiares, e os nós de armazenamento que os montam e quantos bytes servem.
- Leia cada coluna: o destino contornado é o ativo da sua classe, o que recebe as novas escritas; sob cada destino vê o seu tipo (disco ou S3), a sua pasta ou bucket, o medidor face ao seu limiar de espaço e os nós que o montam.
- A marca no medidor indica onde a rotação prepara o destino seguinte; para lá dela o medidor fica ocre, e ao atingir o limiar o destino seguinte pronto na classe torna-se o ativo por si só.
- Leia Montagens: uma linha por nó de armazenamento, com os destinos que monta e o estado de cada montagem, a época da sua última alteração e os bytes que serve por segundo.
- Leia os eventos do armazenamento no fundo da página: quem registou, ativou, montou ou esvaziou o quê, do mais recente para o mais antigo; Mostrar mais lê os anteriores.
- A página volta a ser lida a cada 30 segundos enquanto está à vista; Atualizar lê-a de imediato.
Sugestão Um destino sem limiar mostra apenas os bytes contados desde o seu registo: os contadores são indicativos, e a rotação decide apenas com base numa contagem que o nó de armazenamento faz listando o destino.
Gerir os destinos
Em Armazenamento adiciona um destino — uma pasta no disco de um nó de armazenamento ou um bucket de um serviço compatível com S3 — e ativa-o, sela-o, esvazia-o, retira-o e altera os seus limiares; Rotação define quando o destino seguinte tem de estar pronto e quando passa a ser o ativo.
- Prima Adicionar destino: dê-lhe um nome e a classe que irá servir, escolha disco com uma pasta absoluta ou S3 com endpoint, região, bucket e a referência da credencial — o nome que o nó de armazenamento resolve a partir dos seus próprios segredos, nunca a credencial —, o nó de armazenamento que o monta e, se quiser, os seus limiares. O nó verifica-o antes de o servir; até lá, é novo.
- Abra o menu de um destino com o seu botão: oferece apenas o que o seu estado permite. Ativar para uma classe torna-o o ativo dessa classe; Selar passa cada classe que serve para o seu destino seguinte, aquele que a rotação escolheria, e a confirmação nomeia-o.
- Limiares… define o espaço, em GB ou TB, e os objetos; um campo vazio significa nenhum limiar. A rotação considera os novos limiares na sua próxima passagem.
- Esvaziar move os bytes de um destino selado para o ativo da sua classe, em segundo plano; Suspender o esvaziamento interrompe-o. Retirar remove um destino pronto que nunca recebeu bytes: confirme-o escrevendo o seu nome.
- Prima Rotação para definir a preparação e a rotação, em percentagem do limiar, e se o destino que a rotação sela se esvazia por si só para o novo ativo.
Sugestão Cada ação pergunta primeiro, nomeando o destino e dizendo o que vai acontecer; quando a topologia recusa, o motivo aparece junto ao destino, por palavras.
Montar, desmontar e esvaziar
Um destino serve os seus bytes a partir dos nós de armazenamento que o montam: Montagens mostra uma linha por nó de armazenamento e, a partir do menu de um destino, monta-o num nó, desmonta-o de um nó ou move uma montagem para outro nó.
- Leia Montagens: cada nó de armazenamento com os destinos que monta, o estado de cada montagem — um ponto verde serve, um ocre está a ser verificado, um anel está a ser desmontado —, a época da sua última alteração e os bytes que serve por segundo.
- Escolha Montar em… no menu, ou o botão num destino que ninguém serve: selecione um nó de armazenamento, novo ou em linha, e o modo. O nó verifica a pasta ou o bucket antes de servir.
- Escolha Desmontar de um nó: o nó deixa de admitir operações novas, permite que as que estão em curso terminem durante no máximo 60 segundos e cancela as restantes. O último nó que serve em escrita um destino ativo não pode ser desmontado enquanto outro destino não estiver ativo: a confirmação di-lo.
- Escolha Mover de um nó… para mover uma montagem para outro nó de armazenamento, novo ou em linha: o primeiro drena, o segundo verifica.
- Enquanto um destino se esvazia, o seu cartão mostra a barra rumo ao destino ativo da sua classe com a parte das referências movidas, depois o período de carência, a remoção das cópias antigas e a verificação por contagem.
Sugestão Desmontar nunca perde um byte: as leituras passam para outro nó que monte o destino e, sem nenhum, os seus ficheiros respondem «indisponível» até voltar a ser montado — nunca «não encontrado».
Ler o mapa da instalação
Mapa mostra toda a instalação de relance: os nós em três faixas por função, cada nó de dados um bloco com o mosaico das suas células face à sua capacidade, as cópias contínuas das bases de dados com a fita das suas últimas rondas, e os últimos eventos que alteraram a instalação, cada um com o seu autor.
- Leia as faixas: Entrada · controlo · identidade tem um bloco por nó com as suas funções e os serviços que nele respondem; Dados tem um bloco por nó de dados — o seu nome, o seu estado, o mosaico de quarenta posições (as suas células face à capacidade declarada em Pesos e capacidades, ou face ao nó de dados mais cheio quando não há nenhuma declarada), quantas células guarda e a sua CPU —; Computação · armazenamento · TURN tem uma ficha por nó. Cada bloco e cada ficha abre a página do seu nó.
- Siga um nó que cai: um contorno ocre diz que o seu lease não é renovado; um contorno vermelho com «isolado · N» diz que o lease expirou e o nó se isolou por si próprio; «fora de linha · N» diz que a topologia o declarou caído e está a recuperar as suas células a partir das cópias — as posições que perdeu têm contorno vermelho —, e os nós que as recebem têm o contorno na cor da consola, com as posições recebidas mais escuras, durante uma hora depois de a recuperação terminar.
- Escolha o que diz a cor dos blocos com Funções · Carga · Células: os estados, a CPU (a ocre acima de 70 %) ou as células face à capacidade (a ocre acima de 80 %).
- Cópias contínuas diz com que frequência cada processo copia as suas bases de dados, a fita das últimas trinta rondas da instalação — cada barra a ronda mais longa do seu segundo, a mais recente na cor da consola, uma mais longa do que a cadência a ocre —, para onde vão as cópias e até quanto tempo atrás se pode restaurar uma base de dados.
- Eventos mostra os últimos eventos que alteraram o mapa, uma série de células recuperadas ou deslocadas numa só linha, com o seu autor: uma pessoa com o seu nome de utilizador, uma tarefa como «topologia», um nó com o seu nome. Todos os eventos abre a secção Eventos.
- O mapa volta a ler-se a cada 5 segundos enquanto está à vista; Atualizar lê-o de imediato. Uma instalação com mais de quatro linhas de nós de dados desloca-se dentro do cartão.
Sugestão Quando um nó cai, mantenha o mapa aberto: vê o lease expirar, o nó isolar-se por si próprio, as suas células bloqueadas e recuperadas nos nós menos carregados — e em Eventos quem fez o quê, minuto a minuto.
Ler os eventos da topologia
Eventos é o registo da topologia, do mais recente para o mais antigo: o que aconteceu à instalação — aos seus nós, células, leases, armazenamento e política —, cada evento com o seu autor, uma pessoa ou uma tarefa da topologia. A linha sob o título diz quantos eventos o registo guarda.
- Escolha um tipo acima da lista — Todos, Nós, Células, Leases, Armazenamento, Política, Topologia — e um nó em Nó: a lista mostra os eventos dessa família que nomeiam esse nó, como seu objeto ou entre os nós de antes e de depois. Os filtros ficam no endereço da página, pelo que uma ligação os mantém.
- Leia cada linha: a hora, com a data quando não é hoje; o ponto e a palavra da família; o que aconteceu, por palavras; o seu objeto — um nó é uma ligação para a sua página, uma célula é o seu tipo e a sua chave —; e por baixo o seu autor: um administrador pela sua conta, uma tarefa da topologia pelo que faz, como a presença, os leases ou o reequilibrador.
- Abra Antes e depois numa linha para ler o que o evento alterou, tal como o registo o escreveu; nada significa que não havia valor.
- Carregar mais lê os eventos mais antigos. A topologia lê o seu registo um troço de cada vez: quando um troço não tem eventos para os seus filtros, a consola continua sozinha algumas vezes, depois di-lo e oferece Continuar a procurar — só diz que nenhum evento corresponde quando já não resta nada mais antigo.
- Os eventos novos chegam ao topo a cada 30 segundos enquanto a secção está à vista; Atualizar lê de imediato.
Sugestão Uma alteração da política, um esvaziamento, um nó declarado caído ou um plano aplicado levam o nome de quem o fez: Eventos é onde encontrar quem alterou o quê, e quando.
Atualizar as bases de dados
Atualização verifica, para cada serviço, se as suas bases de dados estão na versão que o servidor espera. Enquanto não estiverem, as funções de dados desse serviço ficam desligadas para proteger os dados.
- Leia cada linha: Total e Desatualizadas, com Atualizado, Atualização disponível, Inacessível — o serviço não respondeu — ou Falha na verificação, com o motivo por baixo da linha.
- Executar atualização só aparece quando algo está desatualizado. A confirmação indica o serviço, quantas bases de dados passam para que versão e que não pode ser anulada: escreva o identificador do serviço que ela mostra — por exemplo auth — e confirme; o servidor atualiza em segundo plano enquanto a linha diz A atualizar…
- A linha volta a ser verificada a cada 2 segundos até o servidor terminar, e um aviso diz como terminou; Falha na atualização diz que não conseguiu.
- O ícone da base de dados abre a página de detalhe, com cada base de dados, o caminho, a versão atual e a de destino e o estado — incluindo Mais recente do que o servidor e Ainda não criada; também dali se pode executar a atualização.
Sugestão Pode fechar a página durante uma atualização: ao reabri-la, volta a vigiá-la.