axinthefield: Dynamics AX Tracing (Part 1)

[Blog bot]

Источник: http://blogs.msdn.com/b/axinthefield...ng-part-1.aspx
==============

Dynamics AX has a tracing feature that allows you to generate ETW traces of the client and server activity on your system. The information collected in these traces includes a call tree, SQL statements, and durations for all of the different code that executes. This kind of trace data can be extremely useful when troubleshooting performance issues, but there are a few things you need to know in order to be successful in capturing useful trace data and analyzing it. This is the beginning of a series of posts that cover tracing topics. In this post I'll talk about some of the prerequisite settings necessary to implement on your system. In future posts I discuss topics such as tracing best practices, troubleshooting trace collection issues, installing and troubleshooting the Trace Parser tool, and trace analysis basics.

Generally when I'm tracing something in AX, I try to localize all of my activity on a single isolated AOS. To isolate my activity I prevent other users from connecting to the AOS instance and I run the client directly from the AOS server. I've found that this is the most convenient and reliable way to setup tracing. The prerequisite settings for a successful trace are covered below.

Tracing Prerequisites for the AOS Instance

From the Dynamics AX Server Configuration Utility > Tracing tab, set the following options:

• Mark the "RPC round trips to server" checkbox
• Mark the "X++ method calls" checkbox
• Mark the "Function calls" checkbox
• Set the "Number of nested calls" to 99
• Mark the "SQL statements" checkbox
• Mark the "Bind variables" checkbox
• Mark the "Allow client tracing on Application Object Server instance" checkbox

You'll also need to verify that the following AOS registry settings exist and have the recommended values. If something doesn't exist, you will have to create it.

AOS Server Registry Path:

HKLM\SYSTEM\CurrentControlSet\Services\Dynamics Server\5.0\01\

Recommended Values:

Name

Type

Data

tracebuffersize

REG_SZ (String Value)

1024 if server has 2GB RAM or more. 512 if server has less than 2GB RAM.

tracemaxbuffers

REG_SZ (String Value)

60

tracemaxfilesize

REG_SZ (String Value)

Between 1024 (1GB) and 10240 (10GB) depending on space available.

traceminbuffers

REG_SZ (String Value)

60



Tracing Prerequisites for the AX Client

From the Dynamics AX Configuration Utility > Tracing tab, set the following options:

• Mark the "RPC round trips to server" checkbox
• Mark the "X++ method calls" checkbox
• Mark the "Function calls" checkbox
• Set the "Number of nested calls" to 99
• Mark the "SQL statements" checkbox
• Mark the "Bind variables" checkbox

You'll also need to verify that the following AX client registry settings exist and have the recommended values. If something doesn't exist, you will have to create it.

AX Client Registry Path:

HKCU\Software\Microsoft\Dynamics\5.0\Configuration\

Recommended Values:

Name

Type

Data

tracebuffersize

REG_SZ (String Value)

1024 if server has 2GB RAM or more. 512 if server has less than 2GB RAM.

tracemaxbuffers

REG_SZ (String Value)

60

tracemaxfilesize

REG_SZ (String Value)

Between 1024 (1GB) and 10240 (10GB) depending on space available.

traceminbuffers

REG_SZ (String Value)

60



Security Considerations for Tracing:

• The account running the AOS instance must belong to the 'Performance Log Users' local group or the Administrators local group on the AOS if it is running on Windows Server 2003 or Windows Server 2008. The WMI event tracing subsystem requires that tracing be started only from a user belonging to one of these groups.
• The client trace is initiated by the currently logged on user, so verify that user has access to the log path defined in the client configuration utility.
• The server trace is initiated by the account running the AOS instance, so verify that user has access to the log path defined in the server configuration utility.

Источник: http://blogs.msdn.com/b/axinthefield...ng-part-1.aspx