Using Tracing APIs in SUPProxyClient and SDMConnectivity Libraries

One way of enabling end to end tracing is by using supportability-related APIs defined in the SUPProxyClient library.

These APIs are available in the ODPRequest class.

Syntax

Use the setTraceLevel API to set the passport trace level. This API belongs to the SDMRequestBuilder class which is part of the SDMConnectivity library. The trace level can be set to HIGH (3), MEDIUM (2), LOW (1), or NONE.
```
 + (void) setTraceLevel: (Level) value_in 
```
The APIs to enable tracing are available in the ODPRequest class.
- Use the startTrace API to check if end to end tracing is enabled and thereafter start tracing the message.
```
+(void)startTrace;
```
- Use the stopTrace API to disable end to end tracing and thereafter stop tracing the message.
```
+(void)stopTrace;
```
- Use the uploadTraceWithError API to forward the generated business transaction XML to the server.
```
 +(void) uploadTraceWithError:(NSError**) error 
```

Setting a Trace level –

@try{
	[SDMRequestBuilder setTraceLevel:HIGH];
    }
    @catch (NSException *exception) {
        NSLog(@"excption:  %@",[exception description]);

Starting a Trace –

@try{
    [ODPRequest startTrace];
    }
    @catch (NSException *exception) {
       NSLog(@"Exception: %@",[exception description]);

Stopping a Trace –

@try{
    [ODPRequest stopTrace];
    }
    @catch(NSException *exception){
     NSLog(@"Exception: %@",[exception description]);

Uploading a Business Transaction XML –

@try{
     NSError* error = nil;
    [ODPRequest uploadTraceWithError:&error];
    }