Antoine_Sauteron_1266

[TUTORIAL] 3 ways to activate traces on server processes

Discussion created by Antoine_Sauteron_1266 on Jan 13, 2017
Latest reply on Jul 26, 2018 by Antoine_Sauteron
Traces are a more detailed version of logs. They can be used to perform a more in depth investigation of technical issues.

Server traces are stored in the location defined in this section of ucsrv.ini :
[TRACE]
file=..\temp\$$srv_trc_*_##.txt

Disclaimer : activating traces may cause latency and produce huge size files. For these reasons it should only be done for a short time and upon request of Automic's support.

In this post we're going to see how to activate traces on the Automation Engine server from the GUI, with a script or by editing the server's ini file.

1. From the GUI

A/ Up to version 11.2 : with the User Interface

 This can be done from the System Overview > Automation Engine.
Right-click on any WP from the list and select 'Properties'.

y4j6h6be7wpf.png

Turn on traces : fill in the cells in the left with the desired values.
yc0rsfkd935r.png

Turn off traces : Set the values back to '0' in the cells.

B/ In AWI (v12 only)

Go to the "Administration" panel > Automation Engine Management > Processes & usage then right-click on a server process and choose "Trace Options".

4q8c4x9jwxfr.png

Turning traces on / off can be done by adjusting values in the drop-down boxes.
74yn5tdj68ob.png


2. With a script


The script function SET_UC_SETTING can be coupled with GET_UC_SYSTEM_NAME() for that purpose.

A/ Turning on traces
!Set a DB=4 trace on the WPs
!Get System Name
:SET &TRC# = GET_UC_SYSTEM_NAME()
!Turn on tracing for WPs
:SET_UC_SETTING SET_TRACE, &TRC#, "0400000000000000"


B/ Turning off traces : apply the same principle to set values back to 0.

:SET &TRC# = GET_UC_SYSTEM_NAME()
!Turn on tracing for WPs
:SET_UC_SETTING SET_TRACE, &TRC#, "0000000000000000"

3. From ucsrv.ini


Manually edit ucsrv.ini and set values in the [TRACE] section

tcp/ip=
database=
trc03=
srcall=
memio=
jcl=
memsv=
snmp=
zuxml=
cache=
trc11=
ucds=
xscript=
uc4global=
trc15=
trc16=
Please make sure to not forget de-activating them afterwards! This option is not really recommended as it is taken into account every time the server is started.

Going further


Here are a few ready-to-use scripts developed by Automic staff members

Trace scheduler : https://automic.force.com/support/apex/CommunityArticleDetail?id=ka4b00000004MP5
Rolling traces :
https://automic.force.com/support/apex/CommunityArticleDetail?id=ka4b00000004MCp

Outcomes