Trace

Traces messages into the tracing facilites so they can be display by the running runtime either in console, or debug output or whatever the runtime is configured to do.

It will track from where the trace call was made and the message will be logged with the category, type and text provided.

All tracers will be sent to the {@code trace.log} file in the logs directory of the runtime as well.

If the {@code abort} attribute is set to true, the current request will be aborted after the trace call.

Tracers will only be displayed if the runtime is in debug mode. . However, all traces will be logged regardless of the debug mode flag.

The {@code extraInfo} attribute is optional and can be any simple or complex object. We will convert it to string for logging using the {@code toString()} method on the object. You can also use the alias of {@code var} for this attribute as well.

Method Signature

Trace(text=[string], category=[String], type=[string], extrainfo=[any], abort=[boolean])

Arguments

Argument	Type	Required	Description	Default
text	string	true	The text of the trace message. Required.
category	String	false	The category of the trace message. Default is an empty string.
type	string	false	The type of the trace message. Default is "Information".	Information
extrainfo	any	false	Any extra information to be logged with the trace message. This can be simple or a complex object. We will convert it to string for logging.
abort	boolean	false	If true, the current request will be aborted after the trace call. Default is false.	false

Examples

Related

• ApplicationRestart

• ApplicationStartTime

• ApplicationStop

• BoxAnnounce

• BoxAnnounceAsync

• BoxRegisterInterceptor

• BoxRegisterRequestInterceptor

• CallStackGet

• CreateGUID

• CreateObject

• CreateUUID

• DE

• DebugBoxContexts

• Dump

• Duplicate

• echo

• EncodeForHTML

• GetApplicationMetadata

• GetBaseTagData

• GetBaseTagList

• GetBaseTemplatePath

• GetBoxContext

• GetBoxRuntime

• GetBoxVersionInfo

• GetClassMetadata

• GetComponentList

• GetContextRoot

• GetCurrentTemplatePath

• GetFileFromPath

• GetFunctionCalledName

• GetFunctionList

• GetModuleInfo

• GetModuleList

• GetRequestClassLoader

• GetSystemSetting

• GetTempDirectory

• GetTickCount

• htmlEditFormat

• IIF

• Invoke

• IsInstanceOf

• JavaCast

• ObjectDeserialize

• ObjectSerialize

• PagePoolClear

• Print

• Println

• RunThreadInContext

• SessionInvalidate

• SessionRotate

• SessionStartTime

• Sleep

• SystemCacheClear

• SystemExecute

• SystemOutput

• Throw

• URLDecode

• URLEncodedFormat

• writeDump

• WriteLog

• WriteOutput