Rotate and Purge Logs

You can set log parameters in the API Console to manage the thresholds and rotation behavior.

This task shows you how to:

See Also
Where Are the Process Logs?
Change Log Location

Set Log Rotation and Purge

  1. In the API Console, select Manage.
  2. Set the log rotation and purge parameters:
    1. Select MAMI master.
    2. Under Configuration, select the setLoggingConfig method.
    3. Edit the parameters:

    logRotationMaxSizeKB

    Rotate log files when bigger than the specified number of kilobytes.

    logPurgeMaxSizeKB

    Purge log files when their total size is above the specified number.

    logExpirationDays

    Purge log files when older than the specified number of days.

    logRotationCronExpression

    Trigger log rotation with a custom cron expression.

  3. Click Save.
  4. Click Apply to apply the parameters.

Set Log Rotation Per Host

Context: The logs are rotated by default every 24 hours using a cron expression. You can specify rotate the process log files manually using the RotateLog method at a different frequency.

  1. In the API Console, click Manage.
  2. Set the log rotation and purge parameters:
    1. Select MAMI master.
    2. Under Operation, select the rotateLog method and edit it.
    3. Click Send.

    The log files are archived. See the use cases below.

    By default, the rotateLog message is the following.

    <RotateLog xmlns="exa:com.exalead.mercury.mami.master.v10" host="$HOST_NAME" install="$INSTALL_NAME"
            process="$PROCESS_NAME"/>

Use Cases

  1. Use case 1 - To rotate all log files, edit the RotateLog as follows. 
    <RotateLog xmlns="exa:com.exalead.mercury.mami.master.v10" host="$HOST_NAME" install="$INSTALL_NAME"
              process="$PROCESS_NAME"/>
  2. Use case 2 - To rotate the log files for the localhost, edit the RotateLog as follows. 
    <RotateLog xmlns="exa:com.exalead.mercury.mami.master.v10" install="cvdefault" host="localhost"/>
  3. Use case 3 - To rotate the log files for the process master, edit the RotateLog as follows. 
    <RotateLog xmlns="exa:com.exalead.mercury.mami.master.v10" install="cvdefault" host="localhost"
              process="master"/>