(9.0+) Configuration Management API logging

Configuration Management API generates the following log files:

debug
error
CM Audit

Configuration Management's site.config is used to configure the following:

For debug and error logs:

Where the active files are located
What log level to write logs
Name of the active log file and folder
Size of the active log file
Number of active log files to keep in the directory

For the CM Audit log:

Where the active files are located

Configuration Management's site.config File Location

This can be located on each server in the registry

HKEY_LOCAL_MACHINE\SOFTWARE\Virtual Hold
- InstallationLocation

The folder InstallationLocation is appended with \ConfigurationManagement

example = C:\Program Files (x86)\Virtual Hold Technology\ConfigurationManagement

Important

When troubleshooting an issue, be sure to set the log level to the appropriate level to capture all the necessary information.

Debug logs

Here you will see the creation and activation of change groups through the Configuration Management UI. You will also see any errors in performing these actions.

Configuration Management API site.config Logging Settings

{lager, [{handlers,

{lager_file_backend, [{file,"C:/Program Files (x86)/Virtual Hold Technology/VHLogs/Logs/ConfigurationManagement/debug.log"},

{level,debug} | {size,10485760} | {date,"$D0"} | {count,5}]},


Description	Setting	Values	Default
File path where active logs should be written	file	*Any valid directory path	N/A
Log level to write active logs	level	**See table	N/A
Size of the active Log	size	Number in bytes	10 MB
Name of the active log folder	file	Text	N/A
Name of active log file	file	Text	N/A
How many active files to keep in the active directory	count	***Number	5
When to start a new active log file	date	****See lager docs	Everyday at Midnight -or- File size exceeded. Which ever occurs first

*Should always be the root for ALL log files.

**Debug level is the highest log level. It should not be set lower than this. Refer to lager documentation on other valid options. https://github.com/basho/lager


Log level	Included in logs
emergency
alert
critical
error
warning
notice
info
debug	Default. Should not be set lower than this

***Will only allow 5 files in the active directory at a time. Will delete files if Archive service has not archived the file.

****Set to always start a new log file at midnight regardless of size. Different options are available. Refer to lager documentation on other valid options. https://github.com/basho/lager

Error logs

Here you will see error level messaging relating to the activation and creation of change groups.

Configuration Management site.config Logging Settings

{lager,{lager_file_backend, [{file,"C:/Program Files (x86)/Virtual Hold Technology/VHLogs/Logs/ConfigurationManagementI/error.log

{level,info} | {size,10485760} | {date,"$D0"} | {count,5}]},


Description	Setting	Values	Default
File path where active logs should be written	file	*Any valid directory path	N/A
Log level to write active logs	level	**See table	N/A
Size of the active Log	size	Number in bytes	10 MB
Name of the active log folder	file	Text	N/A
Name of active log file	file	Text	N/A
How many active files to keep in the active directory	count	***Number	5
When to start a new active log file	date	****See lager docs	Everyday at Midnight -or- File size exceeded. Which ever occurs first

*Should always be the root for ALL log files.

**Error level is the lowest level Configuration Management API should log. It should not be set lower than this. Refer to lager documentation on other valid options. https://github.com/basho/lager


Log level	Included in logs
emergency
alert
critical
error	Default. Should not be set lower than this
warning
notice
info
debug

***Will only allow 5 files in the active directory at a time. Will delete files if Archive service has not archived the file.

****Set to always start a new log file at midnight regardless of size. Different options are available. Refer to lager documentation on other valid options. https://github.com/basho/lager

CM audit logs

Here you will see a summary of the changes submitted during the activation of a change group, the date and time of the activation, and which user performed this action.

Configuration Management site.config Logging Settings

{web,[ {audit_log_folder,"C:\\Program Files (x86)\\Virtual Hold Technology\\VHLogs\\CMAudit"}


Description	Setting	Values	Default
File path where active logs should be written	audit_log_folder	*Any valid directory path	N/A
Log level to write active logs	N/A
Size of the active Log	size	Number in bytes	10 MB
Name of the active log folder	N/A
Name of active log file	N/A
How many active files to keep in the active directory	N/A
When to start a new active log file	N/A

*Should always be the root for ALL log files.