Okta Access Gateway Error "Preparing Today's log failed cause by Log file size in worker node(s) too large"
May 14, 2026
Access Gateway
Okta Classic Engine
Okta Identity Engine
Overview
When trying to download today's log from the Okta Access Gateway (OAG) Admin UI console, the following error occurs:
Preparing Today's log failed
Log file size in worker node(s) too large, failed to download logs from worker(s)
Add a log forwarder or select a different date.
Applies To
- Okta Access Gateway (OAG)
- Okta Classic Engine
- Okta Identity Engine (OIE)
Cause
By default, the Okta Access Gateway (OAG) appliance restricts the download log file size to 2GB. The setting is defined in
/opt/oag/bin/logPrepareConfig.sh on each node.The mentioned error can happen in two cases:
- The generated log archive on the worker node exceeds 2GB.
- The combined log archive (admin + all workers) on the admin node exceeded 2GB.
The archive for a specific date on an appliance will contain all logs from every directory under
/opt/oag/logs/. A rough estimation can be done by checking the directory size using : du -sh /opt/oag/logs/*
NOTE:
- It is recommended to use log forwarders and keep minimal logging on the cluster. For more information, refer to Manage log verbosity.
- The workaround mentioned below should only be used as a temporary solution, and the changes must be reverted once the log download is successful.
Solution
- Log in to the appliance shell.
- Open the config file in an editor:
sudo vi /opt/oag/bin/logPrepareConfig.sh - Increase the value of
MAX_ALLOWED_LOG_SIZEbased on the estimation. - Run the steps above on all the remaining nodes in the cluster.
- Re-execute the log download from the Admin UI.
- Revert the changes on all the nodes once the download is completed.
- Check and update log verbosity to avoid excessive logging if needed.
