End to End Tracing

(Optional) End to end tracing enables an application developer and end user to trace a request that is sent from the client to the back-end. This spans the entire landscape where you can derive a correlation of traces at the client, server and back-end.

These correlated traces help in performance analysis and are centrally monitored on SAP Solution Manager. These are displayed as reports where you can extract information on failure of delivering a request, time taken for a request to reach a component and so on.

On the client side, the client framework enables an application developer to switch on the trace for messages. The client traces the request at predefined points and all these transactions/requests are recorded in a Business Transaction XML. Additionally, the client maintains a unique identifier in the HTTP header called the SAP Passport that is used to correlate traces across various components. This Business Transaction XML can later be uploaded to the SAP Solution Manager which is a central location to correlate all logging information.

The end to end tracing APIs are available in the SMPClientConnection class. For more information on the significance of different trace levels, see REST SDK API Usage > Rest Client API Reference for Android > PropertyID class.

Syntax

Use the setTraceLevel API to set the trace level in the SAP-PASSPORT and BTX . The trace level can be set to TrcLvl_HIGH, TrcLvl_MEDIUM, TrcLvl_LOW and TrcLvl_NONE.
```
public void setTraceLevel(int level);
```
Use the startTrace API to start end to end tracing on the client.
```
public void startTrace();
```
Use the stopTrace API to stop end to end tracing on the client.
```
public void stopTrace() throws SMPException;
```
Use the uploadTrace API to generate BTX on the client, and upload the BTX to Solution Manager via the Sybase Unwired Platform server.
```
public void uploadTrace() throws SMPException;
```

Examples

Examples – Set trace level

clientConnection.setTraceLevel(PropertyId.TrcLvl_MEDIUM);

Start trace level

clientConnection.startTrace();

Stop trace level

Try{
clientConnection.stopTrace();
}catch(SMPException e){
e.printStrackTrace();
}

Upload trace level

Try{
clientConnection.uploadTrace();
}catch(SMPException e){
e.printStackTrace();
}