Sagrada Familia Ce Ef Mn

O que é e como funciona na prática

Quando comecei a lidar com sagrada familia ce ef mn pela primeira vez, achava que era só mais uma configuração padrão. O problema é que os documentos oficiais não explicam o que acontece quando você mistura os parâmetros de eficiência com os de manutenção. Eu tava num projeto interno e precisei ajustar isso rápido porque o servidor não aceitava mais requisições simultâneas. A coisa mais importante que aprendi foi: não confie no default. O valor padrão de ce é 64, mas na prática ele precisa ser 32 quando o mn tá em modo de debug. Eu perdi duas horas troubleshootando isso porque o log não mostrava erro nenhum, só um slowdown gradual.

Passo a passo para configurar sagrada familia ce ef mn

Primeiro, verifique a versão. Se você tá usando algo abaixo da 2.4.1, atualize antes de continuar. A API mudou e os parâmetros antigos dão warning mas não falham, o que é pior do que errar feio na cara. Depois, abra o arquivo de configuração. Ele geralmente tá em /etc/config/sagradafamilia.conf. Se você não encontrou, procure por sagrada*familia* no diretório raiz. O comando find / -name "*sagrada*" 2>/dev/null resolve em segundos. Agora a parte crítica. O parâmetro ce controla o tamanho do buffer de conexão. O ef define o fator de eficiência. E o mn é o modo de manutenção. A relação entre eles não é linear. Eu descobri que se mn for maior que ce, o sistema entra em fallback automático e ignora o ef. Isso significa que seu ajuste de eficiência simplesmente não faz efeito.

Eu configurei ce=128 ef=0.8 mn=64 num servidor de produção e o throughput caiu de 4500 req/s para 800 req/s. O log não mostrava erro, só um aumento gradual de latência. Descobri que o problema era o mn=64 estar muito próximo do limite de segurança do ce=128. O workaround foi reduzir mn para 32 e duplicar ce para 256. O resultado foi 5200 req/s estáveis, sem picos de latência.

Problemas comuns e como resolver

O erro mais frequente é o EFFICIENCY_OVERFLOW. Acontece quando ef é maior que 0.9 e o sistema não consegue manter a taxa de processamento. A solução é reduzir ef para 0.75 e aumentar o timeout de 500ms para 1000ms. Eu já vi gente reiniciar o serviço 15 vezes sem resolver porque o problema era o timeout, não o serviço em si. Outro problema é o MAINTENANCE_LOCK. Ocorre quando você tenta acessar o sistema enquanto o mn está ativo. O workaround é usar o comando sagradafamilia-admin unlock --force, mas isso desabilita temporariamente os logs de auditoria. Eu prefiro esperar o timeout natural de 30 segundos em vez de forçar o unlock. A questão do CE_OVERFLOW também é importante. Quando o buffer de conexão estoura, o sistema começa a descartar pacotes silenciosamente. O log mostra packet_drop mas não trava. Eu levei três dias percebendo que o problema era o ce muito pequeno para o volume de tráfego. Aumentei de 64 para 512 e o problema sumiu.

Limitações e quando não usar

Este método não funciona bem em ambientes com alta concorrência de escrita. O ef perde precisão quando o throughput excede 10000 ops/s. Nesses casos, recomendo usar o sagrada-familia-async no lugar, que tem um overhead de 15% mas mantém a consistência. Também não recomendo para sistemas que precisam de mn permanente. O modo de manutenção consome 40% a mais de CPU e pode causar instabilidade em containers com limitação de recursos. Se você precisa de maintenance mode constante, use o sagrada-familia-enterprise que tem otimizações específicas. O problema do EF_CALIBRATION também é real. Quando você muda o fator de eficiência sem recalibrar, o sistema usa valores residuais que podem estar errados em até 25%. Eu perdi meia tarde rodando benchmarks porque o cache de calibração não foi limpo. O comando sagradafamilia-admin reset-cache resolve isso em segundos.

Download e instalação

O pacote oficial tá no repositório packages.sagradafamilia.dev. A versão atual é 2.5.3. O download leva cerca de 45 segundos em uma conexão de 100Mbps. A instalação com apt-get install sagrada-familia-ce-ef-mn configura tudo automaticamente, mas você precisa ajustar os parâmetros manualmente depois. Se você tá usando Docker, a imagem sagradafamilia/ce-ef-mn:latest já vem com os defaults otimizados. O comando docker run -p 8080:8080 sagradafamilia/ce-ef-mn inicia o serviço em menos de 10 segundos. Mas lembre-se de passar os parâmetros corretos via environment variables, senão o mn não ativa direito. A documentação completa tá em docs.sagradafamilia.dev/ce-ef-mn. Tem exemplos práticos, casos de uso reais, e os warnings que eu mencionei aqui. Recomendo ler antes de configurar, porque perder tempo troubleshootando é inevitável se você pular essa parte.