The FileAuditDestination is a simple file-based provider that logs the audit records to a file which is rolled over upon reaching a specified size.
This provider can safely share access to a file between multiple instances as long as they are all in the same VM. To integrate with a customer's existing audit infrastructure, a custom audit destination provider can be developed and deployed. See com.sybase.security.core.FileAuditDestination in Developer Guide: SAP Mobile Server Runtime.
| Configuration Option | Description |
|---|---|
| auditFile | The absolute path of the file to write the audit records. |
| encoding | The character encoding used when writing the audit data (default=UTF-8). |
| logSize | This option may be supplied to specify the maximum audit log file size before a rollover occurs. |
| compressionThreshold | This option may be supplied to specify the number of uncompressed audit log rollover files that are created, before compression is used to archive the audit data. |
| deleteThreshold | This option may be supplied to specify the number of audit log files that will be preserved. This value includes the main audit log, so a value of "3" allows an audit.log, audit.log.0 and audit.log.1 before deleting old logs. |
| errorThreshold | This option may be supplied to specify the maximum number of audit log files that are allowed. When this threshold is reached, an error occurs and all auditing fails. For example, with this value set to "3", audit.log, audit.log.0 and audit.log.1 will be created according to the maximum log size value. If another audit log rollover is triggered, then all audit operations will fail until one of the rollover files is removed. This value is mutually exclusive with the deletion threshold, and the smallest value of the two takes effect. |