Setup for SAP BTP ABAP Environment

This page explains how to connect the SAP BTP ABAP Environment to SAP Cloud ALM to enable monitoring.

Currently the following monitoring application are supported for the SAP ABAP Environment:

Prerequisites

To enable SAP BTP ABAP Environment to send monitoring data to SAP Cloud ALM:

  • You need an user with Administrator authorizations in SAP BTP ABAP Environment
  • You need Space Developer access to a space in the SAP BTP ABAP Environment sub-account
  • You need to obtain the SAP Cloud ALM Service Key to connect to the SAP Cloud ALM system

Destination Setup in SAP BTP Cockpit

Create Destination in BTP Cockpit

  1. Log on to SAP BTP Cockpit and navigate to the sub-account for your SAP BTP ABAP Environment 
  2. Go to Connectivity > Destinations
  3. Click on "New Destination"
  4. Create a new destination using the "Blank Template" view
    1. Name: Enter a name for the destination
    2. Type: HTTP
    3. URL: SAP Cloud ALM service key parameter "Api" without /api
    4. Authentication: Select 'OAuth2ClientCredentials'
    5. Client ID: SAP Cloud ALM service key parameter "clientid"
    6. Client Secret: SAP Cloud ALM service key parameter "clientsecret"
    7. Token Service URL: SAP Cloud ALM service key parameter "url" + /oauth/token
  5. Save the destination

Create Destination Service Instance

  1. Log on to SAP BTP Cockpit and navigate to the sub-account for your SAP BTP ABAP Environment 
  2. Go to Cloud Foundry > Spaces
  3. Access the space that contains the SAP BTP ABAP Environment service instance
  4. Navigate to Services > Instances
  5. Verify that there is no instance for the service "Destination". If there is already a "Destination" service instance go to step 8.
  6. Click the "Create" button
    1. Service: Select "Destination"
    2. Plan: Select "lite"
    3. Instance Name: Enter a name for the service instance
    4. Click the "Create" button
  7. Click on your new service instance
  8. In the right-hand tray under "Service Keys" click "Create"
    1. Enter name for the service key
    2. Click "Create"
    3. Download and save the service key

Create Communication Arrangements

For SAP BTP ABAP Environment you have to create two Communication Arrangements. 

One that connects you to the destination service instance you created in SAP BTP Cockpit earlier and another one that schedules the data collection and pushes the monitoring data via the destination you created in SAP BTP Cockpit. 

Create Communication Arrangement for Destination Service

  1. Navigate to the "Communication Management" view and select "Communication Arrangements"
  2. Check if there already is a communication arrangement for scenario SAP_COM_0276
    1. Enter "0276" in the Search field. 
    2. If a communication arrangement already exists you don't need to create a new one
  3. Click the "New" button to create a new communication arrangement
    1. Scenario: Select SAP_COM_0276 'SAP Cloud Platform Destination Service Integration'
    2. Arrangement Name: Enter a name
    3. Paste the content of the service key file of your Destination service instance that you created in SAP BTP Cockpit
  4. Save the communication arrangement.

Create Communication Arrangement for Data Collection

  1. Navigate back to the "Communication Management" and select "Communication Arrangements"
  2. Check if there already is a communication arrangement for scenario SAP_COM_0527 for this SAP Cloud ALM tenant
    1. Enter "0527" in the Search field. 
    2. If you find a communication arrangement check if it uses the communication system for the SAP Cloud ALM tenant you want to connect
    3. If a communication arrangement already exists move on the step 5
  3. Click the "New" button to create a new Communication Arrangement
    1. Scenario: Select SAP_COM_0527 'Application Monitoring Push Integration'
    2. Arrangement Name: Enter a name
  4. Click the "New" button next to the field "Communication System" to create a new communication system
    1. Enter a System ID (e.g. CALM) and description and click the "Create" button
    2. Under General > Destination Service
      1. Make sure the lever is set to "ON"
      2. Select "Use Default Instance"
      3. Name: Enter the name of the destination you created in SAP BTP Cockpit
    3. Save the communication system.
  5. Enter an "X" for each supported use-case for which you want to collect data
    • Currently only the use-cases "Health Monitoring", "Performance Monitoring", and "Exception Monitoring" are supported
  6. Under "Outbound Services" 
    1. Job Execution Details: schedule the job to Run Every 01 Minute(s). The job will be set to "Active" after saving.
  7. Save the communication arrangement.

Next Steps

After setting up the monitoring PUSH to SAP Cloud ALM in the managed service, the data collection for the use-cases selected in the communication scenarios will be activated automatically with default monitoring configurations. 

You can adjust the monitoring setup within the monitoring application. Find more information on the configuration on the "Setup & Configuration" pages for the application.