Apama 10.15.0 | Deploying and Managing Apama Applications | Correlator Utilities Reference | Replaying an input log to diagnose problems | Rotating an input log file
 
Rotating an input log file
While the input log can get rather large, most file systems can handle large input logs with no special action on your part. However, you might encounter one of the following situations:
*You want to archive your input logs.
*Your operating system enforces a limit on file size.
*The input log has become too large.
In these situations, you can rotate the input log. Rotating the input log means that the correlator closes the current input log and starts sending messages to a new input log.
You should rotate the input log only when you have a specific need to do so. You do not want to have thousands of input logs in a directory since file systems do not handle this efficiently.
If you plan to rotate input logs, specify the ${ID} tag when you specify the --inputLog option when you start the correlator. For examples, see Examples for specifying log filenames.
To rotate the input log, invoke the engine_management tool and specify the --rotateLogs option. The name of the new input log is the same as the name of the closed input log except that the correlator increments the ID portion of the input log filename by 1. See Rotating all correlator log files.