ThingWorx Model Definition and Composer > System > Subsystems > Audit Subsystem > Configuration of Audit Subsystem
Configuration of Audit Subsystem
Once it is enabled, you can review, and if necessary, change the values of the operating parameters for the Audit Subsystem from ThingWorx Composer:
1. Assuming that you have navigated to the AuditSubsystem pages, click the Configuration tab.
The Configuration page for the AuditSubsystem in the next-generation versions of ThingWorx Composer follows:
Figure 1. AuditSubsystem Configuration in Next Generation Composer
2. Review the default settings, and if necessary, change them, using the information in the table below for guidance.
3. Click the Save button.
4. If you have not previously started the subsystem, click the Start button to start the subsystem. If you have previously started the subsystem, click the Restart button to stop and start the subsystem with your configuration changes.
Configuration Parameters for the Audit Subsystem
Default Value
Valid Values
Audit Persistence Provider
The persistence provider (PP) used to write the audit data. By default, this setting is the database instance for ThingWorx. Note that for the Audit Subsystem to work properly, the ThingWorx persistence provider must be a PostgreSQL database.
If your ThingWorx persistence provider is not a PostgreSQL database or if it is PostgreSQL and you expect a very high volume of audit messages, create a new PostgreSQL database instance for use by the Audit Subsystem. Then specify the new PostgreSQL database as the persistence provider for the Audit Subsystem.
If you are using your ThingWorx persistence provider (PostgreSQL) and then switch to a separate PostgreSQL one for the Audit Subsystem, you should do an export-import of the audit data to the newly selected persistence provider. If you do not do the export-import, the history from the initial persistence provider is not included in the new one. Instead, the writes start at the time of the switch.
If you create a separate PostgreSQL database instance (persistence provider) for the Audit Subsystem, use the name of that persistence provider for this setting.
Archive Audit Chunk Size
The number of rows that will be archived before a new chunk file is created
Over time, you may want to adjust the size, depending on volume, size of audit messages, and performance of the archive process.
This setting can be any value greater than or equal to 10000 rows.
Maximum entries for online data (maxEntriesOnlineAuditData)
The maximum number of rows that an audit table can hold.
The default value is 500000 rows.
Positive numbers (integers) only. A negative value is not allowed.
Highest value that can be set for maxItems parameter for the QueryAudit History service
The maximum number of rows that can be set for the maxItems parameter of a query.
This value must be greater than or equal to 500 (INTEGER).
Number of days of online audit data to maintain.
The number of days to keep audit messages online. This value is used by the archive operation of the subsystem to determine which messages should be moved to the offline repository of the Audit Subsystem. Data that is older than this number of days will be removed from online storage after being copied to offline storage.
The default value is 60 days.
INTEGER values only
To view the subsystem values while it is running, go to Monitoring > Subsystems.