To use the plugin, you need to download and install it, and then register it with your tracer.

See Lightstep’s GitHub for a full example.

Download and install the plugin

The npm packages are available from npm.

From a shell, run the following, using the prompt for either Split.io or LaunchDarkly.

Start tabs

Split

1

$ npm_config_registry=https://npm.pkg.github.com/lightstep npm install @lightstep/opentelemetry-plugin-splitio --save

LaunchDarkly

1

$ npm_config_registry=https://npm.pkg.github.com/lightstep npm install @lightstep/opentelemetry-plugin-launchdarkly-node-server --save

End code tabs

Initialize the plugin

In your OpenTelemetry initialization code, use registerInstrumentation() to load plugins. See the Demo app for a full example.

Start tabs

Split

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

const {
  lightstep, opentelemetry,
} = require('lightstep-opentelemetry-launcher-node');

module.exports = async (serviceName) => {
  const sdk = lightstep.configureOpenTelemetry({
    accessToken: process.env.LS_ACCESS_TOKEN,
    serviceName,
    instrumentations: [
    {
      plugins: {
      '@splitsoftware/splitio': {
        path: 'opentelemetry-plugin-splitio',
        enabled: true,
        },  
      },
    },
    ],
  }),
};

LaunchDarkly

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

const {
  lightstep, opentelemetry,
} = require('lightstep-opentelemetry-launcher-node');

module.exports = async (serviceName) => {
  const sdk = lightstep.configureOpenTelemetry({
    accessToken: process.env.LS_ACCESS_TOKEN,
    serviceName,
    instrumentations: [
    {
      plugins: {
      'launchdarkly-node-server-sdk': {
        path: 'opentelemetry-plugin-launchdarkly-node-server',
        enabled: true,
        },  
      },
    },
    ],
  }),
};

End code tabs

In the next step, you’ll see the trace data generated by the new instrumentation.

What did we learn?

  • Lightstep’s OpenTelemetry plugins automatically instrument your code to send and display feature flag data in Lightstep.