Skip to Content

The Single Transaction Analysis was extended recently and has some great new features. This blog shows you what you can expect from the latest patch. An overview of the new features is presented in this blog.

Before you start:

ST12 is delivered as a part of the Service tools for Applications (ST-A/PI). SAP note 69455 describes how to get the latest version of the ST-A/PI. Watch out for the support package for the 01N_* version which is RTC (released to customer) since 21st of November.

Please note that the ST12 transaction is not officially documented / supported and only available in English language. Although it is mainly intended for use by SAP or certified Service consultants during SAP Service Sessions, you can use it for your own performance analysis. A brief description of ST12 is given in SAP note 755977 (ST12 “ABAP Trace for SAP EarlyWatch/GoingLive”). A few blogs on ST12 can be found in the ST12 WIKI in SDN:

 http://wiki.sdn.sap.com/wiki/display/ABAP/Single+Transaction+Analysis

New Features:

Let’s have a look at the new elements on the main screen of ST12 in figure 1.

 Main Screen

Figure 1: Main screen

The “Size&Duration” is now a toggle button (see bullet 1 in figure 1) which offers predefined settings. You have the choice of 1.) Default (2 MB trace file size and 1800 seconds trace duration and 2.) Large (20 MB trace file size and 4200 seconds trace duration and 3.) Max (99 MB trace file size and 4200 seconds trace duration). The filters for program and modularization units have moved to further options because they are rarely used. In the further options there is a new setting “Delete created ABAP trace files after collection” which is set to true as a default. ST12 behaves like SAT now and deletes the native trace files once they are imported to the database. And by the way, the “with internal tables” flag on the main screen is set to true as default now.

The clock type (see bullet 2 in figure 1) is new on the main screen. It is per default set to “Auto” which means ST12 does an asynchronous self-test in order to figure out whether the high resolution clock delivers reliable figures. Since this is not the case on all platforms, the setting is changed to low resolution clock automatically if the self-test found unreliable times. The icon shows the reliability of the high resolution clock. If you move the mouse over the icon you will get additional information. Right after the icon there is a hidden mouse over information regarding the overhead of the different clocks.

Statistical records are automatically selected and stored with the trace now. By default the top 20 (with respect to response time) statistical records matching the user and time frame of the trace are selected and stored. For the work process scenario the statistical records are not collected because often the job will still be running.

If the User Task (see below) scenario is used for tracing the traces are grouped in one trace analysis (see bullet 4 in figure 1). This is explained in more detail below.

The former scenarios “User” and “Task/HTTP” have now been merged in the “User/Tasks” Scenario (see bullet 5 in figure 1). The “schedule Trace” scenario is now accessible directly from the main screen (see bullet 6 in figure 1).

Now let’s have a look at the new options for trace recording and trace management.

In the “User/Tasks” scenario it is much easier to deal with a larger number of trace files. After recording is stopped, filters can be applied for trace collection. You may specify filters for specific task types, trace duration, program or function module names and so on (see bullet 1 in figure 2). This allows to only collecting those traces you are interested in. You can specify here as well if the trace files should be deleted after collection. This setting overwrites the main setting in ST12.

 New Options

Figure 2: New options for “User/Tasks”

The same filters are possible when you start the “collect external traces”. In this screen you can “combine the different files in one analysis” (see below). If no trace matches the filters, nothing will be collected.

Grouping traces into one trace analysis. This feature helps to manage and organize multiple traces that were recorded with the “User/Tasks” scenario or collected with “collect external traces” and the “combine the different files in one analysis” setting.

All traces that belong together are now grouped into one line in the main screen table control or in the full screen ALV list. The ABAP Trace and Performance Trace can be chosen when a single trace is selected in the list. The group line has to be expanded in order to choose a single trace (see bullet 2 in figure 3). The statistical records and SQL trace summary can be chosen if a single trace is selected or for the header entry (see bullet 1 in figure 3). The statistical records will always show the top 20 statistical records that have been selected. The SQL trace summary shows either the SQL trace for the server where the selected single trace was recorded or a system wide summary across all servers if the header entry was selected.

 User Tasks

Figure 3: New options for “User/Tasks”

In the full screen trace list it is now possible to change the comment of selected traces after recording (bullet 3 in figure 3). And just to remind you: comparing or merging traces is possible here as well (bullet 4 and 5 in figure 3) since the previous versions already. These options will be explained in more detailed blogs later.

Another nice feautre is the ABAP trace summary by application component (button to the rigth form bullet 5 in figure 3) which was completely new developed. Here you will see a break down of the trace in application compoonents. The details of this feature will be explained in a separate blog.

Last but not least the “Schedule Trace” Scenario:

The new option to schedule a trace for User / Tasks scenarios was added to the existing scheduled trace scenarios for background jobs and work processes (bullet 2 in figure 4). At the “From” point in time an ABAP Trace like in the “User/Tasks” scenario is started. At the “To” time the traces are finished and collected. Trace collection is also triggered when “Stop trace” is clicked.

Schedule a trace

Figure 4: Schedule a trace

In the batch job or work process scenarios schedule traces can now have so called follow up traces. You can specify how much of these follow up traces you want to have. If a trace is scheduled and ends at the specified time limit a new trace will be started for the same process until the number of specified follow up traces is reached. With this setting you can trace long running processes conveniently and schedule multiple traces that will be started sequentially one after the other. A log was added to analyze the scheduled traces. These features will be detailed in a future blog.

 Summary:

SP01 adds many features that make trace recording and management easier.

More information on ST12 can be found here:

ST12 WIKI:

http://wiki.sdn.sap.com/wiki/display/ABAP/Single+Transaction+Analysis

Books:

http://www.sap-press.com/product.cfm?account=&product=H3060

http://www.sap-press.de/1821

To report this post you need to login first.

5 Comments

You must be Logged on to comment or reply to a post.

  1. Kevin Grove
    Herman:

    Thanks for the updates on ST12. We have found it most useful in problem analysis. Best of all most of our functional team find it usable and can run traces themselves.

    Hope to see more improvements to come.

    Best regards,

    Kevin Grove

    (0) 
    1. Hermann Gahm Post author
      Hi Kevin,

      thanks for the feedback. Yes, we keep enhancing ST12 with new useful features. Our feature request list keeps growing.

      Kind regards,

      Hermann

      (0) 
  2. Clemens Li
    Hi,

    thank you for introducing this new feature for scheduled JOB tracing.

    Unfortunately I can’t see or get the ‘Schedule trace’ button. Also no Size/Duration with pencil in the ABAP trace block. The further options on top right of this block opens a popup where I can enter max file size, measurement accuracy, max runtime and the like.

    According to note 69455 system should have
    SAPKITAR7G          ST-A/PI    01N_700ECC
    In my system, I can see system-status with
    ST-A/PI     01N_700ECC     0000          –     Application Servicetools for ECC 600.

    This looks like correct release. Will we have to install service pack?

    Thanks a lot.

    Regarsd, Clemens

    (0) 
    1. Hermann Gahm Post author
      Hi Clemens,

      yes, you need the service pack. (SP1 for 01N).
      you can get it here:

      http://service.sap.com/swdc
      – support packages and patches
         – browse our download catalog
           – plugins
             – SAP Solution Tools
               – ST-A/PI

      However, scheduling a trace is possilbe in your version as well:

      it is Menu Utilities->Schedule trace->for batch job or work process from the menu:

      More details on how to schedule a trace are available in my latest blog:

      ST12 –  Schedule Traces

      Kind regards,

      Hermann

      (0) 

Leave a Reply