최신 버전에서 Home Assistant는 기존의 서비스 (Services)를 동작 (Actions)으로 이름을 바꾸었습니다. 이 화면 변화를 반드시 주의하세요.
아래 세 가지 방법을 쉬운 것부터 심화 순서로 소개합니다. 초보자는 첫 번째 방법을 먼저 사용하는 것을 권장합니다.
방법 1
.
방법 1: 수동으로 정리하기 (가장 안전하고 가장 권장)
이 방법은 Home Assistant에 내장된 도구로 오래된 데이터를 정리합니다. 설정을 실수로 삭제하지 않으며, 최근 디스크 공간이 부족해서 바로 확보하고 싶을 때 적합합니다.
- 개발자 도구 열기: 왼쪽 메뉴에서 개발자 도구 (Developer Tools)를 클릭합니다.
- 동작 탭으로 전환: 상단 메뉴에서 동작 (Actions)을 클릭합니다(구버전에서는 서비스).
- 정리 동작 검색: 검색창에 recorder.purge를 입력하고 나타난 Recorder: Purge를 클릭합니다.
- 정리 매개변수 설정:
- Keep days (보관 일수): 최근 며칠 분량의 기록을 보관할지 입력합니다. 예를 들어 7을 입력하면 최근 7일만 남기고 그 이전은 모두 삭제됩니다.
- Repack (데이터베이스 재구성): 반드시 체크하세요!
- 설명: 체크하지 않으면 데이터는 삭제 표시만 되고 데이터베이스 파일 크기는 거의 줄지 않습니다(컴퓨터의 휴지통과 비슷합니다). 체크해야 실제로 파일이 압축되어 디스크 공간이 확보됩니다.
Apply filter (필터 적용): 보통 체크하지 않습니다.
- 설명: 특정 센서 몇 개의 기록만 삭제하고 싶다면 이것을 체크하고 아래에 엔티티 ID를 추가할 수 있습니다. 하지만 공간 확보가 목적이라면 보통 전체를 정리하므로 체크하지 않습니다.
정리 실행:초록색 실행 (Perform Action) 버튼을 클릭합니다.
- 주의: 클릭 후 화면에 완료라는 뚜렷한 표시는 나오지 않지만 백그라운드에서는 이미 작업이 시작되었습니다. 데이터베이스가 크면(예: 몇 GB) 이 과정에 몇 분 이상 걸릴 수 있습니다. 인내심을 가지고 기다리고 반복해서 클릭하지 마세요.
방법 2: 자동 유지보수 (한 번 설정으로 끝)
매번 수동으로 삭제하고 싶지 않다면 설정 파일을 수정해 Home Assistant가 매일 자동으로 만료된 기록을 정리하도록 할 수 있습니다.
File Editor 설치/열기:설정 파일을 편집하려면 File Editor 또는 Studio Code Server 애드온이 설치되어 있는지 확인하세요.
편집:/config/configuration.yaml 파일을 엽니다.
Recorder 설정 추가/수정:파일에서 recorder: 필드를 찾습니다(없으면 새 줄에 직접 추가). 다음 내용을 복사하세요:
recorder: # 每天自动清理，只保留最近 10 天的数据（根据你的硬盘大小调整，SD卡建议 5-7 天）
purge_keep_days: 10
# 开启自动重组，确保存储空间被真正释放
auto_repack: true
# (可选) 如果你想彻底屏蔽某些传感器不记录历史，可以在这里排除
exclude:
domains:
- automation
# 不记录自动化的触发历史[()][()]
- update
# 不记录更新实体的历史
entities:
- sensor.date
# 不记录日期变化[()][()]
- sensor.time
# 不记录每分钟的时间变化（这个非常占空间！）```[()][()]시스템 재시작:파일을 저장한 뒤 설정 -> 시스템 -> 으로 가서 오른쪽 위의 Home Assistant 재시작을 클릭하면 설정이 적용됩니다.
방법 3: 핵폭탄급 정리 (완전 초기화)
데이터베이스 파일 (home-assistant_v2.db)이 이미 손상되었거나 수십 GB로 커져서 위 방법이 통하지 않는다면 직접 삭제할 수 있습니다. 결과적으로 모든 기록 그래프를 잃게 되지만(빈 화면이 됨) 기기 설정과 자동화는 사라지지 않습니다.
- Home Assistant 중지:
- 개발자 도구 -> YAML로 가서 구성 검사를 클릭해 오류가 없는지 확인합니다.
- SSH 또는 호스트 터미널로 작업해야 합니다. 명령 입력: ha core stop (HAOS인 경우).
- 초보자 대안: 웹 화면에서 바로 재시작을 클릭하고, 재시작이 완료되기 직전의 순간(웹 페이지 연결이 끊길 때)에 2단계를 실행합니다. 다만 충분히 안전하지는 않습니다. Terminal & SSH 애드온 설치를 권장합니다.
데이터베이스 파일 삭제:File Editor 또는 Samba로 /config 폴더에 접근합니다.home-assistant_v2.db라는 파일을 찾아 그대로 삭제합니다.
전원/시스템 재시작:전원을 뽑았다가 다시 꽂거나 터미널에 ha core start를 입력합니다.시스템이 시작되면 몇 KB 크기의 완전히 새로운 빈 데이터베이스 파일이 자동으로 생성됩니다.
공간이 줄었는지 확인하는 방법
- 정리 전: 설정 (Settings) -> 시스템 (System) -> 저장소 (Storage)로 가서 현재 디스크 사용률을 확인합니다.
- 방법 1 또는 방법 3 실행 후: 약 5-10분 기다린 뒤(시스템이 압축을 완료하도록) 다시 저장소 페이지로 돌아오면 사용량이 눈에 띄게 줄어든 것을 볼 수 있습니다.
