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 vizinhos, 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 fica 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.

No painel «Streamers» há uma linha por nó: o indicador de estado e, em um nó defeituoso, ao lado dele também um rótulo textual («Degradado» ou «Offline»; um nó que anunciou uma reinicialização planejada recebe um indicador amarelo e «Degradado» em vez do «Offline» vermelho); 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). Em um nó indisponível, esses três indicadores são exibidos com um travessão: o nó não os informa mais, 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 a função 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, e 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 (Vizinhos e segredos); «Auto» — foi encontrado automaticamente pelo domínio comum. O valor depende do nó a partir do qual se olha, 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 em um vizinho permanente com o qual nunca houve ligação («Último contato» é «nunca»). «Estado» é «Ativo» ou «Inativo». Um vizinho da versão 2.0.2.417 ou posterior que anunciou uma parada ou reinicialização planejada exibe, em vez do «Inativo» vermelho, um «Reiniciando (N s)» amarelo, em que N são os segundos desde o anúncio; o estado se mantém até que o novo processo do nó entre em contato (Catálogo de códigos de alerta). 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 em um 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, em um nó indisponível, continua crescendo: 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 significa 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». O ícone não detecta uma divergência menor: o tempo de funcionamento será exibido com o mesmo erro do relógio do nó. A disponibilidade é indicada por «Último contato»: a idade da última verificação bem-sucedida, «nunca» em um nó com o qual não houve ligação, e um travessão no próprio nó atual, porque ele não consulta a si mesmo.

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 é marcado com o ícone de super-nó.

A seta no início da linha expande os detalhes do nó; ao expandir a linha seguinte, a anterior se fecha. 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 em um 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. A soma das porções dá todo o volume enviado: «Base» absorve a sobrecarga de serviço e tudo o que não é atribuído às demais porções. Só o próprio nó mantém esses contadores 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 permanece por uma semana a partir do último contato, e durante todo esse tempo o estado «Inativo» e o valor crescente em «Último contato» mostram que o nó existia e está em silêncio. O alerta sobre o seu silêncio (Alertas (alerter)) permanece pelo mesmo tempo: um nó que caiu deve se distinguir 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»; em um nó disponível ele fica desativado com a dica «Só é possível esquecer um nó offline», e na linha do próprio nó ele nem existe. O que acontece então depende do tipo do registro, 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 (Vizinhos e segredos), e isso é uma edição da configuração que 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 Vizinhos e segredos, e a operação atrás de NAT, em Nós atrás de NAT.

Topologia

Topologia, modo «Transporte».

A rede do domínio em forma de grafo. A tela constrói três grafos diferentes; o modo é escolhido 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 abre o mesmo grafo. 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 se aplica ao nó escolhido no grafo. Enquanto nenhum estiver escolhido, o botão fica desativado e ao seu lado está escrito o motivo: «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 exibir um contador de alertas ativos. Um clique em uma ligação abre Ligações de transporte com o filtro pelo sentido escolhido — todos os protocolos nesse sentido 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». O centro é 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. A exceção é o próprio nó atual, que 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: em um grafo assim não há ligação verificada nem externa, ao passo que uma ligação rompida e o sentido se veem pelo próprio desenho. As ligações não são clicáveis nesses modos.

Um clique em um nó move para ele o centro do grafo, e um clique em um 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, e 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 ficam 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 sentido selecionado (todos os protocolos nesse sentido); 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 COP3/RTP+FEC (SMPTE 2022-1/2) e RIST ele é «desconhecido». Os valores de telemetria aparecem quando há dados, 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, e 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, PS1 e SRT (o que exatamente é anunciado está em Catálogo comum de recursos). 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 ficam o número total de registros e o link «← Fluxos».

Acima da lista há 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 registros 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ó se abre 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 mostra 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.