Contador de Postagens Recebidas no Relay do Mastodon: Como Monitorar no Admin

Relays do Mastodon agregam postagens públicas de várias instâncias em uma única timeline federada. Como administrador, você precisa saber quantas postagens recebidas seu relay processa para avaliar sua saúde e desempenho. O contador de postagens recebidas é uma métrica integrada na interface admin do Mastodon que mostra o número total de status recebidos das instâncias conectadas. Este artigo explica como acessar e interpretar o contador de postagens recebidas do relay no admin do Mastodon.

O que o Contador de Postagens Recebidas Rastreia nos Relays do Mastodon

Um relay do Mastodon é um serviço que coleta postagens públicas de instâncias participantes e as redistribui para todas as outras instâncias conectadas. O contador de postagens recebidas rastreia o número total de status que o relay recebeu de suas instâncias membros desde que foi criado ou redefinido. Esse contador é um indicador chave da atividade do relay e da saúde da federação.

Quando você inscreve sua instância em um relay, seu servidor envia suas postagens públicas para o relay e recebe postagens de todos os outros assinantes. O contador de entrada é incrementado cada vez que o relay processa um novo status de qualquer instância conectada. Um relay saudável deve mostrar uma contagem de entrada aumentando constantemente. Se o contador permanecer estável ou crescer muito lentamente, pode indicar baixa participação, problemas de conectividade ou configurações incorretas do relay.

O que o Contador Não Mostra

O contador de postagens recebidas é um total simples. Ele não detalha postagens por instância, não mostra o número de autores únicos, nem indica se as postagens foram entregues com sucesso aos seus usuários locais. Para análises detalhadas, você precisa combinar o contador com outras ferramentas admin, como a timeline de federação ou arquivos de log.

Como Visualizar o Contador de Postagens Recebidas no Admin do Mastodon

Siga estas etapas para acessar o contador de postagens recebidas do relay no painel admin web do Mastodon.

1. Abra o painel admin
   Faça login na sua instância do Mastodon como administrador. Clique no menu hambúrguer (três linhas horizontais) no canto superior direito da interface web do Mastodon. Selecione Preferências no menu suspenso.
2. Navegue até Administração > Relays
   Na barra lateral esquerda da página de Preferências, clique em Administração para expandir a seção. Em seguida, clique em Relays. Isso abre a página de gerenciamento de Relays listando todos os relays aos quais sua instância está inscrita.
3. Identifique o relay a ser inspecionado
   Na página de Relays, você vê uma tabela com colunas: URL do Relay, Status (ativado ou desativado) e Postagens recebidas. A coluna Postagens recebidas exibe a contagem total para cada relay.
4. Clique no nome do relay para detalhes
   Clique na URL ou nome do relay para abrir sua página de detalhes. Nesta página, o contador de Postagens recebidas é exibido em destaque no topo, junto com o status do relay e a data em que foi adicionado.
5. Verifique o Dashboard para gráficos de atividade
   Na barra lateral admin, clique em Dashboard. Role até a seção Atividade do relay. Este gráfico plota o volume de postagens recebidas ao longo do tempo, ajudando você a identificar tendências como quedas ou picos repentinos.

Usando a API Admin do Mastodon para Monitoramento Programático

Se você precisar automatizar o monitoramento ou integrar o contador em um painel personalizado, use a API admin do Mastodon. Envie uma requisição GET para o endpoint /api/v1/admin/relays/:id, substituindo :id pelo ID numérico do relay. A resposta inclui um campo statuses_count que contém o total de postagens recebidas.

Para encontrar o ID do relay, navegue até a página de detalhes do relay no painel admin. A URL contém o ID, por exemplo /admin/relays/5 significa que o ID do relay é 5. Você também pode listar todos os relays via /api/v1/admin/relays e extrair o ID da resposta.

Problemas Comuns e Equívocos Sobre o Contador de Postagens Recebidas

O Contador Mostra Zero Mesmo com o Relay Ativo

Se o contador de postagens recebidas permanecer em zero após ativar um relay, pode ser que o relay não esteja recebendo postagens de outras instâncias. Isso pode acontecer se o relay foi recém-criado e nenhuma outra instância se inscreveu ainda. Alternativamente, o relay pode estar mal configurado na sua instância. Verifique se o status do relay mostra Ativado na página de Relays. Se mostrar Desativado, clique no botão Ativar ao lado do relay. Confirme também que as postagens públicas da sua instância estão sendo enviadas ao relay verificando os logs de Federação no painel admin em Administração > Federação.

O Contador Para de Incrementar Após um Período de Atividade Normal

Um contador estável após um crescimento inicial geralmente indica que o relay foi removido por seu proprietário ou que o serviço de relay ficou offline. Verifique o status do relay na página de Relays. Se o relay mostrar Desativado ou Inacessível, o relay não está mais aceitando postagens. Entre em contato com o operador do relay ou considere mudar para um relay diferente. Você também pode inspecionar a saúde do relay visitando sua página de status, se houver.

O Contador Mostra um Número Muito Alto que Parece Incorreto

O contador de postagens recebidas inclui todos os status já recebidos pelo relay desde sua criação. Se o relay estiver em execução há meses, o número pode estar na casa dos milhões. Isso é normal. Para ter uma noção da atividade recente, use o gráfico de atividade do relay no Dashboard em vez do total bruto. O gráfico mostra postagens por dia ou por hora, fornecendo uma visão mais útil do desempenho atual.

Contador de Postagens Recebidas vs Outras Métricas do Relay

Item	Contador de Postagens Recebidas	Gráfico de Atividade do Relay
Descrição	Número total de status recebidos pelo relay desde a criação	Gráfico visual do volume de postagens recebidas ao longo do tempo
Frequência de atualização	Tempo real, incrementa a cada nova postagem	Atualiza a cada poucos minutos
Granularidade	Número cumulativo único	Mostra totais diários ou horários
Caso de uso	Verificação rápida de saúde ou automação	Análise de tendências e detecção de anomalias
Localização de acesso	Admin > Relays > Página de detalhes do relay	Admin > Dashboard > Seção de atividade do relay

O contador de postagens recebidas oferece uma maneira rápida e confiável de confirmar que seu relay do Mastodon está recebendo conteúdo ativamente do fediverso. Ao verificar o contador regularmente e combiná-lo com o gráfico de atividade, você pode identificar problemas cedo e manter seu pipeline de federação funcionando sem problemas. Para monitoramento avançado, use a API admin para exportar os dados do contador para seu próprio sistema de logging ou alertas.