Instâncias do Mastodon podem ficar lentas ou indisponíveis sem aviso. Você pode notar a timeline federada carregando devagar, falhas ao enviar posts ou a interface web expirando. Esses problemas geralmente vêm de sobrecarga de recursos do servidor, gargalos no banco de dados ou jobs em segundo plano com falha. Este artigo explica como usar os endpoints de health check integrados do Mastodon e ferramentas de administração para auditar o desempenho da instância e identificar problemas antes que afetem os usuários.
Health checks fornecem uma maneira estruturada de monitorar sua instância. O Mastodon expõe vários endpoints que relatam o status de serviços críticos: o servidor web, banco de dados, cache Redis e filas de jobs do Sidekiq. Executando essas verificações regularmente, você pode detectar erros de configuração, esgotamento de recursos e indisponibilidade de serviços precocemente. Este guia aborda os principais health checks, como interpretar suas saídas e quais ações tomar quando uma verificação falha.
Você aprenderá como acessar os endpoints de health check, entender os códigos de status e respostas JSON, e configurar monitoramento básico com ferramentas de linha de comando ou scripts. As etapas se aplicam a instâncias auto-hospedadas rodando Mastodon v3.5 ou superior. Se você administra uma instância em um host gerenciado, verifique se o provedor expõe endpoints semelhantes através do painel de controle.