OADTracer is an objective c library that facilitates the sending of DTrace events. OADTracer exposes methods for sending NSURLRequest
and NSURLResponse
as JSON strings to DTRace.
One good usage of DTrace is to log the network communicate instead of polluting the Xcode console.
Using DTrace to log network communication has the following benefits:
- Avoids Xcode console pollution with network logs.
- Extremely cheap; probes that are not being listened do not add any performance overhead.
OADTracer exposes three method to send DTrace events.
Using [OADTracer traceRequest:]
, NSURLRequest
are packaged and sent as JSON to oadprobe:::request
probe.
NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:@"https://www.google.com"]];
[[OADTracer instance] traceRequest:request];
Using [OADTracer traceResponse:data:error]
, NSURLResponse
, NSData
and NSError
are group and sent as JSON to oadprobe:::response
probe.
[[OADTracer instance] traceResponse:response data:data error:error];
response, data and error are passed with the callback of [NSURLSession dataTaskWithRequest]
Using [OADTracer traceString:]
, NSString
is sent to oadprobe:::custom
probe.
[[OADTracer instance] traceString:@"Some string"];
To listen to the DTrace command sent, you can either use the dtrace
command, a good explanation on how to do that is here, or you can use dtracer
gem.
dtracer
gem was written to be conveniently used with OADTracer
library. dtracer
provides equivalent commands to register and print the DTrace events sent.
dtracer
provides the following commands:
dtracer curl
Outputs the NSURLRequest
sent with [OADTracer traceRequest:]
as a curl command
dtracer details
Outputs the NSURLRequest
sent with [OADTracer traceRequest:]
as a formatted string. It also accepts multiple flags to customise the printed string. Run dtracer help details
for additional info.
dtracer response
Outputs the event sent with [OADTracer traceResponse:data:error:]
as a formatted string.
dtracer custom
Outputs the string sent with [OADTracer traceString:]
.
Check dtracer page form more info.
To run the example project, clone the repo, and run pod install
from the Example directory first.
OADTracer is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod "OADTracer"
Omar Abdelhafith, [email protected]
OADTracer is available under the MIT license. See the LICENSE file for more info.