Ajuste o registo do Home Assistant mantendo uma linha de base estável ao nível de aviso e ativando a saída de depuração apenas para o componente mais pequeno e durante o período mais curto que permita reproduzir a falha.
A depuração global permanente pode ocultar a primeira exceção útil, aumentar a atividade de escrita e fazer desaparecer contexto anterior devido à rotação, enquanto uma configuração demasiado silenciosa deixa apenas um estado genérico de indisponibilidade. Meça a taxa atual, identifique o logger indicado junto da primeira falha, faça uma reprodução controlada e volte à linha de base depois de guardar e remover os dados sensíveis das evidências.
Estabeleça uma linha de base antes de aumentar a verbosidade
Registe o nível predefinido, o destino do registo, o comportamento da rotação, o crescimento do ficheiro durante uma hora normal e o carimbo de data/hora de um evento conhecido. Guarde a configuração atual dos loggers para que cada alteração temporária tenha um ponto de reversão preciso.
Separe os avisos recorrentes que identificam uma falha real da repetição inofensiva que apenas consome espaço. A linha de base é adequada quando o arranque normal, uma automação de rotina e uma atualização de uma integração deixam histórico suficiente para ver o primeiro erro e o contexto envolvente.
Se o registo já crescer rapidamente na linha de base, identifique o espaço de nomes e a mensagem que mais se repetem antes de ativar mais saída. Aumentar a verbosidade global nesta fase normalmente reduz o valor de diagnóstico ao acelerar a rotação.
Preserve um excerto da linha de base que inclua o arranque, uma automação normal e o período de inatividade posterior. Este excerto servirá de comparação para mostrar se a depuração temporária acrescentou evidências úteis ou apenas mais volume.
Aumente apenas o nível do logger responsável pela falha
Utilize o espaço de nomes da integração ou da biblioteca indicado na primeira mensagem relevante e ative a depuração apenas para esse espaço de nomes. Defina uma hora de início, uma hora de fim, o acionador original e o crescimento máximo aceitável antes de iniciar o teste.
Alterar o nível de registo de uma integração em tempo de execução mantém a recolha limitada ao componente que pode explicar a falha, em vez de abranger todos os subsistemas.
Se o logger selecionado não produzir evidências adicionais, confirme o espaço de nomes exato e se a biblioteca subjacente utiliza outro logger. Adicione um espaço de nomes relacionado de cada vez; reverta a adição anterior quando esta não contribuir.
Faça uma reprodução controlada
Limpe apenas a vista em tempo real ou marque o carimbo de data/hora atual, execute exatamente uma vez a ação que falha e registe a entidade, a integração, o cliente e a hora de correlação. Preserve várias mensagens anteriores à primeira exceção e toda a cadeia de exceções posterior.
Uma captura de depuração direcionada só funciona quando a seleção do logger acompanha o componente que produz os detalhes necessários. Considere o exemplo uma técnica, não uma recomendação de configuração permanente.
Se a falha não se reproduzir, termine a janela de depuração e volte à linha de base, em vez de esperar indefinidamente. Agende outra janela limitada em torno do acionador conhecido, como o arranque, uma cópia de segurança, uma religação ou uma execução de automação.
Remova dados sensíveis, reverta e confirme a cobertura
Desative a depuração temporária, restaure a linha de base guardada e confirme que o crescimento do ficheiro e a atividade de escrita regressaram ao intervalo anterior. Reveja a exportação para detetar tokens, URLs com credenciais, dados de localização, identificadores pessoais, caminhos de webhooks e nomes de dispositivos antes de a partilhar.
Quando as evidências puderem ser específicas do cliente, aplique a comparação entre cliente e servidor antes de aumentar o registo do servidor.
O ajuste é bem-sucedido quando a falha original produz um rastreio útil com carimbo de data/hora, a cópia partilhada não contém dados sensíveis e o registo normal continua a conservar avisos acionáveis após dois reinícios. Escale o problema quando o componente identificado falhar sem emitir qualquer evento de diagnóstico com um espaço de nomes de logger verificado.
Suporte e Dicas
Mais para Ler

Como otimizar as ligações à base de dados do Immich para contentores simultâneos
Não aumente primeiro o valor de max_connections. Meça as sessões do Immich, some a procura total de cada contentor, preserve margem para o administrador...

Como evitar trabalhos ou importações duplicados no Immich
Separe os trabalhos repetidos dos recursos duplicados. Utilize um único caminho de ingestão canónico, controle as novas tentativas e as alterações de caminho e,...

Como reparar o Immich depois de o volume da base de dados ficar cheio
Nunca elimine o WAL do PostgreSQL para libertar espaço. Pare as escritas do Immich, preserve o estado da base de dados, adicione capacidade de...

