Automatic Log Cleanup

본 Guide가 포함된 Section에서는 AWS Marketplace에서 구독할 수 있는 OvenMediaEngine Enterprise의 기능을 설명합니다.

OvenMediaEngine Enterprise on AWS는 운영 중 지속적으로 Log File을 생성합니다. Log가 누적되면 Disk 사용량이 과도하게 증가할 수 있으므로, 이를 사전에 방지하기 위해 Automatic Log Cleanup 기능을 제공합니다.

Log Cleanup 기본 정책

현재 OvenMediaEngine Enterprise on AWS에 적용된 Automatic Log Cleanup 기본 정책은 다음과 같습니다:

• 보존 기간 (Days): 90일이 지난 Log는 자동으로 삭제됩니다.

• 최소 보존 기간 (Days): 최근 1일 이내의 Log는 보존됩니다.

• 용량 제한 (MB): 총 용량이 1GB (1024MB)를 초과하면, 가장 오래된 File부터 삭제하여 용량을 확보합니다.

• 실행 주기: Automatic Log Cleanup 기능은 기본으로 활성화되어 있으며, 매일 새벽 03:00 (UTC)에 자동 실행됩니다.

위 Policy는 아래 Log에 적용됩니다:

Log Type	Directory	File Pattern	Description
OvenMediaEngine	/var/log/ovenmediaengine	ovenmediaengine.log.*	OME Core Engine Log (Rotated)
Web Console	/var/log/ovenmediaengine/ovenstudio	oven-studio_*.log	Web Console Service Log
OvenMediaEngine Delivery	/var/log/ovenmediaengine/ovenmediaengine-delivery	delivery-daemon.log.*	Recording Delivery System Log
OvenMediaEngine Monitoring	/var/log/ovenmediaengine	events.log.*	OME Monitoring Event Log

Log Cleanup 정책 변경하기

운영 방식에 따라 Log 보존 기간, 용량 제한 등의 Policy 변경이 필요하다면, 아래 절차에 따라 세부 조정할 수 있습니다.

1

Log Cleanup Script 수정

1. EC2 연결 공식 가이드에 따라 Instance에 SSH로 접속한 뒤, 아래 명령어로 Script를 편집합니다:

sudo vi /opt/omee-log-cleanup.sh

2

변수를 이용한 Policy 변경

1. Script 상단에 명시된 '변수'에 기본값이 적용되어 있습니다.

# Configuration (Adjust according to your environment)
RETENTION_DAYS=90    # Max retention period (days)
MIN_RETENTION_DAYS=1    # Min retention period (days) - Safety guard for size limit
MAX_TOTAL_SIZE_MB=1024    # Max allowed size (MB) - e.g., 1GB

Value	Input Range	Description
RETENTION_DAYS	0~ Default: 90	보관되는 Log의 최대 보존 기간 (일; Days)을 설정합니다.
MIN_RETENTION_DAYS	0~ Default: 1	보관되는 Log의 최소 보존 기간 (일; Days)을 설정합니다. 용량 제한에 걸리더라도 이 기간 내의 File은 삭제되지 않도록 보호하는 안전 장치입니다.
MAX_TOTAL_SIZE_MB	0~ Default: 1024	Log를 보관할 Storage의 최대 허용 용량 (MB)을 설정합니다.

1. Script 상단의 변수를 수정하면, Script 하단 cleanup_logs에 전체 적용됩니다.

# 1. OvenMediaEngine Core Logs
cleanup_logs "/var/log/ovenmediaengine" "ovenmediaengine.log.*" $RETENTION_DAYS $MIN_RETENTION_DAYS $MAX_TOTAL_SIZE_MB

# 2. OvenStudio Logs
cleanup_logs "/var/log/ovenmediaengine/ovenstudio" "oven-studio_*.log" $RETENTION_DAYS $MIN_RETENTION_DAYS $MAX_TOTAL_SIZE_MB

# 3. Delivery Daemon Logs
cleanup_logs "/var/log/ovenmediaengine/ovenmediaengine-delivery" "delivery-daemon.log.*" $RETENTION_DAYS $MIN_RETENTION_DAYS $MAX_TOTAL_SIZE_MB

# 4. Events Logs
cleanup_logs "/var/log/ovenmediaengine" "events.log.*" $RETENTION_DAYS $MIN_RETENTION_DAYS $MAX_TOTAL_SIZE_MB

3

Log별 Policy 변경 (선택 사항)

• Log Type별로 서로 다른 Policy를 적용하려면, Script 하단의 cleanup_logs 호출 부분을 직접수정하십시오.

# 1. OvenMediaEngine Core Logs
cleanup_logs "/var/log/ovenmediaengine" "ovenmediaengine.log.*" $RETENTION_DAYS $MIN_RETENTION_DAYS $MAX_TOTAL_SIZE_MB

# 2. OvenStudio Logs
cleanup_logs "/var/log/ovenmediaengine/ovenstudio" "oven-studio_*.log" $RETENTION_DAYS $MIN_RETENTION_DAYS $MAX_TOTAL_SIZE_MB

# 3. Delivery Daemon Logs
cleanup_logs "/var/log/ovenmediaengine/ovenmediaengine-delivery" "delivery-daemon.log.*" $RETENTION_DAYS $MIN_RETENTION_DAYS $MAX_TOTAL_SIZE_MB

# 4. Events Logs
cleanup_logs "/var/log/ovenmediaengine" "events.log.*" $RETENTION_DAYS $MIN_RETENTION_DAYS $MAX_TOTAL_SIZE_MB

Syntax

cleanup_logs "<로그_디렉토리>" "<파일_패턴>" 최대보존기간(일) 최소보존기간(일) 허용용량(MB)

Example

• Main Log (ovenmediaengine.log.*)는 중요도가 높으므로 7~180일 동안 Log를 보관하고, 최대 5GB까지 저장하는 설정 예제.

cleanup_logs "/var/log/ovenmediaengine" "ovenmediaengine.log.*" 180 7 5120

• Event Log (events.log.*)는 상대적으로 중요도가 낮으므로 1~30일 동안 Log를 보관하고, 최대 500MB까지 저장하는 설정 예제.

cleanup_logs "/var/log/ovenmediaengine" "events.log.*" 30 1 500

4

Log Cleanup Script 저장

1. Script를 수정한 뒤 저장하면 변경 사항이 즉시 적용됩니다. 따라서 별도로 Instance 또는 OvenMediaEngine(Service)을 재시작하거나 Crontab을 다시 등록할 필요가 없습니다.