Que limite de memória deve definir para o Home Assistant?

Eva Wong é a redatora técnica e entusiasta residente na ZimaSpace. Uma geek desde sempre, apaixonada por homelabs e software de código aberto, dedica-se a traduzir conceitos técnicos complexos em guias práticos. A Eva acredita que a auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ajuda a comunidade a desmistificar configurações de hardware, desde montar o primeiro NAS até dominar os contentores Docker.

Não existe um único limite de memória correto para o Home Assistant. Defina o limite com base no pico medido no seu sistema, deixe RAM utilizável para o anfitrião e os outros contentores e considere qualquer encerramento por OOM um indício de que o limite ou a carga de trabalho precisam de ser investigados.

Num servidor doméstico partilhado, uma leitura em repouso não é suficiente: o trabalho do Recorder, as cópias de segurança, o recarregamento de integrações, os painéis e uma sequência intensa de automatizações em toda a casa podem gerar picos diferentes. A abordagem segura consiste em registar uma referência, escolher um limite reversível acima do pico confirmado da carga de trabalho, verificar se o anfitrião continua a ter margem e voltar a testar o período de maior atividade original antes de tornar a definição permanente.

Comece pela utilização máxima, não por um valor genérico de RAM

Meça o contentor do Home Assistant e o anfitrião em simultâneo durante vários dias normais. Inclua um reinício, uma cópia de segurança, uma limpeza ou compactação da base de dados, se a utilizar, a atividade nos painéis e o período mais intenso de automatizações que consiga reproduzir em segurança. Registe o pico do contentor, a memória disponível no anfitrião, a atividade de swap e eventuais alterações no tempo de resposta.

Um limite de memória é uma fronteira do cgroup, não um objetivo de desempenho. Quando um contentor ultrapassa um limite rígido, o kernel pode terminar um processo; o código de saída 137, acompanhado de um estado «terminado por falta de memória (OOM)», é o indício mais útil. É por isso que a utilização máxima observada é mais importante do que uma média ou uma recomendação copiada.

Se a utilização da memória aumentar durante uma tarefa e depois estabilizar, dimensione-a com base nesse pico repetível, deixando uma margem de utilização. Se a memória anónima aumentar durante horas sem baixar depois de a carga de trabalho terminar, interrompa o dimensionamento e investigue uma fuga de memória numa integração, num componente personalizado ou numa regressão de versão. Um limite mais elevado pode atrasar a falha sem a resolver.

Reserve memória para o anfitrião e para todos os serviços alojados no mesmo servidor

Faça uma lista dos serviços que têm de continuar a responder quando o Home Assistant está mais ocupado: o sistema operativo, o Docker, uma base de dados, o MQTT, o DNS, os painéis, os serviços multimédia e as tarefas de cópia de segurança. O limite tem de proteger esses serviços, bem como o Home Assistant; atribuir quase toda a RAM instalada a um único contentor apenas transfere a falha para o anfitrião.

Compare o pico do Home Assistant com a memória disponível no anfitrião durante o mesmo período. A cache que pode ser recuperada não equivale à memória da aplicação, e a atividade de swap pode fazer com que o sistema pareça estar a funcionar enquanto o controlo dos dispositivos fica lento. Se o anfitrião ficar sem margem antes de o Home Assistant atingir o seu pico, reduza as tarefas simultâneas ou transfira um serviço antes de baixar o limite do Home Assistant.

Esta é uma decisão sobre capacidade, não apenas uma definição do Docker. O guia relacionado da ZimaSpace sobre medir o Home Assistant para além da cache aquecida explica por que razão uma carga de trabalho repetível, a frio e intensa, proporciona uma referência mais fiável do que uma captura conveniente em repouso.

Aplique um limite reversível e confirme que é aplicado

Adicione a definição de memória à configuração que efetivamente recria o contentor, como o ficheiro Compose ou a interface de orquestração. Evite confiar numa alteração temporária em execução, que será descartada na implementação seguinte. Guarde a configuração anterior para a poder restaurar de imediato.

Depois de recriar o contentor, inspecione o contentor em execução e confirme que o limite configurado está visível. Em seguida, acompanhe a utilização do contentor, a memória disponível do host, a swap, o número de reinícios e a latência. Uma definição apresentada, mas não aplicada pelo cgroup do host, dá uma falsa sensação de segurança, sobretudo na virtualização aninhada.

Se o contentor reiniciar, não aumente automaticamente o limite. Verifique se o runtime indica OOMKilled e o código de saída 137. Caso contrário, investigue outra causa do encerramento. Se indicar OOMKilled, compare o momento do evento com a carga de trabalho: um pico breve e recorrente sugere margem operacional insuficiente, enquanto um aumento constante sugere uma fuga ou uma integração descontrolada.

Volte a testar com a carga de trabalho doméstica original e intensa do Home Assistant

Repita exatamente o cenário usado como referência: volte a carregar as mesmas integrações, abra os mesmos painéis, execute a mesma sequência de controlo de toda a casa e inclua a mesma atividade de cópia de segurança ou do Recorder. Alterar a carga de trabalho só provaria que um sistema mais leve é suficiente.

Um resultado satisfatório significa que o contentor se mantém abaixo do limite sem eventos OOM, que o host conserva memória disponível, que a swap não provoca atrasos no controlo e que as automatizações são executadas à velocidade habitual. Reinicie duas vezes e volte a verificar após a próxima tarefa em segundo plano agendada, para garantir que o resultado se mantém após a recriação e as tarefas dependentes do tempo.

Reverta o novo limite se o controlo dos dispositivos se tornar pouco fiável, se o contentor entrar num ciclo de reinício ou se a pressão sobre o host continuar grave. Investigue o isolamento das integrações ou compare versões se a memória continuar a aumentar depois de terminada a carga de trabalho que desencadeou o problema; nessa altura, ajustar o limite já não é a solução principal.

FAQ

O Home Assistant deve ter sempre um limite rígido de memória? Num host Docker partilhado, um limite testado pode proteger os outros serviços. Uma máquina dedicada com HAOS ou uma VM têm requisitos diferentes; por isso, não copie um limite de contentor para a alocação de uma VM sem medir o sistema convidado completo.

Uma utilização elevada da memória significa automaticamente uma fuga? Não. A cache e os picos breves de carga podem ser normais. Procure memória anónima que continue a aumentar, eventos OOM, ciclos de reinício ou latência crescente depois de a carga de trabalho terminar.

Deve desativar a swap? Não como primeira medida. Primeiro, perceba se a swap está a ocultar pressão sobre o host ou a evitar uma falha abrupta; depois, altere-a apenas se tiver um procedimento de reversão testado e memória RAM física suficiente para toda a carga de trabalho.

Assistência e dicas

Mais para ler

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.