Home Assistant 로깅은 안정적인 경고 수준을 기본값으로 유지하고, 문제를 재현할 수 있는 가장 작은 구성 요소에 가장 짧은 시간 동안만 디버그 출력을 활성화하도록 조정하세요.
전역 디버그를 영구적으로 활성화하면 처음 발생한 유용한 예외가 묻히고 쓰기 작업이 증가하며 이전 컨텍스트가 로그 순환으로 사라질 수 있습니다. 반대로 지나치게 조용한 설정에서는 일반적인 사용할 수 없음 상태만 남습니다. 현재 발생률을 측정하고, 첫 번째 장애 주변에 표시된 로거를 식별한 다음, 한 번의 제어된 재현을 수집하고, 증거를 저장하고 민감 정보를 삭제한 뒤 기본값으로 되돌리세요.
상세도를 높이기 전에 기준선 설정
기본 수준, 로그 대상, 순환 동작, 일반적인 한 시간 동안의 파일 증가량, 그리고 알려진 이벤트 하나의 타임스탬프를 기록하세요. 현재 로거 구성을 저장하여 모든 임시 변경 사항에 정확한 롤백 기준을 마련하세요.
실제 장애를 나타내는 반복 경고와 단순히 저장 공간만 차지하는 무해한 반복 메시지를 구분하세요. 정상 시작, 일반 자동화 하나, 그리고 그 이후의 조용한 시간이 첫 번째 오류와 주변 컨텍스트를 확인할 수 있을 만큼의 기록을 남기면 기준선을 통과한 것입니다.
기준선에서도 로그가 이미 빠르게 증가한다면 추가 출력을 활성화하기 전에 가장 많이 반복되는 네임스페이스와 메시지를 식별하세요. 이 단계에서 전역 상세도를 높이면 로그 순환이 빨라져 일반적으로 진단 가치가 떨어집니다.
시작, 일반 자동화 하나, 그리고 그 이후의 조용한 시간이 포함된 기준선 발췌본을 하나 보존하세요. 이를 비교 자료로 사용하면 임시 디버그가 유용한 증거를 추가했는지, 아니면 단순히 양만 늘렸는지 확인할 수 있습니다.
장애를 담당하는 로거만 높이기
가장 이른 관련 메시지에 표시된 통합 또는 라이브러리 네임스페이스를 사용한 다음, 해당 네임스페이스에만 디버그를 활성화하세요. 테스트를 시작하기 전에 시작 시간, 종료 시간, 원래 트리거, 허용 가능한 최대 증가량을 정하세요.
한 통합의 로그 수준을 런타임에 변경하면 모든 하위 시스템이 아니라 장애를 설명할 수 있는 구성 요소에만 수집 범위를 유지할 수 있습니다.
선택한 로거에서 추가 증거가 나오지 않는다면 정확한 네임스페이스와 기본 라이브러리가 다른 로거를 사용하는지 확인하세요. 관련 네임스페이스는 한 번에 하나씩 추가하고, 기여하지 않는 경우 이전에 추가한 항목을 되돌리세요.
한 번의 제어된 재현 수집
라이브 보기만 지우거나 현재 타임스탬프를 표시한 뒤, 정확히 문제가 발생하는 작업을 한 번 수행하고 엔터티, 통합, 클라이언트, 상관관계 시간을 기록하세요. 첫 번째 예외 이전의 여러 메시지와 그 이후의 전체 예외 체인을 보존하세요.
대상 지정 디버그 수집은 필요한 세부 정보를 생성하는 구성 요소에 맞춰 로거를 선택할 때만 효과가 있습니다. 이 예시는 영구 구성 권장 사항이 아니라 기법으로 취급하세요.
문제가 재현되지 않는다면 디버그 시간을 중지하고 무기한 기다리지 말고 기준선으로 돌아가세요. 시작, 백업, 재연결 또는 자동화 실행과 같은 알려진 트리거에 맞춰 다시 제한된 시간을 예약하세요.
민감 정보 삭제, 되돌리기, 범위 확인
임시 디버그를 비활성화하고 저장한 기준선을 복원한 다음, 파일 증가량과 쓰기 활동이 이전 범위로 돌아왔는지 확인하세요. 공유하기 전에 내보낸 자료에서 토큰, 인증 정보가 포함된 URL, 위치 데이터, 개인 식별자, 웹훅 경로, 장치 이름을 검토하고 삭제하세요.
증거가 클라이언트에 따라 달라질 수 있다면 서버 로깅을 확대하기 전에 클라이언트와 서버 비교를 적용하세요.
원래 장애가 유용한 타임스탬프 추적을 생성하고, 공유본에서 민감 정보가 삭제되었으며, 두 번 다시 시작한 후에도 일반 로깅에 실행 가능한 경고가 남아 있으면 조정이 성공한 것입니다. 확인된 로거 네임스페이스에서 진단 이벤트를 전혀 내보내지 않은 채 이름이 지정된 구성 요소가 실패하면 에스컬레이션하세요.
지원 및 팁
더 읽어보기

여러 컨테이너에서 동시 실행할 때 Immich 데이터베이스 연결을 최적화하는 방법
먼저 max_connections를 늘리지 마세요. Immich 세션을 측정하고, 모든 컨테이너의 요구량을 합산하며, 관리용 여유 공간을 확보한 뒤, 실제로 확인된 병목만 조정하세요.

Immich에서 중복 작업 또는 가져오기를 방지하는 방법
반복 작업과 중복 자산을 분리하세요. 하나의 표준 수집 경로를 사용하고, 재시도와 경로 변경을 제어한 다음, 소규모 코호트에서 재진입을 테스트하세요.

데이터베이스 볼륨이 가득 찬 후 Immich를 복구하는 방법
공간을 확보하기 위해 PostgreSQL WAL을 절대 삭제하지 마세요. Immich 쓰기를 중지하고, 데이터베이스 상태를 보존한 뒤, 안전하게 용량을 추가하고 PostgreSQL을 복구한 다음 재발을 방지하세요.

