afawcett / eventlogging Goto Github PK
View Code? Open in Web Editor NEWLogging framework powered by Platform Events
License: BSD 3-Clause "New" or "Revised" License
Logging framework powered by Platform Events
License: BSD 3-Clause "New" or "Revised" License
Please push the cometd static resource
I got the utility bar working once I added a resource with the JS file in the right place.
I had to take two steps to get this running. I'm sure I'm not the only lightning n00b out there.
Great session and we've adopted this pattern in our org
Normally, one wants to Log.emit()
at the end of a transaction. Some transaction boundaries are easy to ascertain (edge points: async, VF controller just before redirect, APEX REST). Other transaction boundaries are impossible to ascertain (the last trigger invocation). Triggers may invoke services or do CRUD that start other triggers that do workflows that do field updates that start new triggers...
Triggers can be edge points - user interaction with the standard UI or direct OOTB REST/SOAP API CRUD.
And, since a trigger may be part of the service started from APEX REST, async, VF controller, ... , simply adding a Log.emit()
within Domain layer trigger handlers will mean the log emitted by some edge points will be partial, flushed by the trigger's Log.emit()
. It gets worse if triggers indirectly start other triggers that have their own Log.emit()
.
One key goal of the log is to enable diagnostics after a transaction has ended but something has gone wrong that is hard to reproduce. This could include the database updated without exception, but updated incorrectly. When this happens from 3rd party systems like middleware doing OOTB REST/SOAP API it is especially useful to have logging.
I've thought about different patterns to address this in imperfect ways such as introducing this:
Log.init(); // intent to emit
Log.push('outer');
Log.message();
Log.init('inner - in a trigger now'); // intent to emit
Log.push('inner')
Log.message('do work in inner');
Log.pop();
Log.emit(); // Log.emit here does not flush because log.init stack is not at top
Log.message('more work in outer');
Log.emit();
but this generates a lot of platform events, especially when triggers call triggers, each with their own Log.emit
. Thus, one has to wade through Platform Event noise when analyzing the persisted logs (however one chooses to persist)
Or, perhaps a variant to this:
Log.init(); // intent to emit
Log.push('outer');
Log.message();
Log.init('inner - in a trigger now'); // intent to emit
Log.push('inner')
Log.message('do work in inner');
Log.pop();
Log.emit(); // Log.emit does nothing if not at top level of log.init stack
Log.message('more work in outer');
Log.emit();
A secondary issue is suppressing logs in use cases where one doesn't care. Examples:
Log.emit()
so, perhaps add an interface in Log:
public interface Emittable {
Boolean isEmittable();
}
and then we have
public class MyEmittable implements Log.Emittable {
public Boolean isEmittable() {
return !UserInfo.getName == 'Data Loader Migration User';
}
}
Log.init(new MyEmittable());
Log.push(..);
Log.message(..);
Log.pop();
Log.emit(); // calls the myEmittable object's method isEmittable() and if false, does not emit a Platform Event nor flush the log
Thoughts as to the correct pattern to apply to the trigger-as-transaction-edge use cases?
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.