LightStep Documentation

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

Get Started    

Project Access Tokens

Access tokens are used by the LightStep tracer client libraries to identify the project the tracer is reporting for. Reports from client libraries to the Satellites must have a valid access token to be accepted and stored in the recall buffer. Reports from clients with invalid or deactivated access tokens will be rejected on ingress.

In order to allow independent, fine-grained control of span report ingress to a project, LightStep allows for multiple access tokens and the ability to disable access tokens dynamically from the web application.

Use case: Client-side reporting

You may want to allocate a separate access token for each mobile and web client you are reporting from. In the case that these access tokens are compromised, you can disable the compromised token and deploy a new token to the client in question without the requirement of rolling out a new token to all other clients and backend services.

Using multiple access tokens

From the Project Settings page, you can create, name/rename, and enable/disable access tokens. It may take up to 5 minutes for the enable/disable signal to propagate to all active Satellites.

Project Access Tokens

Suggested Edits are limited on API Reference Pages

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