Objective-C and Swift Manual Instrumentation

This Quickstart will have you configure your tracer to communicate with the Cloud Observability Microsatellites and create a single span on your service. You install both the Cloud Observability tracer and then use the Cloud Observability API to instrument your code.

While Cloud Observability offers tracers and APIs specific to its tracing software, you will still use the OpenTracing API to fully instrument your code. Be sure you have read and are familiar with both Cloud Observability tracers and the OpenTracing specification in your application’s language.

Objective-C and Swift Instrumentation for OpenTracing

1. Find your access token in Cloud Observability. You’ll need this to configure your Cloud Observability tracer.
   • Click the Project Settings button.
   • In the Access Tokens table, click the Copy icon to copy your access token to the clipboard.

2. Install the Cloud Observability tracer using CocoaPods.

   1
   pod 'lightstep', '~>3.2'
   

3. Run pod install in your project directory. Open the newly created workspace file.

4. In your application, configure the Cloud Observability tracer and register it as the OpenTracing global tracer. As part of the configuration, you need to add your access token.

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   #import "LSTracer.h"
   #import "OTGlobal.h"
   
   - (BOOL)application:(UIApplication *)application
       didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
   
       // Initialize the Cloud Observability tracer implementation
       LSTracer* tracer = [[LSTracer alloc] initWithToken:@"{your_access_token}"];
       [OTGlobal initSharedTracer:tracer];
   
       // <Your normal initialization code here>
   
       return YES;
   }
   

5. Test that everything is connected by sending a test span.

   1
   2
   3
   4
   5
   6
   - (void)someFunction:... {
   
       id<OTSpan> span = [[OTGlobal sharedTracer] startSpan:@"someFunction:"];
       ...
       [span finish];
   }
   

6. Run your app.

7. Open Cloud Observability. You should see your service in the Service directory list.
   .

It may take a few moments for your service to display in the Service Directory. To see data immediately, click the Explorer tab to view data in the histogram.

Read the OpenTracing Objective-C API to learn more.

See also

Measure your instrumentation quality

Updated Mar 2, 2020