Monitoring Configuration
Step 1: Configure Exception Management
After the basic configuration you now have to configure Exception Management, as the exceptions collected via Exception Management and stored in the central exception store are the basis for the Integration Monitoring data collection.
For SAPCloud Integration youonlyhave to configure Exception Management, if you want to be able to analyze the single exceptions in SAP Solution Manager. Some metrics available for SAP Cloud Integrationdo not require the Exception Management setup. Check the list of available metrics for details.
Configuration forSAP Cloud Integration
To access the Exception Management setup please go to transaction SOLMAN_SETUP→ Application Operations→ Exception Management
- In the step 'Define Scope' select the tab 'Cloud Services' and your SAP Cloud Integration system.If you didn't configure the system before make sure to select 'All Cloud Services' in the view drop-down. Click on 'Configure' or click 'Next' two times. You will enter the step 'Exception Configuration'.
- Click 'Add / Configure Log Store'. Select 'SAP BTP Integration'. Select the correct end-point for the SAP Cloud Integration cloud service if you have more than one.
- Select the fields for filtering for your log store. The following filter fields are available:
- iFlow ID: Name of theArtifact ID for which you want to receive exceptions
- Message: Filter on the error message
- Maintain the filter values for the fields in the Filter Definition panel under the log stores table. You can also add, remove or change filter fields and values later on in the area. You can use different operators for your filter value. You can add more than one filter filed combination per log store. To add an additional filter field combination click on the button 'Add Filter'in the 'Configured Log Stores' panel.
- You shouldnotset up the monitoring for the exceptions in the Exception Management. If you activate the monitoring here, you will receive an alert (and if set up this way an email) for every single exception in the application log. Instead we will use Interface and Connection Monitoring to monitor the central exceptions store for exceptions.
Step 2: ConfigureInterface and Connection Monitoring
The last step is the configuration of Interface and Connection Monitoring. The Interface and Connection Monitoring setup can be accessed via SAP Solution Manager Configuration (SOLMAN_SETUP).
Configuration for Monitoring Template: Cloud (SAP Cloud Integration)
To access the Integration Monitoring setup please go to SAP Solution Manager Configuration (SOLMAN_SETUP)→Application Operations→ Integration Monitoring→ Interface and Connections.
Navigate to the step 'Define Scope'. You can create a new scenario for the SAP Cloud Integration monitoring or use an existing one. Make sure the on premise system for the SAPCloud Integrationscenario and the Cloud Service created for SAP Cloud Integrationis part of the Interface and Connection Monitoring scenario.
Create the Interface Channel:
- Select the scenario and click 'Next'
- In step 'Preparation' perform all relevant manual activities andrun all automatic activities.
- In step 'Configuration' click the 'Add' button.
- Channel Name: Enter a meaning full name (max. 30 characters)
- Type: Select 'Cloud'
- Monitoring Template: Select 'Cloud (SAP Cloud Integration)'
- Description: Enter a description for the channel
- Click Next.
- Source type:
- If the source system is the on premise system, please select 'Technical System'
- If the source system is the SAPCloud Integrationservice please select 'External Service'
- Source: Select the on premise system resp. theSAP Integration Suite - Cloud Integration Cloud Service from the drop-down list
- Target Type:
- If the target system is the on premise system, please select 'Technical System'
- If the target system is the SAP Cloud Integrationservice please select 'External Service'
- Target: Select the on premise system resp. the SAPCloud IntegrationCloud Service from the drop-down list
- The measuring point is selected automatically
- If more than one client are connected for the on premise system please select the correct client for the monitoring
- Click Next.
- Click Finish.
Maintain theInterface:
- Select theinterface channel you created
- On the 'Interfaces' tab click the 'Add' button.
- Provide the following information:
- Interface name: Enter a name for the interface
- Endpoint ID (mandatory): Select the end point created for the SAP Cloud Integrationcloud service
- IFlow ID (mandatory): Enter the name if the IFlow you want to retrieve exceptions for. You can use '*' to collect all exceptions
Select Metrics:
- On the tab 'Metrics' select the metrics you want to monitor SAP Cloud IntegrationMetrics
- Save your interface channel by clicking on the 'Save' button.
Metrics in Interface and Connection Monitoring
Only the some metrics on the metric list are retrieved from the SAP Exception Management, the rest of the metrics is collected directly from SAP Cloud Integration. For these metrics you must maintain filter criteria to collect them.
For the metrics collected from Exceptions Management, filters are optional. For these metrics the data collection is based on the content of the global exceptions store, you can always check the collected exceptions in Exception Management. All filter parameters are part of the collection context of the exceptions. The filters applied in Interface and Connection Monitoring allow you to filter the exceptions collected by the Exception Management further. However if the filters in Exception Management do not collect an exception, it is not available in the central exception store and you will not be able to find it in Interface and Connection Monitoring!
If you choose to use the metrics from SAPCloud Integrationdirectly to monitor the number of exceptions, you will not have the exception details available in SAP Solution Manager Exception Management, but only get the information how many exceptions occurred.
You can maintain attributes as described intheInterface and Connection Monitoring Setupon the tab 'Attributes'.
Thresholds and the collection schedule are maintained in the next step of the guided procedure. Once you have maintained all your channels, click 'Next' in the main guided procedure to move to the step 'Activation'.
Maintain Thresholds and Schedule:
- Select the Alert for the interface channel (the alert is the line with the red flash icon next to it)
- On alert level you can maintain notification and incident message creation
- Do not remove the flag for 'Do not Group Individual Occurrences' as this flag ensures that an alert each time new exceptions are found during a data collection interval
- Select the Metrics
- Do not change the data collector type or data collectorname on the tab 'Data Collection' as the monitor will not work anymore if this is changed.
- Do not change the threshold if it is setto 'Already Rated'.
- Click 'Apply and Activate'→ <Choose one option> to activate the monitoring
If not active you can also activate the reporting for the channels by checking the box in the column 'Reporting'. This way you can see a history of the number of exceptions that happened and also place the metric on the OCC Dashboard in Focused Insights.