Workload Monitoring: Manually Adding a TCODE for Monitoring
Due to performance overhead and limited use, we transitioned workload monitoring from wholesale to custom configurations. Here are the instructions on how to add single TCODE monitoring.
Collection
Workload Statistics are not collected for all TCODEs anymore; to collect specific TCODE stats, you need to explicitly configure a retriever (or create a dedicated retriever).
Navigate to the system of interest in the grid, and click Retriever tool/leaf.
An inactive retriever, Stats Summary Retriever, is always created. For easy maintenance, make a copy for each type as needed:
For TCODEs selection
For TaskType (and TCODEs) selection
For User (and TCODEs) selection
Any combination of custom selector
Please be advised that a single retriever's Gateway/SAP overhead is repeated for each additional one. Stats Summary retriever always pulls/summarizes all STAT records for the interval; the On-Gateway retriever will enumerate all records returned from SAP and match them to the selector; only matching records will be posted to IT-Conductor. Busy SAP systems have thousands of STATS records per interval (normally 15 min), which will create a significant overhead, so try to consolidate these retrievers as much as possible.
Retriever Selectors
Add/Modify the Insertion Criteria records; the drop-downs will suggest the values.
You usually focus on:
SAPDialogStep.TASKTYPE
SAPDialogStep.TCODE
SAPDialogStep.TERMINALID
SAPDialogStep.ACCOUNT
All Insertion criteria work on an “AND” basis.
Use Exclusion criteria if needed, which will be applied after the Insertion Criteria so you can filter out undesired records.
Modify the Read Interval if needed (default 15 min). This interval is for calculating the summary records and calculating the repeat executions of the retriever.
If you set the interval to 30 minutes, then 30 min average records for each TCODE/TASKTYPE/ACCOUNT/TERMINAL/TimeStamp combination will be created; you will not be able to zoom in time-wise below that. If you change it afterward, you will need to update the associated aggregators, or the end data will not be accurate.
Aggregation
Consolidators
After the STAT Record objects (class SAPServiceAggregatorSTATSummaryTCODE) are created in IT-Conductor you need to configure the aggregation/threshold to make sense of the interval data. The individual TCODE Aggregators (SAPServiceAggregatorSTATSummaryTCODE) are automatically created (currently, the template is disabled for an overhead reason) however, you will need to configure manually the so-called Buckets (aka consolidators) that consolidate individual aggregator data into bucket data.
You can either create a new consolidator manually or add “source” to an existing consolidator. The “source” is a setup that defines the criteria for the inclusion of aggregators into the bucket. If you only need to monitor a single “standalone” TCODE you don't need a consolidator.
The Threshold (monitor) is auto-created for Consolidator. But for individual (standalone) TCODE aggregators, you will need to create one manually.
Threshold Override for Consolidators
Create a threshold override for Target Class=ConsolidatorSAPStats.
Threshold Collector
An alternative, more modern, and efficient way to aggregate the data is to use Threshold Collector (SAPStatSummaryThresholdCollection). Threshold Collector combines data record aggregation and value monitoring in one.
Modify an existing one to include more TCODEs or create a new one.
Select Value Attribute to form the drop-down menu (default - SAPDialogStep.RESPTI).
Select Application (SAP NW) from the drop-down menu (Optional).
Type in the SAP Account (Optional).
Type in TCODE Regex (any valid regex expression, case sensitive, use (?i) to turn off case sensitivity).
Type in Task Type list (comma-separated, optional, use Task-Type Field Definition for numeric task type values).
Important: Ensure you create objects when impersonating the tenant’s user or select the proper tenant owner if you are IT-Conductor administrator.
Upon creating the "Threshold Collector", a new Workload container will be created (if it doesn’t exist) and discovered under the SAP Grid; the threshold will also appear.
We recommend creating "Threshold Collector" instead of old-style Consolidators, but if you need Bucket support with drill-down functionality (into individual TCODEs), the Consolidators are the way to go.
Threshold Override for Threshold Collector
Create a threshold override for Target Class=SAPStatSummaryTCODE.
Last updated
