[Tomcat] 서버 캐쉬 공간 부족

💡 WAS(Web Application Server)인 톰캣(Tomcat) 운영 중 캐쉬 공간 부족 에러 관련 정리

- Tomcat 버전(version): 9.0.70

Tomcat에 대해서 알고 싶으시다면 여기를 보세요!

상황정리

WAS(Web Application Server)인 톰캣(Tomcat: 수컷고양이)을 운영 하다가 캐쉬 공간이 부족하다는 에러를 마주쳤습니다.

org.apache.catalina.webresources.Cache backgroundProcess
정보: The background cache eviction process was unable to free [10] percent of the cache for Context [] - consider increasing the ma
ximum size of the cache. After eviction approximately [8,127] KB of data remained in the cache.

 

톰캣은 캐쉬를 어디서 셋팅하나 했더니 이번 기회에 정리해봅니다.

 

---

 

context.xml 편집

우선 톰캣이 설치된 경로로 가서 conf 디렉토리에 있는 context.xml(없으면 새로 생성) 파일을 열어줍니다.

 

${CATALINA_HOME}/conf/context.xml (없으면 새로 생성)

# context.xml 편집
$ vi ${CATALINA_HOME}/conf/context.xml

# vim 이 설치된 경우 아래 명령어로 편집기를 열면 조금 더 가독성이 좋아요!
$ vim ${CATALINA_HOME}/conf/context.xml

 

톰캣 캐쉬 설정 (How to set cache in tomcat-9.0.70)

context.xml의 resource를 설정하는 것 관련해서 조금 더 자세히 어떤 것들을 설정할 수 있는지 궁금하시다면??
여기를 보세요!

 

위의 에러를 해결하는 방법은 크게 아래 2가지 입니다

캐쉬를 사용하지 않도록 설정한다

<Resources cachingAllowed="false" />

document에 있는 cachingAllowed 속성 설명

 

원문: If the value of this flag is true, the cache for static resources will be used. If not specified, the default value of the flag is true. This value may be changed while the web application is running (e.g. via JMX). When the cache is disabled any resources currently in the cache are cleared from the cache.

 

번역: 이 플래그의 값이 true이면 정적 리소스에 대한 캐시가 사용됩니다. 지정하지 않으면 플래그의 기본값은 true입니다. 이 값은 웹 애플리케이션이 실행되는 동안(예: JMX를 통해) 변경될 수 있습니다. 캐시가 비활성화되면 현재 캐시에 있는 모든 리소스가 캐시에서 지워집니다.

cachingAllowed에 대한 설명을 읽어보면 간단하게는 아래와 같습니다.

1. 기본값은 true
2. 정적 리소스에 대해서만 캐시가 사용됨
3. 톰캣이 실행되는 동안에도 변경이 가능함
4. 비활성화 시 현재 캐시에 있는 모든 리소스 지워짐

 

 

캐쉬 공간 크기를 늘린다

<Resources cachingAllowed="true" cacheMaxSize="100000"/>

cacheMaxSize 단위: Kilobytes
cacheMaxSize 기본값: 10240(KB. 약 10MB)
cacheMaxSize는 각자 서버 상황에 맞게 설정해주세요!

document에 있는 cacheMaxSize 속성 설명

 

원문: The maximum size of the static resource cache in kilobytes. If not specified, the default value is 10240 (10 megabytes). This value may be changed while the web application is running (e.g. via JMX). If the cache is using more memory than the new limit the cache will attempt to reduce in size over time to meet the new limit. If necessary, cacheObjectMaxSize will be reduced to ensure that it is no larger than cacheMaxSize/20.

 

번역: 정적 리소스 캐시의 최대 크기(KB)입니다. 지정하지 않으면 기본값은 10240(10MB)입니다. 이 값은 웹 애플리케이션이 실행되는 동안(예: JMX를 통해) 변경될 수 있습니다. 캐시가 새 제한보다 더 많은 메모리를 사용하는 경우 캐시는 새 제한을 충족하기 위해 시간이 지남에 따라 크기를 줄이려고 시도합니다. 필요한 경우 cacheObjectMaxSize는 cacheMaxSize/20보다 크지 않도록 줄입니다.

cacheMaxSize에 대한 설명을 읽어보면 간단하게는 아래와 같습니다.

1. 캐시 최대 크기(KB). 기본값 10240KB (10MB)
2. 톰캣이 실행되는 동안 변경 가능함
3. 변경된 캐시가 기존 사이즈보다 작게 설정된 경우 서서히 메모리 점유 사이즈를 줄이려고 시도함

 

필요한 경우 cacheObjectMaxSize를 cacheMaxSize / 20 보다 크지 않게 설정하라는데 여기서 cacheObjectMaxSize는 뭘까??

document에 있는 cacheObjectMaxSize 속성 설명

 

원문: Maximum size of the static resource that will be placed in the cache. If not specified, the default value is 512 (512 kilobytes). If this value is greater than cacheMaxSize/20 it will be reduced to cacheMaxSize/20. This value may be changed while the web application is running (e.g. via JMX).

 

번역: 캐시에 배치될 정적 리소스의 최대 크기입니다. 지정하지 않으면 기본값은 512(512킬로바이트)입니다. 이 값이 cacheMaxSize/20보다 크면 cacheMaxSize/20으로 줄어듭니다. 이 값은 웹 애플리케이션이 실행되는 동안(예: JMX를 통해) 변경될 수 있습니다.

음.. cacheObjectMaxSize 역시 실행되는 동안에 변경이 가능 하다고 하네요!

cacheObjectMaxSize와 cacheMaxSize의 관계를 정리해보면

1. 기본값
   1. cacheMaxSize: 10240 KB
   2. cacheObjectMaxSize 512 KB
2. 최대 크기
   1. cacheObjectMaxSize의 최대 크기는 cacheMaxSize / 20이고 만약 cacheMaxSize / 20 사이즈보다 큰 경우 자동으로 cacheMaxSize / 20 으로 줄어든다

무슨 차이인지는 확실히 와닿지는 않네요 :(

 

context.xml 파일이 없는 경우 생성

<?xml version="1.0" encoding="UTF-8"?>
<Context>
    <WatchedResource>WEB-INF/web.xml</WatchedResource>
    <WatchedResource>${catalina.base}/conf/web.xml</WatchedResource>
    <Resources cachingAllowed="true" cacheMaxSize="100000"/>
</Context>

cacheMaxSize는 각자 서버 상황에 맞게 설정해주셔야 합니다아

 

이상 톰캣의 캐시 설정 방법을 정리했습니다 :)

 

 

참고

네이버블로그