SAP Marketing Cloud

Available Monitoring Content

The following monitoring content is available for SAP Marketing Cloud:

CategoryTypeDescription
AIF MessagesMessagesMonitors messages sent in the SAP Application Interface Framework
Data ReplicationExceptionsCollects exceptions in the Data Replication Framework (DRF)

Setup Steps in SAP Marketing Cloud

Integration Monitoring for SAP Marketing Cloud uses a PUSH as well as a PULL mechanism to collect the data for the different monitoring categories.

PUSH data collection:

  • AIF Messages

PULL data collection:

  • Data Replication

Enable Monitoring Data PUSH to SAP Cloud ALM

To enable SAP Marketing Cloud to send monitoring data to SAP Cloud ALM.

Prerequisites:

  • You need an user with administrator authorizations in SAP Marketing Cloud
  • You need to obtain the following information to connect to the SAP Cloud ALM system
    • Endpoint: eu10.alm.cloud.sap
    • OAuth URL: <tenant>.authentication.eu10.hana.ondemand.com/oauth/token
    • Client ID: Value for field "clientid"
    • Client secret: Value for field "clientsecret"
  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. Enter the Cloud ALM endpoint URL in the 'Host Name' field
    3. Make sure the 'Port' is set to 443
    4. Under 'OAuth 2.0 Settings' enter the Cloud ALM OAuth URL in the field 'Token Endpoint'
    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: Enter Cloud ALM client ID
      3. Client Secret: Enter Cloud ALM client secret
    6. Save the communication system. The UI will take you back to the communication arrangement
  6. Enter an 'X' in 'Collect Integration Monitoring' if the field is empty. Do not change any of the other fields.
  7. The 'Outbound Communication' fields are automatically propagated from the communication system
  8. Under 'Outbound Services' enter a '/' in the field 'Path'. This will trigger the propagation of the fields below when you save the communication arrangement
  9. Save

Create Communication Agreement

The Communications Arrangement is necessary to create an HTTP end-point in SAP Cloud ALM to support the PULL data collection.

  1. Navigate to the 'Communication Management' view on the SAP Marketing Cloud launchpad
  2. Select 'Communication Systems'
  3. Create a new communication system
    1. ID: Enter e.g. CRUN
  4. Enter General data
    1. Enter a value for the host name field
  5. Create User for Inbound Communication
    1. Select the + button
    2. Click the New User button
    3. Enter user name, description and password
    4. Click the Create button
  6. Save
  7. Navigate back to the 'Communication Management' view and select 'Communication Arrangements'
  8. Create a new Communication Arrangement
  9. Scenario: Select SAP_COM_0454 'Application Monitoring Integration'
  10. Common Data: Select the CRUN communication system
  11. Inbound Communication: Enter the user created for the communication system.
  12. Save

Setup Steps in SAP Cloud ALM

Create HTTP End-Point

The end-point only needs to be created to support PULL data collection. PUSH data collection is configured in the managed cloud service and available after registration of the cloud service in Landscape Management. You can create the PULL end-point for the same system in Landscape Management, that was created by the PUSH registration.

  1. Open the Landscape Management application from the launchpad
  2. Select your SAP Marketing Cloud service
  3. Press the > button at the end of the line
  4. On the tab "Endpoints" press the Add button to create a new end-point
  5. Enter a description
  6. Choose the use-case "Exception Monitoring"
  7. Choose BASIC authentication enter the user and password created in the Communication Agreement

Activate Monitoring (Standard)

In SAP Cloud ALM you can easily activate the standard monitoring content without any additional setup effort. 

  1. Open the Integration Monitoring application from the launchpad
  2. The scope selection will appear automatically
  3. Change the drop-down for Display Service to "All"
  4. Make sure to select your cloud service in the scope
  5. Click the Configuration button in the upper right corner to access the configuration
  6. Expand the Configuration panel
  7. Change the toggle button next to the cloud service from OFF to ON

Adjust Monitoring and Alerting (Expert)

You can change which parts of the standard content are activated for each cloud service, activate and deactivate alerts or create own alerts with specific filters. 

  1. In the configuration panel, click on the name of the cloud service
  2. The "Configuration of Services" screen opens
  3. In the "Configuration for Services" screen, click the > button at the end of the line for the cloud service you want to change

Adjust Monitoring Categories

  1. Use the toggle button in the column Active to turn a monitoring category ON or OFF

Adjust Alerting

  1. Use the toggle button in the column Active to turn a standard alert ON or OFF
  2. Press the > button at the end of the line to access the detail setup for an existing alert or use the + button to create a new alert
  3. Adjust the display name if desired
  4. Expand the Filter Configuration tray
  5. Enter a filter name
  6. Select the filter category
  7. Maintain the available filter fields (see details below)

Available Alerts for SAP Marketing Cloud

  • Erroneous Message(AIF) Detected: Creates an alert for each failed message in the category AIF Messages
  • Erroneous Messages(AIF) Detected: Creates an alert if one or more failed messages in the category AIF Messages were detected since the last data collection
  • Erroneous Data Replication: Creates an alert for each exception in the category Data Replication

Available Filter Fields for SAP Marketing Cloud

The filter fields depend on the monitoring category the alert is created for and additional on the filter category, if there is more than one available.

AIF Messages - bgRFC(queue)

  • Namespace: AIF interface namespace
  • Interface Name: AIF interface name
  • Version: AIF interface version
  • Status: The last status of the message
  • Status Group: Please select a value from the input help
  • Direction: Choose I (Inbound) or O (Outbound)
  • Queue Name: Name of qRFC Queue
  • RFC Destination: RFC destination name

AIF Messages - bgRFC(trans)

  • Namespace: AIF interface namespace
  • Interface Name: AIF interface name
  • Version: AIF interface version
  • Status: The last status of the message
  • Status Group: Please select a value from the input help
  • Direction: Choose I (Inbound) or O (Outbound)
  • RFC Destination: RFC destination name
  • Transaction Code: The name of the SAP transaction code with which the unit was created
  • Program: Tcode/program with which the unit was created
  • User: The name of the user under which the unit is recorded

AIF Messages - IDOC

  • Namespace: AIF interface namespace
  • Interface Name: AIF interface name
  • Version: AIF interface version
  • Status: The last status of the message
  • Status Group: Please select a value from the input help
  • Direction: 1 (Outbound) or 2 (Inbound)
  • Sender port: Partner port (relevant for inbound IDocs)
  • Receiver port: Partner port (relevant for outbound IDocs)
  • Message Type: IDoc Message type, e.g. ORDERS

AIF Messages - XI-runtime

  • Namespace: AIF interface namespace
  • Interface Name: AIF interface name
  • Version: AIF interface version
  • Status: The last status of the message
  • Status Group: Please select a value from the input help
  • Sender namespace: The namespace of the source of the message
  • Sender interface: The interface of the source of the message
  • Sender party: The communication party of the source of the message
  • Sender component: The component of the source of the message
  • Receiver namespace: The namespace of the target of the message
  • Receiver interface: The interface of the target of the message
  • Receiver party: The communication party of the target of the message
  • Receiver component: The component of the target of the message

AIF Messages - qRFC

  • Namespace: AIF interface namespace
  • Interface Name: AIF interface name
  • Version: AIF interface version
  • Status: The last status of the message
  • Status Group: Please select a value from the input help
  • Direction: Choose I (Inbound) or O (Outbound)
  • Queue Name: Name of qRFC Queue
  • RFC Destination: RFC destination name

AIF Messages - tRFC

  • Namespace: AIF interface namespace
  • Interface Name: AIF interface name
  • Version: AIF interface version
  • Status: The last status of the message
  • Status Group: Please select a value from the input help
  • RFC Destination: The name of the RFC destination the tRFC is sent over
  • Function Module: The name on the called function module
  • User: The user in the RFC destination

AIF Messages - WS-runtime

  • Namespace: AIF interface namespace
  • Interface Name: AIF interface name
  • Version: AIF interface version
  • Status: The last status of the message
  • Status Group: Please select a value from the input help
  • Adapter Type: The adapter used for the WS. Please use the input help to select an adapter.
  • Sender Party: Sender Communication party
  • Sender Interface Name: Sender Interface
  • Receiver Party: Receiver Communication party
  • Receiver Interface Name: Receiver Interface 

AIF Messages - XML

  • Namespace: AIF interface namespace
  • Interface Name: AIF interface name
  • Version: AIF interface version
  • Status: The last status of the message
  • Status Group: Please select a value from the input help

AIF Messages - SYNC LOG

  • Namespace: AIF interface namespace
  • Interface Name: AIF interface name
  • Version: AIF interface version
  • Status: The last status of the message
  • Status Group: Please select a value from the input help

The category 'Data Replication' is based on ABAP Application Log and hence some parameters are mandatory.

Data Replication

  • Object (mandatory): The object of the log record (DRF_OUTBOUND)
  • Subobject (mandatory): The sub-object of the log record (Choose from the input help, e.g. CHANGES)
  • External ID: External ID of the Application Log entry
  • Message ID: Message Class
  • Message Number: Message Number
  • Text: Message Text
  • Program: Program triggering the log entry
  • Transaction: Transaction code triggering the log entry
  • User: The user who triggered the log entry