Code Part section


[code_part]

Process Code Part Section

......

Process Code Part Section

[end_code_part]

OR:

[code_part_is_missing]

Settings for code recording are done in the AppSight Code Console.

Process Code Part Section

[process name_of_process]

  • Process Settings Section
  • Platforms Section
  • Code Alerts Section
  • "Trace Points displayed in AppSight System" section

If the RPR has a system recording section, the Process Settings Section will be written in that section and will not appear in the code recording section.

The "Trace Points Displayed in AppSight System" section is optional.

Platforms Section

[Native_platform_part]

Platform section

[end_of_Native_platform_part]

[.Net_platform_part]

Platform section

[end_of_.Net_platform_part]

Some of the platform sections may be missing.

Module section

...

Module section

Module Section

[module <short name of .exe or .dll>]

[pdb_name <full path to pdb file>]

[full_path <full path to module>]

File Section

...

File Section

Exclude Autotuning Section

OR:

[module <name of .dll>]

Exported Functions Section

File Section

[file <full path to file>]

Functions Section

Trace Lines Section

The Trace Line Section is optional.

Functions Section

functions = all

OR

functions = none

OR

functions = <function_name>, ... <function_name>

OR

functions = ~<function_name>, ... ~<function_name>

"All" means that all of the functions from this file are traced (even if functions were added to this file when the application is rebuilt).

"None" means that no functions are traced.

List of <function names> is the list of functions to be recorded. The function names in this list are the decorated names.

A list of function names with "~" means that all functions of this file are recorded, except for the listed functions.

Trace Lines Section

Trace Line Description

...

Trace Line Description

Trace Line Description

[]

line = <value>

trace_local_variables = <name of variable>, ... <name of variable>

trace_global_variables = <name of variable>, ... <name of variable>

"Trace_local_variables" and "trace_global_variables" are optional. No variables are traced by default.

Exported Functions Section

no_pdb_functions = all

OR

no_pdb_functions = none

OR

no_pdb_functions = <function_name>, ..., <function_name>

OR

no_pdb_functions =<function_name>, ..., ~<function_name>

"All" means that all functions from this file are traced

"None" means that no functions are traced

List of <function names> is the list of functions to be recorded. The function names in this list are the decorated names.

A list of function names with "" means that all functions of this file are recorded, except for the listed functions.

Code Alerts Section

no_alerts

OR

alerts

Code Alert Description

....

Code Alert Description

end_alerts

Code Alert Description

alert = "on_function_enter"/"on_function_exit"/"on_function_exit_due_on_exception"/

"on_timer"/"on_exception"/"on_crash"/'on_reach_line"

conditions, that depend on type alert

action = "stack_dump"/ "send_alert"/"send_mail"/"run_application"/"net_send"/

"create_new_session"/"set_rpr"/"stop_trace"/"resume_trace"/"dump_log"/"add_comment"/

"call_function"

...

additional info for action

In the following example, an alert is created when entering the function "OnDestroy", of module "fire.exe", with action "add_comment" and using comment "some comment":

alert = "on_function_enter"

platform = "Native"

module = "fire.exe"

function = "?OnDestroy (CFireDlg)@IAEXXZ"

action = "add_comment"

comment = "some comment"

Tracepoints Displayed in AppSight System Section

show_in_appsight_system = <function_name>, ... <function_name>

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AppSight for Windows and .NET 7.8