This documentation is intended for usage by SAP developers in the customer development projects, who is developing the Reporting functionality on the top of the MAI infrastructure and looking for the uniform API and single source of truth for the monitoring data. The provided scope of the functionality is constantly updated and the new features can be requested. For example, new key figures, characteristics, filters, measures etc.
Business process Monitoring and Application Monitoring in Solution Manager collects a lot of monitoring data regarding the system landscape and the business processes. This data is stored in the different tables\info providers with heterogeneous structure and monstrous APIs. The purpose of this functionality is to provide standardized and performance efficient access to this data for subsequent consumption in the end-user applications, for example, OData, WebService, FPM, RFM etc. The used data is extracted from MAI, LMDB, DMD(version 7.1), SMUD(version for 7.2), CDC(version 7.2 ) and BPMon.
The functionality available and supported in the following releases:
- SAP Solution Manager 7.1 SP12 and above
- DMD dimensions are supported
- SAP Solution Manager 7.2 SP03 and above
- SMUD dimensions are supported
- CDC key figures are supported from SP05 and above ( down port to SP03 is possible on demand)
Consumption in the customer project
Central Catalog API
All data requests in the API are placed against the catalog object:
Use the key figure catalog object to get the key figure object using the unique key figure id:
For the list of supported key figures, their meaning and constants look into the key figure catalog.
The key figure can be queried using the following call:
Key Figure catalog
Supported key figures(the list is not complete, right now more like the example):
|Key Figure Name||UoM||Constant||Description|
|Alert Groups based key figures|
|Average Duration of the Alert Groups until confirmation||min|
|Number of the Alert Groups||#|
|Count the number of the alert groups|
|Events based key figures|
|Last Rating of the Events|
|Find the last rating of the event if several events are grouped choose the worst rating|
|Monitoring Object ID||MAI monitoring Object ID||AC_GUID||005056836AD61ED58BD7926B6A082C51|
|Alert Type||Alert Type Name||AC_TEXT_255||ALRT_BW_PROCESS_CHAIN_DURATION_PERF|
|System ID||System ID||SYSYSID||QPT|
|Business process||Process GUID||AC_GUID||005056836AD61ED58BD7926B6A082C51|
|Business process step/interface||Process step GUID or Process Interface GUID||AC_GUID||005056836AD61ED58BD7926B6A082C51|
|Job Monitoring Technical Scenario||Job Monitoring Technical Scenario ID||DIAGLS_TECH_SCEN_NAME||JM_DSS_327|
|Interface Monitoring Technical Scenario||Interface Monitoring Technical Scenario ID||DIAGLS_ID||HCI_Scenario~INTER_MON|
Date and Time
|Timestamp||Data and Time YYYYMMDDHHMMSS||TIMESTAMP||20150102100000|
All dimensions support the TopN filter condition:
which is used in order to limit the number of the records sent back by API. Only one TopN condition can be supplied in the single API call.
How to find out the key figure ID in the SAP Solution Manager 7.1 and 7.2
Go to the transaction SM_WORKCENTER:
- Open Business Process Monitoring(new) work center
- Open the link Setup Dashboards
- Press button Add
- Search for the key figures using the search string "MAI.*
For example, Number of Alert Groups corresponding KF ID: ALERTS/NUM_AL_GRP.
How to find out the key figure ID in the SAP Solution Manager 7.2 only
Go to the transaction SM_WORKCENTER:
- Find the Dashboard Builder Configuration tile
- Open the tile
- Create a new Dashboard Tile or select existing one
- Go to the tile configuration screen
- Choose the data source "Business Process Monitoring"
- Press F4 help in the field "Data Source Name"
- Browse the catalog for the key figure which fits your need
- You can see the technical key figure ID right below the key figure description
For example, for the ABAP Job Duration in the Metric Cube, the corresponding KF ID is JOBMON/AJOB_H/MG_JOB_MON_MAX_DURAT.
Typical consumption pattern of the API in the consumer application
Assistance from SAP during Implementation
In case you need assistance during the implementation of these APIs, SAP can help you either via your premium service engagement (contact your TQM) or via expertise on demand.
Related SAP Notes/KBAs
SAP Solution Manager 7.1 from SP12: SAP Note 2059910: MAI connector for BPO dashboards: Cumulative note
SAP Solution Manager 7.2 from SP03: SAP Note 2341333 - Cumulative Correction Note for the Business Process Monitoring data source in the Dashboard Builder 7.2 SP03 and upward