Report to SightLane (Collections)

If you've read the Flow Audit Overview article, you know that creating visibility in your Salesforce Flows is as easy as drag-and-drop. In this article, we will dive deeper into one of the five SightLane Flow components: "Report an Event to SightLane."

Create an Event Log Collection Variable

As in all Flows, we begin by creating an Event log collection variable (unless you are using Text Templates)

Once this variable is created, we can add to the Event logs at any time, via standard Flow Assignment elements or other SightLane Flow components (for example, the "Log Record Data" component).  

Using the Report an Event to SightLane Component

As mentioned in the Flow Audit Overview article, the "Report an Event to SightLane" component is responsible for documenting the details (logs) from a single execution of a Flow.  It is the component used to save all audit/log data to the SightLane platform.  To use this component, drag an Action component onto the screen and select the "Report Event Failure to SightLane" action. Then, set a few attributes.

The Report an Event to SightLane component holds eight attributes that control how the monitor is created and what content is saved.

SightLane Monitor Name - This is how you will name the monitor under which this Event will be saved.  It is possible to save documentation from multiple Flows under the same Monitor.  A common practice is to name the monitor after the Flow for which it creates visibility.

Event Id - Gives the event a specific and (potentially) unique id.  In this way, we can separate individual executions of the event.  A common practice is to use the Flow's Interview Guid as the unique identifier, but if you have a more meaningful way to populate the id, go for it!  If an Event Id is not specified, SightLane will generate a unique Id for you.  In other words, this is optional.

Needs Review - Is a True/False property that lets SightLane know that while the Flow we are monitoring did not "Fail", it may have behaved unexpectedly or produced data that we did not intend.  Worse than a Flow that fails is one that completed but mis-behaved during its execution!

Primary Record Id - Allows monitors to "associate" an Event with a particular data record.  If there is an issue during an Opportunity update, it sure would be nice to know which one!  In addition, this will enable seamless navigation between the Event log and the affected record, making research and review much faster.

SightLane Log - When using Text Templates, add your TextTemplate variable to represent all log data captured during this flow.

SightLane Log Delimiter - When using Text Templates, this represents the character(s) used to separate lines within your Text Template content.  Each line will be logged as a separate line in your SightLane Event.

SightLane Logs - When using a Text Collection, this represents all the logging content produced and captured during the Flow.  Add your Log Collection Variable as the value. 

Hint:  If your Log Collection Variable is not showing up, you may have forgotten to check the "Allow Multiple Values" checkbox when defining your logging collection variable.

Summary Message - This is a short description of the Event's outcome, such as "The event encountered a Divide by Zero error" or "A new Opportunity was successfully created."  The choices are up to you.  This value will appear in notification emails and can be a great early indicator to Admins and developers of the current situation.