About Performance Aggregation Analysis and Data

This topic is part of Analyzing Siebel ARM Files Using the Siebel ARM Analyzer Tool.

Performance aggregation analysis is a compilation of the data contained in a Siebel ARM binary file. Siebel ARM files group performance data based on the instrumented areas. For information and a listing of instrumented areas, see About Siebel Application Response Measurement. For more information about creating this format of Siebel ARM output, see Running Performance Aggregation Analysis.

Running a performance aggregation analysis of a Siebel ARM file results in an extensible markup language (XML) output file. This file contains timing data for the instrumented areas.

The amount of information contained in the performance aggregation analysis XML output depends on the argument used for the -a flag when you perform the analysis (either AREA or DETAILS) and on the setting for the SARM Granularity Level parameter. For information about this parameter, see About Siebel ARM Parameters and Variables.

The performance aggregation XML output file contains the following tag schema when the -a flag argument is set to DETAILS. If the -a flag argument is set to AREA when you run the analysis, then the tag schema is the same, minus the <NumberOfSubAreas> and <SubArea> information.

<Area>
   <Name>
   <Symbol>
   <NumberOfSubAreas>
   <Invocations>
      <Recursive>
      <NonRecursive>
   <ResponseTime>
      <Total>
      <Average>
      <StandardDeviation>
      +<Maximum>
      +<Minimum>
   <ExecutionTime>
      <Total>
      <Calls>
      <Average>
      <Maximum>
      <Minimum>
      <PercentOfResponse>
   <RecursiveTime>
      <Total>
      <Calls>
      <Average>
      <Maximum>
      <Minimum>
      <PercentOfResponse>
   <InclusiveMemory>
      <Total>
      <Average>
      <StandardDeviation>
      +<MaxAllocated>
      +<MaxDeallocated>
   <ExclusiveMemory>
      <Total>
      <Average>
      <StandardDeviation>
      +<MaxAllocated>
      +<MaxDeallocated>
   <SubArea>
      <Name>
      <Symbol>
      <NumberOfInstances>
      +<Invocations>
      +<ResponseTime>
      +<ExecutionTime
      +<Memory>
      +<Instance>
      +<Parents>
      +<Children>
   <Parents>
      <NumberOfParents>
      <ParentArea>
         <Name>
         <Symbol>
         +<<InvocationsFromParents>
         +<ResponseTime>
         +<Memory>
   <Children>
      <NumberOfChildren>
      <ChildArea>
         <Name>
         <Symbol>
         +<InvocationsOfChild>
         +<ResponseTime>
         +<Memory>

For descriptions of each of the tags, see the following table.

Tag	Description
Area	Specifies performance data captured for a specific area of the Siebel ARM architecture. There might be one or more areas captured with performance data. For more information about Siebel ARM areas, see About Siebel Application Response Measurement.
Name	Name of the area containing performance data. For a listing of area names, see About Siebel Application Response Measurement.
Symbol	Symbol of the area containing performance data. For a listing of symbol names, see About Siebel Application Response Measurement.
NumberOfSubAreas	A count of subareas within the area that contain data. This figure also indicates the number of <SubArea> tags appearing under the particular <Area> tag.
Invocations	Number of times this area was called during the monitoring period. Recursive – One of the key features of Siebel ARM is the capability to handle recursion. An example of a recursive call is if a workflow step calls a Siebel Application Object Manager function, which also invokes another workflow step. When accounting for the number of times the workflow layer is called, Siebel ARM uses two metrics: Recursive and NonRecursive. In the previous example, Recursive is 1 and NonRecursive is also 1. When calculating the response time, only the root-level call is accounted for, that is, the first workflow call to the Siebel Application Object Manager function. When calculating execution time, both calls are accounted for. Nonrecursive – Number of times an instrumentation area is called. This tag helps identify how fast it takes a layer to respond to a request.
ResponseTime	Specifies the time spent for a request to enter and exit an instrumentation area (layer), including calls to other child areas. It is also called inclusive time in other commercial profiling tools. Other tags in this area include: Total – Total time spent by requests through this instrumentation area (layer). Average – Average response time for a request. StandardDeviation – The standard deviation value of request times through this area. +<Maximum> – The maximum time spent by a request in this area. Expand this tag to review further details on the specific Siebel ARM node where this time was spent. For more information about Siebel ARM node tags, see About Call Graph Generation Analysis and Data. +<Minimum> – The minimum time spent by a request in this area. Expand this tag to review further details on the specific Siebel ARM node where this time was spent. For more information about Siebel ARM node tags, see About Call Graph Generation Analysis and Data.
ExecutionTime	Specifies the total time spent in a particular instrumentation area, not including the time spent in the descendant layers. It is also called exclusive time in other commercial profiling tools. Other tags in this area include: Total – Total time spent for a request to enter and exit an instrumentation area (layer). Calls – Total number of calls including both recursive and nonrecursive calls. Average – Average time spent for a request to enter and exit an instrumentation area (layer). Maximum – Maximum time for a request to enter and exit an instrumentation area (layer). Minimum – Minimum time for a request to enter and exit an instrumentation area (layer). PercentageofResponse – Percentage of the total response time spent in the area.
RecursiveTime	Specifies the total time spent in recursive calls within this area. That is, the time spent in this area when it calls itself. Other tags in this area include: Total – Total time spent for recursive requests. Calls – Number of recursive calls. Average – Average time spent for a recursive request. Maximum – Maximum time spent by a recursive request. Minimum – Minimum time spent by a recursive request. PercentageofResponse – Percentage of the total response time spent recursively in the area.
InclusiveMemory	Specifies the amount of memory used by requests that enter this area and any child or descendent areas. The memory value is recorded in bytes. Other tags in this area include: Total – Total memory usage by requests in this area. Average – Average memory usage by requests in this area. StandardDeviation – The standard deviation value of memory usage in this area. +<MaxAllocated> – Expand this tag to reveal further data on Siebel ARM node where maximum memory was allocated. +<MaxDeallocated> – Expand this tag to reveal further data on Siebel ARM node where memory was deallocated. For more information about Siebel ARM node tags, see About Call Graph Generation Analysis and Data.
ExclusiveMemory	Specifies the amount of memory used by requests that enter only this area. The memory value is recorded in bytes. Other tags in this area include: Total – Total memory usage by request in this area. Average – Average memory usage by a request in this area. StandardDeviation – The standard deviation value of memory usage in this area. +<MaxAllocated> – Expand this tag to reveal further data on Siebel ARM node where maximum memory was allocated. +<MaxDeallocated> – Expand this tag to reveal further data on Siebel ARM node where memory was deallocated. For more information about Siebel ARM node tags, see About Call Graph Generation Analysis and Data.
SubArea	Specifies performance data captured for a specific subarea of the given area. There can be one or more subareas captured with performance data under a given area. Name – Name of the subarea containing performance data. Symbol – Symbol of the subarea containing performance data. NumberOfInstances – A count of instances within the subarea that contain data. This figure also indicates the number of <Instance> tags appearing under the particular <SubArea> tag. An instance is a further level of detail defining the subarea. Invocations – Number of times this subarea was called during the monitoring period. +<ResponseTime> – Specifies the time spent for requests to enter and exit the subarea. Expand this tag to review further timing details. These tags are the same as those defined for the area ResponseTime tag. +<ExecutionTime> – Specifies the time spent in the subarea. Expand this tag to review further timing details. These tags are the same as those defined for the area ExecutionTime tag. +<InclusiveMemory> – Specifies the amount of memory used by requests that enter this subarea and any child or descendent areas. The memory value is recorded in bytes. Expand this tag to review further memory details. The expanded tags are the same as those defined for the area InclusiveMemory tag. +<ExclusiveMemory> – Specifies the amount of memory used by requests that enter only this subarea. The memory value is recorded in bytes. Expand this tag to review further memory details. The expanded tags are the same as those defined for the area ExclusiveMemory tag. +<Instance> – An instance is another level of detail defining the subarea. Expand this tag to review further the instance's details. These tags are the same as those defined for the area tag. +<Parents> – Specifies the parents of the subarea; that is, those areas that called the subarea. Expand this tag to review further parent subarea details. These tags are the same as those defined for the area Parents tag. +<Children> – Specifies the children of the subarea; that is, those areas called by the subarea. Expand this tag to review further parent subarea details. These tags are the same as those defined for the area Children tag.
Parents	Specifies the parents of the subarea; that is, those areas that called the given area. This information helps identify the caller or callers of an area and the total time and number of calls the area contributed to its parent's response time. Other tags in this area include: NumberOfParents – A count of parent areas calling the given area. ParentArea – Specifies performance data captured for a specific parent area of the Siebel ARM architecture. There can be one or more parent areas captured with performance data. Name – Name of the parent area calling the given area. Symbol – Symbol of the parent area calling the given area. +<InvocationsFromParents> – Number of times the given area was called by the parent area. Expand this tag for further timing details. +<ResponseTime> – Specifies the time spent for a request to enter and exit the parent area. Expand this tag for further parent area response time details. +<Memory> – Specifies the amount of memory used by parent area. Expand this tag to review further parent subarea details.
Children	Specifies the areas called by a parent area; that is, those areas called by the given area. Expanding an area's children information determines response time break downs within each of the children. Other tags in this area include: NumberOfChildren – A count of child areas called by the given area. ChildArea – Specifies performance data captured for a specific child area of the Siebel ARM architecture. There can be one or more child areas captured with performance data. Name – Name of the child area called by the given area. Symbol – Symbol of the child area called by the given area. +<InvocationsOfChild> – Number of times the child area was called by the given area. Expand this tag for further timing details. +<ResponseTime> – Specifies the time spent for a request to enter and exit the child area. Expand this tag for further child area response time details. +<Memory> – Specifies the amount of memory used by child area. Expand this tag to review further child subarea details.