Technology Blogs by SAP
Learn how to extend and personalize SAP applications. Follow the SAP technology blog for insights into SAP BTP, ABAP, SAP Analytics Cloud, SAP HANA, and more.
cancel
Showing results for 
Search instead for 
Did you mean: 
Xavier
Product and Topic Expert
Product and Topic Expert
0 Kudos
1,059
In this series of articles, we will focus on the SAP Cloud ALM Raw Data API.

The SAP Cloud ALM raw data API implements the OpenTelemetry protocol to provide access to the observability signals produced by SAP Cloud ALM.

In the previous post we introduced the SAP Cloud ALM Raw Data Metrics API.

In this blog, we will illustrate how to use this API to export and import logs managed by the SAP Cloud ALM Exception monitoring use case.

 

Get System Information


From the Landscape Management SAP Cloud ALM application


Find the system information to identify the system ID as shown below:


 

 

 

Check the list of logs reported for your system


From the Exception Monitoring SAP Cloud ALM application, select the system containing the logs you want to export:

You will find the list of logs reported for your system:


 

 

Export the logs datasets via SAP Cloud ALM raw data logs outbound API


From an HTTP client, access to the following URL:

GET https://{{HOST}}/api/calm-logs/v1/logs?format=protobuf-json&serviceId=99e47386-ebaa-4c8e-bab8-dca096a7dd24&provider=exm.im&limit=2&period=30M

Parameters





























Parameters Value
provider exm.im for exception monitoring
serviceId Set the serviceId of your system
format protobuf-json
limit
period

Check the SAP Business Accelerator HUB for a complete list of parameters.

 

Output


The output payload contains the list of logs in protobuf-json.
{
"resourceLogs": [
{
"resource": {
"attributes": [
{
"key": "service.name",
"value": {
"stringValue": "QM7002"
}
},
{
"key": "sap.service.display_name",
"value": {
"stringValue": "QM7 (QM7002)"
}
},
{
"key": "service.instance.id",
"value": {
"stringValue": "312733191"
}
},
{
"key": "service.namespace",
"value": {
"stringValue": "SAP_S4HANA_OP"
}
},
{
"key": "telemetry.sdk.name",
"value": {
"stringValue": "sap.calm"
}
},
{
"key": "telemetry.sdk.version",
"value": {
"stringValue": "1.0.0"
}
},
{
"key": "telemetry.sdk.language",
"value": {
"stringValue": "java"
}
}
]
},
"scopeLogs": [
{
"scope": {
"name": "default"
},
"logRecords": [
{
"timeUnixNano": "1695654385000000000",
"severityNumber": "SEVERITY_NUMBER_ERROR",
"severityText": "Error",
"body": {
"stringValue": "Logon of user in client 002 failed when starting a step"
},
"attributes": [
{
"key": "sap.exm.category",
"value": {
"stringValue": "ABAP Aborted Job"
}
},
{
"key": "sap.exm.correlationId",
"value": {
"stringValue": "SENTIMENT ASSIGNMENT@17042701"
}
},
{
"key": "Subcategory",
"value": {
"stringValue": "SENTIMENT ASSIGNMENT"
}
}
],
"observedTimeUnixNano": "1695654605862000000"
},

 

 

Import the logs datasets via SAP Cloud ALM raw data logs inbound API


From an HTTP client, access to the following URL:

POST https://{{HOST}}//api/calm-logs/v1/logs?format=protobuf-json&serviceId=6424348e-4a39-41b5-b9d1-26d7cb2c09d1&useCase=exm.im

 

Parameters


Query



















Parameters Value
serviceId Set the serviceId of the target system
format protobuf-json
useCase exm.im to inject the exception in the Integration Monitoring use-case

 

Check the SAP Business Accelerator HUB for a complete list of parameters.

 

Body

Attach the payload exported in the previous operation or any Open Telemetry logs compatible content.

 

Validate the result in SAP Cloud ALM


From the Exception Monitoring SAP Cloud ALM application, check the result in the exception monitoring application by selecting your target system.

You should see the imported logs entries attached to your system.


 

Navigate to the Exceptions view to get the details.


 

 

In the next article, we will look into the SAP Cloud ALM raw data traces API.

 

Thanks for reading.