Difference between revisions of "WCmore's LogAndTrace"

Revision as of 03:26, 8 March 2020

Introduction to Logs

When we need to troubleshoot a piston's logic, it often helps to see what is happening "behind-the-scenes"... Usually the first step is to turn the Logging Level to "Full" for that piston. (each piston's logs are independent of each other) You will find this option at the bottom of each piston.

Once Logging Level is set to Full, then all activity in that piston will be recorded down below that piston. (most recent events at the top) Once the Log runs out of room, the old data is automatically deleted off the bottom, to make room for the new data at the top. (the smaller the piston, the more available room for the log)

Introduction to Trace

If the problem is simple, changing the Log level may be enough, but with a complex piston or log, I will rarely even look at a log unless "Trace" is also turned on. This button can be found on every piston's main page. (not while editing)

Pro Tip

Sometimes on a new piston, you will not see the "Trace" button:

In those cases, press "Test" first, and then you will be able to turn on "Trace".

Summary

Once "Trace" is turned on, you will notice extra numbers in your green snapshot that aligns with the Condition #'s in your log. (As seen in this sample piston)

This makes is easy to follow along, line by line, and see right away what line of code caused an error.

Personal Thoughts

Sometimes, the log can get crazy long. It is MUCH easier to troubleshoot when only the relevant log is posted to the forums.

What I always recommend is:

• Turn on Trace
• Set Logging Level to Full
• Clear Log (Crucial Step!)
• Test piston using the trigger
• Wait until the piston completes all of it's tasks
• Copy the log & paste into your thread
• Post a fresh green snapshot

What this does is give the experts all the information, without a bunch of clutter to wade through.

Side Notes

• Do not ever Edit a piston, and then post a log. We need to see the piston in the same state as when the log was written.
• On that note, if you edit a piston, you may as well Clear your logs. (or at the very least, do not share them online, since they no longer apply)
• Once a piston has been rock solid reliable for awhile, I often reduce Logging level to Minimum or None

.