You can add deployment markers to the Deployments view so that you can easily see when service versions change, and if the change affects performance in any way.

Deployment markers rely on version tags (aka “release tags”) that you add to your service instrumentation. You then register that tag with Lightstep so that it can collect that tag data from your spans. When Lightstep finds a change in that tag’s value, it creates a marker based on the timestamp of the span.

Instrument for Deployment Markers

Add a tag with values to your services that can be used to report version information.

For example, you might create a tag named service.version with values equal to the Git commit hash of the current version.

See the individual language Quick Start topics for instructions on how to create tags.

The Instrumentation Quality Score checks for version tags on your services!

Register the Tag with Lightstep.

Deployment markers are project-specific. You need to register the version tags with all projects that should use them.

  1. Click Settings to open your project’s settings page.
  2. On the Project Settings page, scroll down to Deployment Settings.
  3. Click the + icon. A dropdown shows all tags found in your instrumentation. Select the tag from the list.

The tag now displays as the Version Tag. You can use multiple tags to collect deployment information. As long as they are all registered, Lightstep creates markers when a change in value is detected.