Setup for SAP BTP, ABAP Environment

This page explains how to connect the SAP BTP, ABAP Environment to SAP Cloud ALM to enable monitoring for custom build applications.

Currently, the following monitoring applications are supported for the SAP BTP, ABAP Environment:

Prerequisites

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

  • You need a 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 Service". If there is already a "Destination Service" service instance go to step 8.
  6. Click the "Create" > "Service Instance" button
    1. Service: Select "Destination Service"
    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 a name for the service key
    2. Click "Create"
    3. Download and save the service key

Create Communication Arrangements

The following steps have to be performed inside the SAP BTP, ABAP Environment. 

  1. In BTP Cockpit, go to "Services" > "Instances & Subscriptions"
  2. Find your SAP BTP, ABAP Environment subscription
  3. Click on "Go to Application"

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
  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 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. 

Troubleshooting & Customer Support

To troubleshoot any issues with the setup or the data collection for SAP BTP, ABAP environment, please follow the Troubleshooting for ABAP Cloud-based Systems page

Should this information not suffice to address your problem please open an incident.