New Release v4.6.12: New 'Log Scenario Rules' CMDT, New 'Logger Admin Dashboard' Plugin

[jongpie]

New 'Log Scenario Rules' CMDT

This PR closes #235 (and further extends the 'scenario' functionality added in #218) - Added new CMDT object LoggerScenarioRule__mdt to provide a way to configure scenario-specific behavior. Each rule controls 2 aspects of a scenario:

1. The user's logging level for a particular scenario - This overrides the logging level configured via LoggerSettings__c.
2. The retention date for a particular scenario - This overrides the retention date configured via LoggerSettings__c.

Example rule

This example rule overrides the user's logging level for the scenario 'some scenario' - after Logger.setScenario(String) is called, the user will (temporarily) have their logging level set to FINE for the remainder of the Apex transaction. It also sets the retention date for the logs to 90 days.

With the above rule configured, this script will save only the second log entry (the one logged after calling Logger.setScenario(String), and the log will have a retention date of "TODAY + 90 days"

Logger.getUserSettings().LoggingLevel__c = LoggingLevel.ERROR.name();
Logger.info('this will not be saved since it does not meet the user logging level of ERROR');
Logger.setScenario('some scenario');
Logger.info('this will be saved since it meets the scenario logging level, and setScenario() has been called');
Logger.saveLog();

New 'Logger Admin Dashboard' Plugin

The previous release, v4.6.11, included a new dynamic dashboard. I did not take into consideration that most orgs have a limit of 10 dynamic dashboards, which has caused upgrade issues for several people . To help with this issue, the dashboard has been removed from the core unlocked package, and is now going to be provided as an optional plugin package - any org that wants to use the dashboard (and has not hit their org limit) can install the dashboard plugin on top of Nebula Logger v4.6.12. Check out the dashboard plugin's README for installation details.

---

This discussion was created from the release New 'Log Scenario Rules' CMDT, New 'Logger Admin Dashboard' Plugin.