Quando uma postagem do Mastodon da sua instância não chega aos seguidores em outro servidor, você não vê nenhum erro na tela. A postagem é publicada localmente, mas usuários remotos nunca a recebem. Isso é uma falha de federação, e geralmente fica oculta nos jobs em segundo plano processados pelo Sidekiq, o sistema de fila de tarefas do Mastodon. Este artigo explica como localizar e ler os logs do Sidekiq para rastrear o ponto exato da falha, identificar o servidor remoto que rejeitou a atividade e aplicar a correção adequada.
Falhas de federação podem acontecer por vários motivos: uma instância remota está fora do ar, certificados TLS expiraram, o payload viola limites do servidor ou o servidor remoto bloqueou seu domínio. Os logs do Sidekiq registram cada tentativa de entrega junto com o código de resposta HTTP e a mensagem de erro. Ao examinar esses logs, você pode determinar se o problema é temporário, permanente ou causado por uma incompatibilidade de configuração. Este guia aborda a localização dos logs, métodos de filtragem e padrões de erro comuns para que você resolva problemas de federação sem precisar adivinhar.
Você aprenderá onde os logs do Sidekiq ficam em uma instalação padrão do Mastodon, como filtrar jobs de federação com falha e como interpretar os campos de erro. O artigo também inclui etapas para reenviar atividades com falha e ajustar configurações do servidor quando uma instância remota rejeita consistentemente seu conteúdo.