Undercurrent Analytics

Registration and credentials

Registering

Enter your email at undercurrentanalytics.dev/#get-access to request access. We’ll then send you an email with an attached JSON credentials file.

What’s in the credentials file

The file is named undercurrent-analytics-<your name>.json and contains:

  • Project token: Non-secret string that identifies events sent by your app. Used to initialise the client library.
  • Grafana sign-in credentials: Username and password for logging into your Grafana organization at grafana.undercurrentanalytics.dev.
  • Grafana service account token: Grants write access to your Grafana dashboards. Used by an AI harness to create dashboards over the Grafana HTTP API.

It belongs in your app repo, but don’t check it into version control

Everything except the project token is secret. Move the file into your app repo and exclude it from version control:

mv ~/Downloads/undercurrent-analytics-*.json /path/to/your/app/repo
echo 'undercurrent-analytics-*.json' >> .gitignore
git add .gitignore && git commit -m "Ignore Undercurrent Analytics credentials file" .gitignore

You get your own Grafana organization, so you control the credentials within it. You can rotate the Grafana username, password, and service account token from inside Grafana at any time.

← Back to undercurrentanalytics.dev