Haru Utils

FILE COUNT

용량은 남았는데 파일 생성이 안 될 때

inode 고갈 여부를 확인하고 작은 파일이 집중된 디렉터리를 찾아 생성 주체와 보존 정책을 점검합니다.
inode full파일 생성 실패df -i작은 파일메일 큐
환경GNU/Linux · ext4/xfs 등 inode 기반 파일시스템
분류디스크·파일
검토일2026-08-27
진행5단계 · 조회 우선

SAFE OPERATING BOUNDARY

중단·복구 기준부터 확인하세요

STOP CONDITIONS

여기서는 멈추세요

  • 명령 출력의 서버·서비스·경로가 예상 대상과 다르면 변경 단계로 넘어가지 않습니다.
  • 현재 접속 세션, 백업 또는 콘솔 복구 경로를 확보하지 못했다면 상태 변경 명령을 실행하지 않습니다.
ROLLBACK

복구 기준

변경 전 설정과 출력값을 기록하고, 예상과 다른 결과가 나오면 추가 변경을 멈춘 뒤 승인된 운영 복구 절차로 되돌립니다.

ESCALATION PACK

담당자에게 전달할 자료

  • 장애 발생 시각·정상화 시각과 원문 오류 메시지
  • 민감정보를 제거한 조회 명령 출력과 변경 전후 차이
  • 조치 후 동일 조건으로 수행한 재검증 결과
공식 문서와 읽기 전용 진단 명령을 우선 검토했습니다. 실제 서버에서는 설치된 버전의 --help와 man을 함께 확인하세요.

BEFORE YOU START

이런 증상에서 시작합니다

  • 용량은 남았지만 저장 실패
  • 빈 파일도 생성 불가
  • inode 100%

CHECK THE BRANCH

놓치기 쉬운 원인 분기

01

작은 파일이 급증한 경우

세션·캐시·메일 큐·임시 파일처럼 생성 주체가 있는 경로는 보존 기간과 생성 속도를 확인한 뒤 해당 서비스 정책으로 정리합니다.

02

컨테이너 경로인 경우

overlay 계층과 bind mount를 구분하고, 컨테이너 내부 파일인지 호스트 볼륨 데이터인지 먼저 식별합니다.

03

파일 수 집계가 느린 경우

운영 I/O에 영향을 줄 수 있으므로 전체 루트가 아닌 inode가 찬 파일시스템 안에서 상위 경로부터 범위를 좁힙니다.

FOLLOW THE FLOW

순서대로 확인하기

1
조회시스템을 변경하지 않는 확인 단계

inode 사용률 확인

블록 용량과 inode를 함께 비교합니다.

파일시스템별 inode
df -ih
결과 읽기

IUse%가 100%에 가깝다면 큰 파일보다 파일 개수가 문제입니다.

다음 판단

문제 Mountpoint를 기준으로만 탐색합니다.

2
주의서버 부하나 권한을 고려할 단계

파일이 몰린 상위 경로 찾기

파일 수가 매우 많으면 시간이 걸릴 수 있으므로 업무 피크 시간을 피합니다.

/var 하위 파일 분포
sudo find /var -xdev -type f -printf '%h
' 2>/dev/null | sort | uniq -c | sort -n | tail -30
결과 읽기

마지막에 표시되는 경로일수록 파일이 많습니다.

다음 판단

세션·캐시·메일 큐·로그 중 어떤 성격인지 확인합니다.

3
주의서버 부하나 권한을 고려할 단계

후보 경로의 파일 수와 오래된 파일 확인

삭제 전에 생성 패턴과 보존 기간을 확인합니다.

로그 파일 개수
sudo find /var/log -xdev -type f | wc -l
30일보다 오래된 파일 예시
sudo find /var/log -xdev -type f -mtime +30 -print | head -50
결과 읽기

오래된 파일이 많아도 서비스의 공식 정리 기능이 있는지 먼저 확인합니다.

다음 판단

직접 rm을 실행하기보다 생성 서비스를 찾습니다.

4
조회시스템을 변경하지 않는 확인 단계

생성 프로세스와 정책 확인

파일의 소유자·최근 변경 시각과 서비스 로그를 함께 봅니다.

후보 경로 메타데이터
sudo ls -laht /var/log | head -30
최근 시스템 오류
journalctl -p warning --since '-1 hour' --no-pager
결과 읽기

특정 사용자나 서비스가 반복 생성하는지 확인합니다.

다음 판단

서비스별 보존·rotation 설정을 수정할 계획을 세웁니다.

5
변경데이터·서비스 상태가 달라질 수 있는 단계

정리 후 inode 재확인

삭제 명령은 경로별 공식 운영 절차에서 수행하고 이 가이드에서는 자동 제시하지 않습니다.

변경 단계입니다. 실행 전 대상 이름과 경로, 서비스 중단 영향, 복구 방법을 다시 확인하세요.
inode 회복 확인
df -ih
서비스 상태 확인
systemctl --failed --no-pager
결과 읽기

IFree가 회복되고 실패 서비스가 없어야 합니다.

다음 판단

재발하면 파일 개수 알림과 보존 기간 제한을 추가합니다.

PRIMARY REFERENCES

공식 문서

배포판과 버전에 따라 옵션·로그 위치가 다를 수 있습니다. 실행 전 서버의 --help와 로컬 매뉴얼을 함께 확인하세요.

도구 빠른 검색

최근 사용한 도구를 다시 열거나, 이름과 기능으로 검색하세요.

검색어와 도구의 입력·결과는 저장하지 않습니다.

↑↓ 이동 · Enter 열기 · Esc 닫기