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    

Create and Manage Access Tokens

LightStep tracers use access tokens to identify the project the tracer is reporting for. LightStep Satellites need this token to accept and store span data from the tracer. Reports from clients with invalid or deactivated access tokens will be rejected on ingress.

Why Have More than One Access Token

Access tokens tell the LightStep tracer which LightStep project to report to. You may want to create more than one token when you want fine-grained control over the data your services send to LightStep. For example, you can have separate tokens for your clients and backend services. This way, if you have key rotation policies for public services (i.e. web or mobile clients), you can disable only that one and deploy a new token without affecting the other clients' reporting or having to roll out changes in multiple places.

Create an Access Token

You create access tokens for projects from the Project Settings page.

To create an access token:

  1. From the Navigation Bar, click Project Settings.
  1. In the Access Tokens table, click Create New.

A new row in the table is created with a token. By default, tokens are not given a name.

It may take up to 5 minutes for the token to propagate to all active Satellites.

  1. To name the token, click Rename, enter a name, and click Rename Token.

Disable/Enable an Access Token

You can disable access tokens when needed. Disabled tokens can be reactivated.

To disable an access token, in the Access Tokens table, click Disable for the token.

You can view all disabled tokens using the switch at the top of the table.

Reactivate a disabled token by clicking Enable.

It may take up to 5 minutes for the disable/enable signal to propagate to all active Satellites.

Create and Manage 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.