SAP Marketing Cloud - for SAP Focused Run 3.0 FP02

This page explains how to connect SAP Marketing Cloud to SAP Focused Run. For the setup of the supported monitoring applications, please click on the monitoring application below.

Currently, the following monitoring applications are supported for SAP Marketing Cloud:

Prerequisites

The following technical prerequisites have to be met in order to monitor this scenario:

PUSH vs. PULL Data Collection

With PUSH data collection the managed cloud service now actively pushes monitoring data to SAP Focused Run via SAP Cloud ALM which is used as a reverse proxy. 

PUSH data collection has the following advantages over PULL data collection:

  • PUSH data collection uses OAuth 2.0 to connect from the managed cloud service to SAP Cloud ALM (PULL uses BASIC authentication)
  • Data is only transferred if new monitoring data exists (no unnecessary connections)

While it is still possible to use PULL data collection for SAP Marketing Cloud with SAP Focused Run 3.0 FP02, PULL data collection will be disabled in a future SAP Focused Run release, to avoid the use of BASIC authentication in connections. If you already monitor your cloud service using PULL data collection, we recommend that you switch to PUSH data collection.

Activation of PUSH data collection for cloud services already monitored using PULL data collection

If you already monitor SAP Marketing Cloud using the PULL data collection, please note the following:

  • With the activation of PUSH data collection a new cloud service will be created in LMDB by the registration process
  • It will not update or overwrite the existing cloud service created manually during the PULL data collection setup
  • Historical monitoring data collected with the "old" PULL based mechanism will remain attached to the "old" cloud service for reporting

To deactivate the PULL data collection for the existing monitoring setup:

  1. Deactivate the monitoring data collection in Integration & Exception Monitoring and Real User Monitoring
  2. Delete the endpoints in the cloud service in LMDB
  3. Do not delete the cloud service from LMDB yet, to avoid losing historical monitoring data

Preparation in SAP Focused Run

With SAP Focused Run 3.0 FP02, we do not support the landscape sync between SAP Cloud ALM Landscape Management, and SAP Focused Run Cloud Service Management. However, since May 2022, SAP Marketing Cloud has used a new version of the monitoring PUSH registration, which requires the cloud service to already exist in the target landscape directory (i.e., LMS or CSM).

Therefore, before you can activate the monitoring PUSH, you must manually create the SAP Marketing Cloud service in Cloud Service Management.

Before creating the cloud service in Cloud Service Management, please collect the following information:

  1. Navigate to your SAP Cloud ALM Launchpad
  2. Go to "Administration" > "Landscape Management"
  3. Find your SAP Marketing Cloud tenant in the list (service type: SAP Marketing Cloud)
  4. Copy the value for "Tenant ID" (or in the details view "System Number")
  5. Select the SAP Marketing Cloud tenant to access the detailed view
  6. Copy the value for "Properties" > "URLs" > "Main URL"

 

Input Values for SAP Marketing Cloud

  • Tenant: Enter the Tenant ID you collected earlier
  • Root URL: Adjust your SAP Marketing Cloud Main URL by adding -api after the hostname ( e.g. https://my12345-api.s4hana.ondemand.com )
  • Description: (optional)

Setup Steps in SAP Marketing Cloud

Enable Monitoring Data PUSH to SAP Focused Run via reverse proxy

Perform the following steps to enable SAP Marketing Cloud to send monitoring data to SAP Cloud ALM.

Prerequisites:

  • You need a user with administrator authorizations in SAP Marketing Cloud
  1. Log on to SAP Marketing Cloud
  2. Navigate back to the 'Communication Management' view and select 'Communication Arrangements'
  3. Click the New button to create a new Communication Arrangement
  4. Scenario: Select SAP_COM_0527 'Application Monitoring Push Integration'
  5. Click the New button next to 'Communication System' to create a new communication system
    1. Enter a System ID and description and click the Create button
    2. In the field 'Host Name' enter SAP Cloud ALM service key parameter "Api" without /api, e.g. eu10.alm.cloud.sap
    3. Make sure the 'Port' is set to 443
    4. Under 'OAuth 2.0 Settings' > 'Token Endpoint' enter SAP Cloud ALM service key parameter "uaa":"url" extended by /oauth/token
    5. Under 'Users for Outbound Communication' click the + button to create a new user
      1. Authentication Method: Choose OAuth 2.0
      2. OAuth 2.0 Client ID: SAP Cloud ALM service key parameter "uaa":"clientid"
      3. Client Secret: SAP Cloud ALM service key parameter "uaa":"clientsecret"
    6. Save the communication system. The UI will take you back to the communication arrangement
  6. Enter an 'X' for 'Enable Integration Monitoring', 'Enable Exception Monitoring', and 'Enable Performance Monitoring'
  7. The 'Outbound Communication' fields are automatically propagated from the communication system
  8. The "Path" field under 'Outbound Services' is where you have to maintain the path to SAP Focused Run, enter:
    1. The suffix from the Reverse Proxy URL from the endpoint in SAP Cloud ALM, e.g. /api/frunrevproxy/v1/my_customer_network/sap/frun/
  9. Press the "Enter" key. This will trigger the propagation of the fields below when you save the communication arrangement
  10. Adjust the Job Execution Details to schedule the job to Run Every 01 Minute(s)
  11. Save

After the successful setup in your SAP Marketing Cloud tenant, the managed cloud service will automatically be created in the Cloud Service Management of SAP Focused Run.

Setup Steps in SAP Focused Run

No further steps are necessary to connect SAP Marketing Cloud to SAP Focused Run.

You can now perform the setup steps for the supported scenarios.

Troubleshooting

To investigate errors during the setup of the monitoring PUSH please refer to the troubleshooting page.