Regola la registrazione di Home Assistant mantenendo una base stabile a livello di avviso e abilitando l’output di debug solo per il componente più piccolo e per la finestra temporale più breve in grado di riprodurre il problema.
Il debug globale permanente può nascondere la prima eccezione utile, aumentare l’attività di scrittura e far ruotare via il contesto precedente, mentre una configurazione eccessivamente silenziosa lascia soltanto uno stato generico di indisponibilità. Misura la frequenza attuale, identifica il logger indicato nei pressi del primo errore, esegui una riproduzione controllata e torna alla configurazione di base dopo aver salvato e redatto le prove.
Stabilisci una configurazione di base prima di aumentare il livello di dettaglio
Registra il livello predefinito, la destinazione dei log, il comportamento della rotazione, la crescita dei file nell’arco di un’ora normale e il timestamp di un evento noto. Salva la configurazione attuale dei logger, così ogni modifica temporanea avrà un punto di ripristino preciso.
Distingui gli avvisi ricorrenti che indicano un problema reale dalle ripetizioni innocue che consumano soltanto spazio. La configurazione di base è adeguata quando l’avvio normale, un’automazione ordinaria e un periodo di inattività successivo lasciano una cronologia sufficiente per vedere il primo errore e il contesto circostante.
Se il log cresce già rapidamente con la configurazione di base, identifica lo spazio dei nomi e il messaggio ripetuti più spesso prima di abilitare un output maggiore. Aumentare in questa fase il livello di dettaglio globale di solito riduce il valore diagnostico accelerando la rotazione.
Conserva un estratto della configurazione di base che includa l’avvio, un’automazione ordinaria e il successivo periodo di inattività. Sarà il confronto per stabilire se il debug temporaneo ha aggiunto prove utili o soltanto un volume maggiore.
Aumenta il livello solo del logger responsabile dell’errore
Usa lo spazio dei nomi dell’integrazione o della libreria indicato nel primo messaggio pertinente, quindi abilita il debug esclusivamente per quello spazio dei nomi. Prima di iniziare il test, imposta un’ora di inizio, un’ora di fine, il trigger originale e la crescita massima accettabile.
Modificare a runtime il livello di log di una sola integrazione mantiene la raccolta circoscritta al componente in grado di spiegare il problema, invece di coinvolgere ogni sottosistema.
Se il logger selezionato non produce ulteriori prove, verifica lo spazio dei nomi esatto e se la libreria sottostante utilizza un altro logger. Aggiungi uno spazio dei nomi correlato alla volta; annulla l’aggiunta precedente quando non fornisce alcun contributo.
Esegui una sola riproduzione controllata
Cancella solo la visualizzazione attiva oppure annota il timestamp corrente, esegui una volta l’azione esatta che causa l’errore e registra l’entità, l’integrazione, il client e l’ora di correlazione. Conserva diversi messaggi precedenti alla prima eccezione e l’intera catena di eccezioni successiva.
Una raccolta di debug mirata funziona solo quando la selezione del logger segue il componente che produce i dettagli necessari. Considera l’esempio una tecnica, non una raccomandazione per una configurazione permanente.
Se il problema non si riproduce, interrompi la finestra di debug e torna alla configurazione di base invece di attendere indefinitamente. Pianifica un’altra finestra delimitata intorno al trigger noto, come l’avvio, un backup, una riconnessione o un’esecuzione dell’automazione.
Redigi, ripristina e verifica la copertura
Disabilita il debug temporaneo, ripristina la configurazione di base salvata e verifica che la crescita dei file e l’attività di scrittura tornino nell’intervallo precedente. Prima di condividere l’esportazione, controlla la presenza di token, URL contenenti credenziali, dati sulla posizione, identificativi personali, percorsi di webhook e nomi dei dispositivi.
Quando le prove potrebbero dipendere dal client, applica il confronto tra client e server prima di ampliare la registrazione sul server.
La regolazione è corretta quando l’errore originale produce una traccia utile con timestamp, la copia condivisa è stata redatta e la registrazione normale conserva ancora avvisi utili dopo due riavvii. Procedi con un’escalation quando il componente indicato non produce alcun evento diagnostico con uno spazio dei nomi del logger verificato.
Supporto e consigli
Altro da leggere

Come ottimizzare le connessioni al database di Immich per container simultanei
Non aumentare prima max_connections. Misura le sessioni di Immich, somma la richiesta totale di ogni container, mantieni un margine per l'amministratore e ottimizza solo...

Come impedire la duplicazione di processi o importazioni in Immich
Separa i processi ripetuti dalle risorse duplicate. Utilizza un unico percorso di acquisizione canonico, controlla i nuovi tentativi e le modifiche ai percorsi, quindi...

Come riparare Immich dopo che il volume del database si è riempito
Non eliminare mai il WAL di PostgreSQL per liberare spazio. Interrompi le scritture di Immich, preserva lo stato del database, aggiungi capacità in modo...

