Inside Activate
Logging
Logging Configuration
4 min
logging for activate is controlled via an xml configuration stored in the //resources/configuration/loggingconfiguration parameter this configuration defines how log files are created, sized, and retained across the platform this configuration is available from version 8 3 8 example configuration \<configuration memorise="false"> \<files> \<file name="activate azure log" maxsizebytes="1024" keeplast="10" filename="activate azure log" /> \<file name="activate orchestrator log" maxsizebytes="1024" keeplast="5" filename="activate orchestrator log" /> \<file name="activate scheduler log" maxsizebytes="1024" keeplast="0" filename="activate scheduler log" /> \</files> \</configuration> configuration behaviour memorise controls whether the logging configuration is cached in memory true (default) configuration is cached changes require a service restart to take effect false disables caching, allowing configuration changes to be picked up dynamically (useful for debugging or tuning) this setting itself is cached, so switching between true and false still requires a restart files / file entries each \<file> element defines configuration for a specific log file if a log file is not explicitly defined, default behaviour applies maxsizebytes falls back to the value defined in the provisioningfilewriter keeplast defaults to 0 (no historical files retained) maxsizebytes specifies the maximum size of the log file before rotation occurs overrides the value provided in the provisioningfilewriter constructor if present if not specified, the constructor value is used keeplast defines how many historical log files to retain 0 means no history is kept (files are overwritten) provisioningfilewriter interaction if no maxsizebytes is defined in the logging configuration, the value provided when the log writer is instantiated will apply using (provisioningfilewriter log = new provisioningfilewriter("activate mylog log", 512)) in this example, the log file will use a maximum size of 512 bytes unless overridden by the xml configuration usage notes reducing keeplast will immediately remove any existing log files beyond the new limit back up logs if retention is required use memorise="false" only during troubleshooting or configuration changes for normal operation, caching should remain enabled to avoid unnecessary overhead