LightStep

LightStep Documentation

Welcome to the LightStep developer hub. You'll find comprehensive guides and documentation to help you start working with LightStep as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Tracer Supported Languages, Protocols, and Dependencies

LightStep tracers work with the OpenTracing API to communicate with LightStep Satellites. Each of the language-specific LightStep tracers have their own implementation, and therefore unique configuration.

The following table shows the LightStep supported tracers along with whether they support the HTTP or gRPC transport.

Should I use HTTP or gRPC

A few tracers support both. When both are supported, we recommend using HTTP, as more load balancers and tools are available for HTTP traffic.

Overview of Supported Transports

Tracer
HTTP
gRPC

Android

✔️

✔️

C#

✔️

C++

✔️

Go

✔️

✔️

Java

✔️

✔️

Javascript

✔️

Objective C / Swift

✔️

PHP

✔️

Python

✔️

Ruby

✔️

Tracer Details

Android

Supports: HTTP ✔️gRPC ✔️
Recommended: HTTP
Documentation: here
Note: When picking a com.lightstep.tracer dependency use tracer-okhttp or tracer-grpc.

<dependency>
   <groupId>com.lightstep.tracer</groupId>
   <artifactId>tracer-okhttp</artifactId>
   <version> VERSION </version>
</dependency>

C#

Supports: HTTP ✔️gRPC ❌
Recommended: HTTP
Documentation: here
Note: Choose whether or not to use HTTP or HTTP2 by initializing the tracer with the WithHttp2 option.

C++

Supports: HTTP ❌gRPC ✔️
Recommended: gRPC
Documentation: here
Note: Choose whether or not to use HTTP or HTTP2 by initializing the tracer with the WithHttp2 option.

Go

Supports: HTTP ✔️gRPC ✔️
Recommended: HTTP
Documentation: here
Note: When initializing the tracer, set the UseGRPC and UseHTTP flags in the Options appropriately.

UseGRPC: false
UseHTTP: true

Java

Supports: HTTP ✔️gRPC ✔️
Recommended: HTTP
Documentation: here
Instructions: When picking a com.lightstep.tracer dependency use tracer-okhttp or tracer-grpc. When instantiating the tracer add .withCollectorProtocol("http") to the OptionsBuilder.

<dependency>
   <groupId>com.lightstep.tracer</groupId>
   <artifactId>tracer-okhttp</artifactId>
   <version> VERSION </version>
</dependency>

Javascript

Supports: HTTP ✔️gRPC ❌
Recommended: HTTP
Documentation: here

Objective C / Swift

Supports: HTTP ✔️gRPC ❌
Recommended: HTTP
Documentation: here

PHP

Supports: HTTP ✔️gRPC ❌
Recommended: HTTP
Documentation: here

Python

Supports: HTTP ✔️gRPC ❌
Recommended: HTTP
Documentation: here

Ruby

Supports: HTTP ✔️gRPC ❌
Recommended: HTTP
Documentation: here

Tracer Supported Languages, Protocols, and Dependencies


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.