Log Monitor is a functionality delivered in Checkout to help Salesforce administrator troubleshoot issues in the Limio managed package and assist in identifying whether issues are from the managed package or tenant-specific custom code. It is based on Salesforce's Platform Events and overcomes some of the limitations of Salesforce native logging (System.debug).

This article is for Salesforce Administrator with knowledge of Salesforce administration capabilities.

Features of Logging

  • Unified view of logs over transaction boundaries (execution contexts)
  • Auto-detection of code location (classes)
  • Lightning Utility Bar called Log Monitor with filter functionality

Note that Log Monitor only shows logs produced by the current user. It must be activated using user-level custom settings described in Setup below. Log Monitor can be extended easily extendible to report Governor Limit state. Contact support@limio.com if you have any feedback or questions about this feature.


Log Monitor Setup

Activate Log Monitor for a specific user

Follow the following steps to allow Log Monitor to fire log events for a specific user:

  1. Go to Setup.
  2. Type “Custom Setting” in the search bar.
  3. Click on “icConfig” custom setting.
  4. Click on “Manage” button.
  5. If a user already exists and you wish to edit their ability to capture the log events in logMonitor, click on “Edit” button and check “Allow Log events to fire” checkbox.
  6. If no entry exists, Click on “New” button, select “User” in location dropdown and search for the user you want to allow to capture the log events in logMonitor in search bar and check “Allow Log events to fire” checkbox.
  7. Click on “Save” button.

Then, set Custom setting to set the Log Monitor plugin class for a specific user by following the following steps:

  1. Go to Setup.
  2. Type “Custom Setting” in the search bar.
  3. Click on “icConfig” custom setting.
  4. Click on “Manage” button.
  5. If a user already exists and you wish to edit their ability to set the logging framework plugin class, click on “Edit” button and provide “iLoggingInterfaceClass” as value for the “Custom Logging Implementations” column.
  6. If no entry exists, Click on “New” button, select “User” in location dropdown and search for the relevant user.Provide “iLoggingInterfaceClass” as value for the “Custom logging Implementations” column.
  7. Click on “Save” button.

Log Monitor Use

Locate Log Monitor and see generated log events in Salesforce

Log Monitor is made available as a Salesforce Utility Items for the “I42 Console” app. It can also be added to other custom Salesforce applications by going to Salesforce Setup > App Manager > Edit > Utility Items.

In the “I42 Console” app, go to the right side corner of the app which will display the Log Monitor utility.

Click on Log Monitor to see all generated log Events.

Log events have the following attributes and value:

  • Scope: Either date/time stamp of when the event was triggered or the Unique Order Reference number
  • Time: Timestamp of when events have been triggered
  • Level: Indicates the severity, can take the following values: Error, Debug, Info, or Warn
  • Class: Name of Apex class impacted with namespace indicating source of issue
  • Method: Name of Apex method impacted
  • Line number: Specific line of code impacted
  • Message: Detailed message of the log

You can filter log events based on their level, such as Error/Debug/Info/Warn.

Understand where issues are happening

By looking at the namespace of a class attribute, you can identify whether logs are generating from the Limio managed package (name space: i42as) or outside of the managed package, for example customer code.

Clear the logs or stop listen to logs

Clear all the log events from the Log Monitor screen by pressing “Delete” icon on the right corner.

If you no longer want to listen to Log Events, click on the Audio icon on the right corner to mute them. You will not receive log events anymore.