This plugin provides an implementation of the Backstage Analytics API for Segment. Once installed and configured, analytics events will be sent to Segment as your users navigate and use your Backstage instance.
This plugin contains no other functionality.
-
Install the plugin package in your Backstage app:
yarn workspace app add @janus-idp/backstage-plugin-analytics-provider-segment
-
Wire up the API implementation to your App in
packages/app/src/apis.ts
:/* highlight-add-start */ import { analyticsApiRef, configApiRef, identityApiRef, } from '@backstage/core-plugin-api'; import { SegmentAnalytics } from '@janus-idp/backstage-plugin-analytics-provider-segment'; /* highlight-add-end */ export const apis: AnyApiFactory[] = [ // Other APIs... // Instantiate and register the GA Analytics API Implementation. /* highlight-add-start */ createApiFactory({ api: analyticsApiRef, deps: { configApi: configApiRef, identityApi: identityApiRef }, factory: ({ configApi, identityApi }) => SegmentAnalytics.fromConfig(configApi, identityApi), }), /* highlight-add-end */ ];
-
Configure the plugin in your
app-config.yaml
:
The following is the minimum configuration required to start sending analytics events to Segment. All that's needed is your Segment Write Key
app:
analytics:
segment:
# highlight-start
writeKey: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
maskIP: true # prevents IP addresses from being sent if true
# highlight-end
In pre-production environments, you may wish to set additional configurations to turn off reporting to Analytics. You can do so like this:
app:
analytics:
segment:
# highlight-next-line
testMode: true # prevents data from being sent if true
You might commonly set the above in an app-config.local.yaml
file, which is
normally gitignore
'd but loaded and merged in when Backstage is bootstrapped.