Meshwork

A área Meshwork (o seletor de área na barra superior) reúne as telas consolidadas da rede de nós do domínio: a visão geral do domínio, a composição dos nós, os grafos de ligações, as ligações de transporte individuais e o catálogo comum de recursos de rede. É uma visão «de cima» de toda a rede, ao contrário das telas da área «Nó», que mostram um único nó.

Os conceitos da rede, os domínios, a autodescoberta de peers, a operação atrás de NAT e os alertas estão descritos na seção Meshwork.

Visão geral da Meshwork

Visão geral da Meshwork.

O painel consolidado do domínio: todos os nós da rede e os indicadores-chave do domínio em uma única tela. No cabeçalho — o número de nós; abaixo — a faixa de indicadores e as listas.

A faixa de indicadores reúne os blocos «Streamers» (o número de nós), «Fluxos no ar», «Egress» (a largura de banda de saída total, Gbps), «Ligações OK» (as ligações de transporte íntegras em relação ao seu número total) e «Alarmes». O bloco «Alarmes» conta os nós defeituosos e as ligações ativas defeituosas e é destacado quando o valor é diferente de zero.

O painel «Streamers» contém uma linha por nó: o indicador de estado e, num nó defeituoso, ao lado dele também um rótulo textual («Degradado» ou «Offline»); o nome do nó, a região e a função, o número de fluxos no ar, a carga de CPU e o tráfego (entrada/saída). Num nó indisponível, esses três indicadores são exibidos com um travessão: o nó já não os informa, e apresentar os últimos valores conhecidos como se fossem os atuais seria enganoso. A linha de um nó cujo painel de administração está acessível leva às suas telas na área «Nó». Para o papel de administrador, ao lado do estado é exibido o contador de alertas ativos do nó.

O painel «Eventos da frota» é visível para o administrador e consolida os alertas ativos de todos os nós: o horário, o nó a que o evento se refere (com link para o seu painel de administração) e o texto. O modelo da rede está descrito em Meshwork, os alertas — em Alertas (alerter).

Nós

A tela «Nós»: a composição do domínio em forma de tabela.

A composição do domínio tal como o nó atual a vê: os participantes da rede, os seus endereços e o estado da ligação com eles. A tela é tabular; a mesma rede em forma de grafo é mostrada por Topologia.

No cabeçalho ficam o número de participantes (contando o nó atual), o endereço do próprio nó observado de fora («visto como …») e o link «← Fluxos». Abaixo está a linha «Domínios» com a lista dos domínios vinculados, na qual o domínio do nó atual está destacado; quando não há domínios, é exibido «Sem domínios vinculados». Se a Meshwork não estiver configurada, em vez da tabela é mostrado «A Meshwork não está configurada.».

As colunas são «Nó», «Endereço», «Domínio», «Tipo», «Versão», «Estado», «NAT», «Uptime» e «Último contato»; fecha a linha uma coluna sem título com a ação «Esquecer nó». A ordem das linhas é fixa — primeiro os vizinhos permanentes, depois os encontrados automaticamente, e dentro de cada grupo pelo nome do nó; não há na tela ordenação, filtro nem busca.

«Tipo» assume dois valores: «Permanente» — o nó vem da lista de vizinhos (Peers e segredos); «Auto» — foi encontrado automaticamente pelo domínio comum. O valor refere-se ao ponto de observação, por isso na tela de um nó vizinho o mesmo participante pode constar de outra forma. «Versão» é a versão da compilação do nó; os nós a informam pelo domínio, por isso ela é conhecida mesmo para um participante autodescoberto atrás de NAT, cujos dados chegam por um vizinho. Um travessão significa que a versão não chegou até aqui: ou a compilação não a informa, ou não chegou nenhum dado sobre o participante — como num vizinho permanente com o qual nunca houve ligação («Último contato» é «nunca»). «Estado» é «Ativo» ou «Inativo»; após três verificações de ligação malsucedidas seguidas, aparece ao lado o rótulo «Degradado», e na sua dica figuram o número de falhas e o último erro. «NAT» é assinalado apenas num nó atrás de uma tradução de endereços, e o seu «Endereço» é exibido como «Rede interna»: um endereço privado é inalcançável daqui.

«Uptime» é o tempo desde a inicialização do nó. O nó informa não um contador, mas o próprio momento da inicialização, por isso o valor cresce também nos intervalos entre as verificações de ligação e num nó indisponível continua a crescer: a coluna responde à pergunta de quando o nó foi iniciado, e não de quanto tempo ele está em contato. Só uma reinicialização zera o «Uptime», e com ela muda o «Nonce da instância» nos detalhes da linha. Um travessão significa que o nó não informa o momento da inicialização: uma compilação antiga ou um participante com o qual ainda não houve ligação direta. Um travessão com um ícone de relógio é outra coisa: o momento da inicialização foi recebido, mas pelo relógio da estação de trabalho resulta dele um valor impossível — uma hora no futuro ou um prazo maior que dez anos. A dica do ícone diz o mesmo: «O relógio deste nó diverge do nosso — não é possível calcular o uptime». Uma divergência menor o ícone não detecta: o tempo de funcionamento será exibido com o mesmo erro do relógio do nó. Pela disponibilidade responde «Último contato»: a idade da última verificação bem-sucedida, «nunca» num nó com o qual não houve ligação, e um travessão no próprio nó atual — a si mesmo ele não consulta.

O nome do nó é um link para o seu painel de administração; um nó inacessível é exibido como texto comum com a dica «Nó indisponível». A linha do nó atual traz a marca «este nó», e um nó de vários domínios ostenta o ícone de super-nó.

A seta no início da linha expande os detalhes do nó; ao expandir a linha seguinte, a anterior fecha-se. Nos detalhes ficam os pontos de entrada públicos (HTTP e HTTPS), o horário exato do último contato, a nota do nó, a telemetria das verificações (latência, número de falhas consecutivas e no total, último erro), os endereços declarado e observado e o nonce da instância. Uma divergência entre o endereço declarado e o observado é justamente o que significa a tradução de endereços. É mostrado apenas o que o nó informou; quando não há o que informar, é exibido «Não há dados adicionais.». Daqui também o botão «Abrir a administração» leva ao nó vizinho: a linha do nó atual não o tem, e num nó inacessível ele fica desativado com a dica «Nó indisponível». Os pontos de entrada públicos determinam ainda para onde leva a transição: sem eles ela vai pelo endereço de rede do nó, e a entrada realizada não é transmitida para lá (Servidor web e contas).

Uma linha expandida de um nó vizinho com os seus detalhes.

No nó atual os detalhes começam pelo painel «Tráfego Meshwork»: uma barra com as porções da troca de serviço de saída — «Base», «Autenticação», «Pares», «Biblioteca» e «Alertas» —, as velocidades TX/RX e os contadores de troca. As porções repartem todo o volume enviado: «Base» absorve a armação de serviço e tudo o que não é atribuído às demais porções. Tais contadores só o próprio nó mantém sobre si, por isso as linhas dos vizinhos não têm painel.

Uma linha expandida do nó atual com o painel «Tráfego Meshwork».

Um nó indisponível não desaparece da tabela: a linha mantém-se durante uma semana a contar do último contato, e todo esse tempo vê-se que o nó existia e está em silêncio — com o estado «Inativo» e um valor crescente em «Último contato». O alerta sobre o seu silêncio (Alertas (alerter)) mantém-se pelo mesmo tempo: um nó que caiu deve distinguir-se de um nó que nunca existiu. Um vizinho permanente está sempre visível — ele vem das configurações, e não das observações.

Um nó que foi retirado de serviço e não deve voltar é removido pela ação «Esquecer nó» no fim da sua linha (em tela estreita — no cartão do nó). A ação está disponível para o administrador nas compilações a partir da 2.0.1.258 e retira o nó imediatamente, sem esperar o prazo de uma semana. O botão só está ativo na linha com o estado «Inativo»; num nó disponível ele fica desativado com a dica «Só é possível esquecer um nó offline», e na linha do próprio nó ele não existe de todo. O que acontece então depende do tipo da entrada, e a janela de confirmação «Esquecer este nó?» nomeia o caso diretamente: um nó encontrado automaticamente desaparece da visão da rede deste nó e voltará sozinho assim que voltar a responder; um vizinho permanente é riscado da lista configurada de peers (Peers e segredos) — isso é uma edição da configuração e não pode ser desfeita. O segundo caso tem um efeito colateral: a reescrita da lista de vizinhos limpa ao mesmo tempo as linhas autodescobertas da visão, e elas retornam com as trocas seguintes.

A recusa é explicada pelo próprio nó, e a sua resposta é mostrada diretamente na janela de confirmação, que permanece aberta. A resposta «Não disponível.» significa não uma recusa, mas a ausência da própria ação: a compilação do nó não a conhece ou o nó já está parando. Após o êxito, a linha desaparece na atualização seguinte da tabela, e o alerta de silêncio é resolvido dentro de um ciclo de verificação de ligação — ou seja, um pouco depois de a linha desaparecer.

Os campos das linhas estão descritos em Mapa da rede, a configuração dos vizinhos — em Peers e segredos, a operação atrás de NAT — em Nós atrás de NAT.

Topologia

Topologia, modo «Transporte».

Uma visão em grafo da rede do domínio. A tela constrói três grafos diferentes; o modo escolhe-se pelo seletor no cabeçalho — «Transporte» (padrão), «Malha» e «Permanentes». O modo escolhido entra no endereço da página, por isso um link para o grafo desejado é reproduzível. O botão «Nó de origem» devolve o centro do grafo ao nó atual e fica indisponível quando o grafo já está centrado nele. A troca de modo redefine o centro escolhido: cada modo tem o seu. Ao lado fica a mesma ação «Esquecer nó» que na tabela de nós (Nós), mas aqui ela aplica-se ao nó escolhido no grafo. Enquanto nenhum estiver escolhido, o botão fica desativado e o motivo é impresso ao seu lado — «Selecione primeiro um nó no grafo»; para um nó disponível o motivo é outro: «Só é possível esquecer um nó offline». Após a remoção, a escolha é anulada, para que não aponte para um nó que já não existe.

«Transporte» é o grafo de transporte do domínio: os nós da rede e as ligações de transporte entre eles, agrupadas em bundles. Um bundle são as ligações de um mesmo sentido e de um mesmo protocolo; no cabeçalho é mostrado o número de nós, de bundles e de ligações, ao passo que no grafo todos os bundles de um mesmo sentido são reduzidos a uma única aresta, por isso há menos linhas no desenho do que bundles no cabeçalho. Ali mesmo ficam o domínio do nó conectado e os símbolos de ligação. Os símbolos distinguem uma ligação verificada, uma rompida (o peer está fora da rede), uma ligação externa, uma ligação entre peers da Meshwork e o sentido (unidirecional ou bidirecional). Um nó pode ostentar um contador de alertas ativos. Um clique numa ligação abre Ligações de transporte com o filtro pelo sentido escolhido — todos os protocolos entre esse par de nós de uma vez.

«Malha» é a composição do domínio com o centro no nó conectado: a estrela confiável das ligações de que ele próprio participa e as ligações inferidas entre os demais pares. A mesma fronteira é traçada pela nota no cabeçalho: «As ligações entre os demais peers são inferidas, não verificadas por este nó».

Topologia, modo «Malha».

«Permanentes» é o grafo do peering configurado de todo o domínio: os nós e as ligações das listas de vizinhos de cada nó. A seta mostra o sentido da configuração, e uma seta dupla, a configuração mútua; a nota no cabeçalho diz: «As ligações refletem os peers configurados de cada nó; as setas mostram uma configuração unilateral ou mútua». Como centro toma-se o nó com o maior número de ligações configuradas. Um participante que ninguém configurou e que não configurou ninguém não é mostrado neste modo — exceto o próprio nó atual: ele está sempre no grafo.

Topologia, modo «Permanentes».

Nos dois últimos modos, em vez do número de bundles e de ligações, no cabeçalho resta apenas o número de nós, e os símbolos de ligação são substituídos pela nota do modo: num grafo assim não há ligação verificada nem externa, ao passo que uma ligação rompida e o sentido veem-se pelo próprio desenho. As ligações não são clicáveis nesses modos.

Um clique num nó move para ele o centro do grafo, e um clique num nó que já está no centro abre o seu painel de administração. O centro é definido desde o início — em «Transporte» e em «Malha» é o nó atual, em «Permanentes» o nó central —, por isso o primeiro clique sobre ele já abre a administração sem mover o grafo. Se a administração de um nó estiver inacessível, o clique não faz nada. O mapa da rede e os seus símbolos estão descritos em Mapa da rede e catálogo de recursos, os campos dos nós — em Mapa da rede, a operação atrás de NAT — em Nós atrás de NAT.

Ligações de transporte

As ligações de transporte individuais entre os nós do domínio — exatamente as ligações que a «Topologia» agrupa em bundles. No cabeçalho — os indicadores «Ligações» (total), «Saudáveis» (em relação ao número total) e «Verificadas». Ao vir do grafo da «Topologia», a tabela é aberta com o filtro pelo bundle selecionado; o filtro é removido pelo link «← todas as ligações».

Cada linha descreve uma ligação: o indicador de estado, o sentido (a coluna «Ligação», nó → nó), o «Proto» (PS1, SRT e outros canais de transporte), o «Fluxo», a «Identidade» («verificada» ou «inferida», com a marca «reserva» para uma ligação de reserva), o «Âmbito» («interno», «externo», «local» ou «desconhecido») e a telemetria — «TX→RX Mb/s», «RTT» e «Perda». O âmbito é tomado do lado que se conecta por si próprio, por isso nas ligações UDP, RTP, Pro-MPEG e RIST ele é «desconhecido». Os valores de telemetria aparecem quando há os dados correspondentes, caso contrário é exibido «—»; as listas longas são divididas em páginas. O tipo de ligação PS1 / SRT está descrito em Catálogo comum de recursos, os próprios protocolos — em Protocolos Peer de transmissão confiável.

Biblioteca

Biblioteca de recursos do domínio.

O catálogo comum dos recursos de rede ocupados do domínio: as entradas e saídas dos nós pelos protocolos UDP, RTP, Pro-MPEG, RIST, bem como PS1 e SRT. O catálogo é formado automaticamente a partir dos anúncios dos nós e é somente para leitura. Por ele escolhem-se endereços e portas livres e encontram-se os fluxos necessários na rede. No cabeçalho — o número total de entradas e o link «← Fluxos».

Acima da lista está o filtro «Nó de origem»: «Todos os nós» por padrão, e na lista de valores figuram os nós que anunciam algo neste momento. O filtro seleciona os registros de um único nó anunciante e não altera o número de entradas do cabeçalho. As linhas estão ordenadas por nó, domínio e endereço.

As colunas: «Nó» — o nó anunciante, «Domínio», «Tipo» (o sentido e o modo de conexão do ponto: output-multicast, input-caller, output-listen e semelhantes), «Proto», «Destino» (endereço e porta), «Fluxo» (nome ou número) e «Observação». Ao endereço acrescentam-se o âmbito da ligação («local», «interno» ou «externo»; o mesmo atributo existe nas ligações de transporte — Ligações de transporte), a fonte SSM (SSM <endereço>) e o número da VLAN (VLAN <n>). O âmbito da ligação só é exibido nos pontos PS1 e SRT que se conectam por si próprios ao endereço indicado (*-caller): «local» — um endereço do mesmo nó, «interno» — um peer confirmado pela autorização do domínio, «externo» — todos os demais. No RIST, ao lado do protocolo é exibido o peso da ligação (peso <n>).

Um clique na linha abre o painel de administração do seu nó nas estatísticas do seu fluxo: a linha do próprio nó abre-se no lugar, a de um vizinho conforme a configuração «Abrir nós em» da barra superior (Barra comum); Ctrl ou ⌘ força uma nova aba. A linha de um nó indisponível ou desconhecido da rede não tem ação e traz a dica «Nó indisponível». A dica da linha mostra o horário do anúncio do registro.

O catálogo e as regras de escolha de endereços estão descritos em Catálogo comum de recursos; a visão do ponto de vista de uma entrada ou saída específica é Biblioteca — este fluxo.