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
    • Endpoint: The protocol and host part of the service key parameter "Api", e.g. https://eu10.alm.cloud.sap
    • OAuth URL: Service key parameter "url" + /oauth/token, e.g. calm-tenant.authentication.eu10.hana.ondemand.com/oauth/token
    • Client ID: Service key parameter "clientid"
    • Client secret: Service key parameter "clientsecret"

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: Enter the value you collected for the Endpoints value
    4. Authentication: Select 'OAuth2ClientCredentials'
    5. Client ID: Enter the clientid value from the service key
    6. Client Secret: Enter the clientsecret value from the service key
    7. Token Service URL: Enter the value you collected for the OAuth URL
  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 for 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' view 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
  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.