Home

Cloud ALM Connectivity

Last update: Oct 31, 2025 @ 1:44 pm

Generic selectors
Exact matches only
Search in title
Search in content
Post Type Selectors
page

Related articles:

Overview

Within the SAP system a high volume of events originating from multiple objects and instances are sent. These events will produce requests that result in various statuses, including both successful completions and errors.

To maintain system health visibility, organizations can calculate a key performance metric: the error ratio. This metric represents the proportion of failed requests relative to the total number of requests processed for each corresponding object.

Once calculated, this error rate metric can be transmitted via API to SAP Cloud ALM, where it becomes accessible through the Health Monitoring dashboard. This integration enables proactive monitoring and facilitates timely identification of objects experiencing elevated error rates.

Purpose

To fulfill the monitoring requirements outlined above, the error rate metric is calculated at the object level for a specified time range (measured in minutes from the current time). The system provides flexible calculation options:

  • Instance-level calculation: Compute metrics separately for all objects within one or more specified instances
  • Object-level calculation: Calculate metrics for specific designated objects

Prerequisites

Used API

The API to transmit this metric is the Raw Data Inbound Metrics API (https://help.sap.com/docs/cloud-alm/apis/raw-data-inbound-metrics-api?locale=en-US&version=LATEST ). Each execution transmits a single JSON file containing multiple metrics via the Raw Data API. The JSON structure adheres to the OpenTelemetry format (key-value pairs) as mandated by API requirements.

Authentication and Service Configuration

Authentication Method

The system utilizes OAuth authentication, requiring the following credentials from Cloud ALM:

  • Client ID
  • Client Secret

Service Setup Requirements

A dedicated service must be created and activated for Health Monitoring purposes. This service generates a unique Service ID that is required for all subsequent operations.

Configuration in Cloud ALM

Retrieving Cloud ALM Credentials

All necessary authentication data and configuration parameters for the Cloud ALM platform can be accessed through the following path: Navigation Path:
Administration → Landscape Management → Services & Systems → Configuration → SAP Cloud ALM Service Key (section)

The existing service key file can be downloaded directly from this location and contains all required authentication and configuration information.

Creating and Activating a Service for Health Monitoring

Step 1: Create a New Service

Navigate to:
Administration → Landscape Management → Services & Systems → Add → New Service
Complete the following required fields:

  • Name: Service identifier
  • Description: Service description
  • Deployment Model: Select appropriate model
  • Service Type: Select “Unspecified Cloud Service HTTP” (for third-party services)
  • Role: Assign appropriate role
  • System Number: Specify system number

Step 2: Configure Health Monitoring Scope

  1. Navigate to: Operations → Health Monitoring
  2. Click the Select a Scope button
  3. In the scope selection window:
    • Clear all existing filters
    • Locate and select the service you created
    • Click Apply

Step 3: Activate the Service

  1. Navigate to: Configuration tab
  2. Locate the Services section
  3. Find your service in the list
  4. Toggle the status to ON

Your service is now active for Health Monitoring.

Retrieving the Service ID

To obtain your Service ID:

Navigation Path:
Administration → Landscape Management → Services & Systems

  1. Select your service from the list
  2. Locate the ID field
  3. The value displayed is your Service ID

 

Configuration in SAP System

SAP System Configuration (SPRO)

Cloud ALM configuration must be activated in the designated instances through SPRO customization in Connection and Replication Object Customizing.

Instance Default Values Configuration

Configure the following parameters in the default values of your primary instance:

Default Attribute Default Attribute Value
CALM_INSTANCE CLOUD_ALM
CALM_SERVICEID <service_id>

 

Cloud ALM Instance Creation

Create a new Cloud ALM instance with the RFC destination CLOUD_ALM_METRICS_API and the default values as shown below.

RFC Destinations:

  • CLOUD_ALM_METRICS_API: RFC destination of type G containing the URL endpoint for metric data transmission – use this a the destination in your Cloud ALM instance
  • CLOUD_ALM_METRICS_TOKEN: RFC destination of type G containing the URL endpoint for OAuth token retrieval, which is required for authenticated data transmission

Cloud ALM Instance Default Values

Configure the following parameters in the default values of the CLOUD_ALM instance:

Default Attribute Default Attribute Value
AUTH_TYPE OAUTH
CLIENT_ID <client_id>
TOKEN_DESTINATION CLOUD_ALM_METRICS_TOKEN

 

 

Scroll to Top