Upload Logs from an MDK App

SAP Cloud Platform Mobile Services provides administrators, developers and support staff with extensive logs and traces functionality to troubleshoot application issues. You can control the amount of information that is captured by setting the log level for individual logging components.

In this step, you will enable client log upload policy in SAP Cloud Platform Mobile Services Cockpit for a given MDK app.

1. Login to Mobile Services Cockpit, click com.sap.mdk.demo | Mobile Client Log Upload.

   

2. Check Log Upload option and click Save.

   

   Other policy parameters like Log Level, Delete Uploaded Log After, Maximum Number of Logs and Maximum Log Size currently have no effect.

   You can find more details about Client Log Upload feature.

Logs help you trace events that occur while your application is running. You can create logging actions, set their priority levels and upload stored log entries.

You will create 3 actions:

• Log action of Type SetState: to turn the logger On, Off or Toggle

• Log action of Type SetLevel: to set log level (Debug, Info, Warn or Error)

• Log action of Type Upload: to upload logs from app to Mobile Services

You can find more details about MDK Log Actions.

1. Create a log action of type SetState:

   Right-click the Actions folder | New MDK Action | choose MDK Log Actions in Category | click Log Action | Next.

   

   Provide the below information:

   Property	Value
   Action Name	LogSetState
   Type	SetState
   Log State	On

   

   Click Next and then Finish on the confirmation step.

2. Create a log action of type SetLevel:

   Right-click the Actions folder | New MDK Action | choose MDK Log Actions in Category | click Log Action | Next.

   Provide the below information:

   Property	Value
   Action Name	LogSetLevel
   Type	SetLevel
   Log Level	Debug

   Setting log level to debug is not recommended for productive environment.

   

   Click Next and then Finish on the confirmation step.

3. Create a log action of type Upload:

   Right-click the Actions folder | New MDK Action | choose MDK Log Actions in Category | click Log Action | Next.

   Provide the below information:

   Property	Value
   Action Name	LogUpload
   Type	Upload

   

   Click Next and then Finish on the confirmation step.

1. Double click the LogSetState.action file | expand Common Action Properties and select LogSetLevel.action for Success Action.

   

2. Click Save.

When the metadata is downloaded from App Update, OnDidUpdate event is being called which eventually triggers InitializeOffline.action. You can look at Application.app file for the details.

You will bind LogSetState.action at success of InitializeOffline.action.

1. Navigate to DemoSampleApp | Actions | Service | InitializeOffline.action, scroll-down and expand Common Action Properties section, select LogSetState.action for the Success Action.

   

2. Click Save.

You will define two message actions for displaying success or failure when Log upload action is triggered. Later, you will bind these actions in Common Action Properties of LogUpload.action.

1. You will create a success message action.

   Right-click the Actions folder | New MDK Action | choose MDK Message Actions in Category | click Message Action | Next.

   Provide the below information:

   Property	Value
   Action Name	LogUploadSuccessful
   Type	ToastMessage
   Message	Log File Uploaded
   MaxNumberOfLines	1
   Duration	3
   IsIconHidden	true
   Animated	true

   

   Click Next and then Finish on the confirmation step.

2. Create a failure message action.

   Right-click the Actions folder | New MDK Action | choose MDK Message Actions in Category | click Message Action | Next.

   Provide the below information:

   Property	Value
   Action Name	LogUploadFailure
   Type	Message
   Message	Uploading log file failed
   Title	Log Upload Failed
   OKCaption	OK
   OnOK	--None--
   CancelCaption	leave it blank
   OnCancel	--None--

   

   Click Next and then Finish on the confirmation step.

3. Bind both actions in Common Action Properties of LogUpload.action.

   Double click the LogUpload.action and provide the below information:

   Property	Value
   Success Action	LogUploadSuccessful.action
   Failure Action	LogUploadFailure.action
   Show Activity Indicator	select it
   Activity Indicator Text	Uploading Logs...

   

You will add a toolbar item to the main page called Upload Logs. You will link toolbar item to LogUpload.action you just created in step 2.

1. In Main page, drag and drop an Toolbar Item to the bottom right of the page.

   

2. Replace Caption to Upload Logs.

   

3. In the Properties pane, click the Events tab, click the link icon for the OnPress property to open the object browser.

   Double click the LogUpload.action action and click OK to set it as the OnPress Action.

   

4. Save the changes to the Main.page.

Deploy the updated application to your MDK client.

1. Right-click the DemoSampleApp MDK Application in the project explorer pane and select MDK Deploy and Activate.

   

2. Confirm the destination name and application id match where you want to deploy and click Next.

   

Open SAP Cloud Platform Mobile Services Cockpit, click Mobile Applications | Native/Hybrid | click MDK app | Mobile Client Log Upload | Logs.

You may view log entries directly in Mobile Services Cockpit or download them locally.

You can find more details about Uploading and Viewing Client Logs.

You have successfully uploaded client logs to SAP Cloud Platform Mobile Services and you are now all set to Extend an MDK App with Customer Orders.