# Automatic Log Cleanup OvenMediaEngine Enterprise on AWS **continuously generates** **Log Files** while the service is running. If logs accumulate, Disk usage may increase excessively. To prevent this in advance, OvenMediaEngine Enterprise provides the **Automatic Log Cleanup** feature. ## Default Log Cleanup Policy The default Automatic Log Cleanup policy applied to OvenMediaEngine Enterprise on AWS is as follows: * **Retention (Days):** Logs older than 90 days are automatically deleted. * **Minimum Retention (Days):** Logs from the most recent 1 day are always retained. * **Size Limit (MB):** If the total size exceeds 1GB (1024MB), the oldest files are deleted first to free up space. * **Run Schedule:** Automatic Log Cleanup is enabled by default and runs automatically every day at 03:00 (UTC). This policy applies to the following logs:
Log TypeDirectoryFile PatternDescription
OvenMediaEngine/var/log/ovenmediaengineovenmediaengine.log.*OME Core Engine Log (Rotated)
Web Console/var/log/ovenmediaengine/ovenstudiooven-studio_*.logWeb Console Service Log
OvenMediaEngine Delivery/var/log/ovenmediaengine/ovenmediaengine-deliverydelivery-daemon.log.*Recording Delivery System Log
OvenMediaEngine Monitoring/var/log/ovenmediaengineevents.log.*OME Monitoring Event Log
## Changing the Log Cleanup Policy If you need to adjust the policy (such as retention period or size limit) for your environment, follow the steps below. {% stepper %} {% step %} ### Edit the Log Cleanup Script
1. Connect to your instance via SSH (following the [EC2 connection official guide](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connect.html)), then open the script with the command below: ```bash sudo vi /opt/omee-log-cleanup.sh ``` {% endstep %} {% step %} ### Update the Policy using Variables 2. The variables defined at the top of the script are used as the default values: ```bash # 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 ```
ValueInput RangeDescription
RETENTION_DAYS

0~

  • Default: 90
Sets the maximum retention period (days) for stored logs.
MIN_RETENTION_DAYS

0~

  • Default: 1

Sets the minimum retention period (days) for stored logs.

  • This is a safety guard to prevent files within this period from being deleted, even when the size limit is exceeded.
MAX_TOTAL_SIZE_MB

0~

  • Default: 1024
Sets the maximum allowed storage size (MB) for retained logs.
3. If you modify these variables, the new values will be applied to all `cleanup_logs` entries in the script. ```bash # 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 ``` {% endstep %} {% step %} ### Customize Policy per Log Type (Optional) * If you want different policies for different log files, edit the `cleanup_logs` calls near the bottom of the script. ```bash # 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 ```bash cleanup_logs "" "" retention_days min_retention_days max_total_size_mb ``` #### Example * **Main Log** (`ovenmediaengine.log.*`) is typically more important, so this example keeps logs for 7–180 days and allows up to 5GB of total storage. ```bash cleanup_logs "/var/log/ovenmediaengine" "ovenmediaengine.log.*" 180 7 5120 ``` * **Event Log** (`events.log.*`) is relatively less critical, so this example keeps logs for 1–30 days and allows up to 500MB of total storage. ```bash cleanup_logs "/var/log/ovenmediaengine" "events.log.*" 30 1 500 ``` {% endstep %} {% step %} ### Save the Log Cleanup Script 4. After editing the script, save the file to apply the changes immediately. There is no need to restart the instance, restart OvenMediaEngine (service), or re-register the crontab. {% endstep %} {% endstepper %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://ovenmediaengine-enterprise.gitbook.io/guide/exclusive/aws-marketplace/getting-started-on-aws/automatic-log-cleanup.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.