en-USnl-NL
You are here:   JumpStart DNN > WorkFlow > The TraceLog
  |  Inloggen
The tracelog is a textfile stored in the portal's filesystem.

When tracking and tracing your module, you can delete the tracelog at any time while working on your module.

The log will be rebuild instantly when the codeexecution reaches a following tracelog snippet.

This enables the developer and the tester to pinpoint the section of interest by deleting the logfile prior to executing the function in development or test.

Only that part will be logged, and examination is made much more friendy and effective.



This is a part of the tracelog.

You will recognize the PayPal Express Checkout routine.



=========================================================================================================================

Log#: 15 Append: 6/20/2011 2:41:23 PM; Module: VDW_JS_03_JSMyJumpStart_Edit; Item: Event Handlers: btnPayPal_Click; ConfirmPayment ## 13_Edit; Detail: ret: True; Session(PP_pStresponsenvp) = pStresponsenvp: TOKEN=EC%2d74L15604BL0972402&TIMESTAMP=2011%2d06%2d20T12%3a41%3a26Z&CORRELATIONID=7014e6105924d&ACK=Success&VERSION=54&BUILD=1882144&EMAIL=joost_1305624677_per%40visualdata%2enl&PAYERID=P8BT9SUM7ZZ9W&PAYERSTATUS=verified&FIRSTNAME=Test&LASTNAME=User&COUNTRYCODE=NL&SHIPTONAME=Test%20User&SHIPTOSTREET=25513540%20River%20N343%20W&SHIPTOCITY=Den%20Haag&SHIPTOSTATE=2585&SHIPTOZIP=GJ&SHIPTOCOUNTRYCODE=NL&SHIPTOCOUNTRYNAME=Netherlands&ADDRESSSTATUS=Unconfirmed&CURRENCYCODE=USD&AMT=14%2e28&SHIPPINGAMT=0%2e00&HANDLINGAMT=0%2e00&TAXAMT=0%2e00&INSURANCEAMT=0%2e00&SHIPDISCAMT=0%2e00; Result: Token: EC-74L15604BL0972402; retMsg: EC-74L15604BL0972402

Log#: 17 Append: 6/20/2011 2:41:26 PM; Module: VDW_JS_03_JSMyJumpStart_Edit; Item: Event Handlers: btnPayPal_Click; ConfirmPayment ## 14_Edit; Detail: ret: True; Session(PP_pStresponsenvp) = pStresponsenvp: TOKEN=EC%2d74L15604BL0972402&TIMESTAMP=2011%2d06%2d20T12%3a41%3a29Z&CORRELATIONID=257340678d9f9&ACK=Success&VERSION=54&BUILD=1882144&TRANSACTIONID=4SP095454A951334L&TRANSACTIONTYPE=expresscheckout&PAYMENTTYPE=instant&ORDERTIME=2011%2d06%2d20T12%3a41%3a28Z&AMT=14%2e28&FEEAMT=0%2e79&TAXAMT=0%2e00&CURRENCYCODE=USD&PAYMENTSTATUS=Completed&PENDINGREASON=None&REASONCODE=None; Result: retMsg: EC-74L15604BL0972402

Log#: 18 Append: 6/20/2011 2:41:26 PM; Module: VDW_JS_03_JSMyJumpStart_Edit; Item: Event Handlers: btnPayPal_Click; ShortcutExpressCheckout ## 15_Edit; Detail: PayPal CheckOut Success!; Set PPFDT fields to number of licencedays; Result: GO!

Log#: 19 Append: 6/20/2011 2:41:26 PM; Module: VDW_JS_03_JSMyJumpStart_Edit; Item: Event Handlers: btnPayPal_Click; CheckOut UserID: 1_Edit; Detail: PayPal Express CheckOut: ; Result: GetRecord --==>>

Log#: 20 Append: 6/20/2011 2:41:26 PM; Module: VDW_JS_03_JSMyJumpStart_Edit; Item: Event Handlers: GetRecord# 1_Edit; Detail: ; Result: START

Log#: 21 Append: 6/20/2011 2:41:26 PM; Module: VDW_JS_03_JSMyJumpStart_Edit; Item: Event Handlers: GetRecord#; If Not Common.Utilities.Null.IsNull(JSMyJumpStart0_ID): False_Edit; Detail: Get record## 1; Result: START EXISTING RECORD

Log#: 22 Append: 6/20/2011 2:41:26 PM; Module: VDW_JS_03_JSMyJumpStart_Edit; Item: Event Handlers: GetRecord#; objVDW_JS_03_JSMyJumpStartController As New_Edit; Detail: Instantiate new controller; Result: GoTo objVDW_JS_03_JSMyJumpStartInfo -->

Log#: 23 Append: 6/20/2011 2:41:26 PM; Module: VDW_JS_03_JSMyJumpStart_Edit; Item: Event Handlers: GetRecord#; objVDW_JS_03_JSMyJumpStartInfo_Edit; Detail: VDW_GetOne 1; Result: Check objVDW_JS_03_JSMyJumpStartInfo -->

Log#: 24 Append: 6/20/2011 2:41:26 PM; Module: VDW_JS_03_JSMyJumpStart_Edit; Item: Event Handlers: GetRecord# 1_Edit; Detail: ; Result: END

Log#: 25 Append: 6/20/2011 2:41:26 PM; Module: VDW_JS_03_JSMyJumpStart_Edit; Item: Event Handlers: btnPayPal_Click; CheckOut UserID: 1_Edit; Detail: PayPal Express CheckOut: ; Result: Update Record## 1

Log#: 26 Append: 6/20/2011 2:41:26 PM; Module: VDW_JS_03_JSMyJumpStart_Edit; Item: Button Handlers: btnUpdate_Click; Select VDW_JS_03_JSMyJumpStart_Edit; Detail: Session(CCNT_DDLJSLicences) = 1; Result: Session(OFF_DDLJSLicences) = 8

Log#: 27 Append: 6/20/2011 2:41:26 PM; Module: VDW_JS_03_JSMyJumpStart_Edit; Item: Event Handlers: btnPayPal_Click; ConfirmPayment ## 19_Edit; Detail: Insert new record with expirationdate on: 06/21/2011; Result: New licence for 1 days

Log#: 28 Append: 6/20/2011 2:41:26 PM; Module: VDW_JS_03_JSMyJumpStart_Edit; Item: Event Handlers: btnPayPal_Click; Update licencerecord_Edit; Detail: Licence record##: ; Result: Update record; simulate btnUpdate_Click

=========================================================================================================================



This is the code that recorded log#: 17 (in BOLD)



'================  Start TraceLog  ================

strItem = "Event Handlers: btnPayPal_Click; ConfirmPayment ## 14"

strDetail = "ret: " & ret.ToString & "; Session(PP_pStresponsenvp) = " & Session("PP_pStresponsenvp")

strResult = "retMsg: " & retMsg

TraceLog(strModule, strItem, strDetail, strResult)

'=================  End TraceLog  =================



All of your JumpStart code is littered with these TraceLog snippets.





The tracelog will record every event on wich it is placed on in the code.

You can switch the logging on or off in the Settings module.



Typically there are fourscenario's that you will follow in regard to the tracelog.



# 1: Development:

Check your tracelog when developing your modules. Does the expected result show up in the tracelog?



# 2: Testing:

In fact the same as Development, only here the tracelog is used by the tester.



# 3: Debugging:

Check the log for malfunctions in the programflow. Can I pinpoint the error in my code by checking the tracelog?



# 4: Problem solving:

Check the log for problems when users report a flaw in their work. Who did what, where and in what sequence? Are the granted rights a problem?



Cross reference between the tracelog and your code.

The tracelog snippets in your code contains unique strings. These strings will showup in the tracelog.

To make the search easy you just have to select a phrase in the tracelog line and perform a search in your code on that phrase.

Or the other way round, for that matter.... Select the phrase in the codeand search in the tracelog....



Using the tracelog in a sensible way.

By nature, the tracelog can and will grow in an alarming rate when left unattended.

Very large tracelogfiles can slow down your DNN performance dramatically, or even stall the entire portal!

Be sure to switch off the tracelog, especially in production environments.

By switching off the log, it will be destroyed, thus preventing the filesystem to grow unnessesary.



Where to find the TraceLog.txt files?

The tracelog files are stored in the portal's filesystem, in the "Portals" subdirectory.

Every JumpStart module will, once installed and running, create two module directories in the (child)portal's "Portal" directory.

The TraceLog.txt wil be placed in the directory called "..\.\Portals\0\VDW_JS_03_JSMyJumpStart\".