analytics-module-ga-dynamic

This is a wrapper for the backstage analytics-module-ga plugin created to be dynamically loaded in the Red Hat Developer Hub.

The dynamic plugins mechanism introduced by Red Hat Developer Hub (Enterprise version of the janus-idp.io project) is documented here.

Loading this dynamic plugin into your RHDH instance

Add the following entry under the global.plugins inside the RHDH Helm Chart values yaml and upgrade the chart.

#...
    - disabled: false
      package: '@rafaeltuelho/backstage-plugin-analytics-module-ga-dynamic'
      integrity: >-
          sha512-m3JwgnM++iSizKcA0GLHB1F52PU89kIeM4+AQLXUUd0zQ8tv1ER5y9nlgEqdizKa+5Q7drOFtj4fP4goN6Hz5Q==
#...

After adding the above entry in the RHDH helm chart values, you should be able to check if the plugin has been loaded properly by inspecting the install-dynamic-plugins container's log output. You should see something like:

======= Installing dynamic plugin @rafaeltuelho/backstage-plugin-analytics-module-ga-dynamic
==> Grabbing package archive through `npm pack`
==> Verifying package integrity
==> Removing previous plugin directory /dynamic-plugins-root/rafaeltuelho-backstage-plugin-analytics-module-ga-dynamic-0.1.0
==> Extracting package archive /dynamic-plugins-root/rafaeltuelho-backstage-plugin-analytics-module-ga-dynamic-0.1.0.tgz
Skipping directory entry package
Skipping directory entry package/dist
Skipping directory entry package/dist-scalprum
Skipping directory entry package/src
Skipping directory entry package/dist-scalprum/static
==> Removing package archive /dynamic-plugins-root/rafaeltuelho-backstage-plugin-analytics-module-ga-dynamic-0.1.0.tgz
==> Successfully installed dynamic plugin @rafaeltuelho/backstage-plugin-analytics-module-ga-dynamic

Minimal config

To configure the plugin to start sending data to GA add the following snippet in your RHDH app-config Config Map

app:
  analytics:
    ga:
      debug: true
      trackingId: 'UA-99999999-9'

For additional config consult the [upstream plugin readme file](backstage analytics-module-ga

NOTE: the backstage upstream plugin uses an old implementation of the Google Analytics JS library whci does not work with the new GA4 gtag.js