fullstory-cli

fullstory-cli

FullStory CLI is a user analytics CLI that pulls user data from FullStory data export feature.

Features

• Easy to use CLI to pull data from FullStory's data export feature
• Ability to normalize data points based on a config file
• Ability to filter out extraneous data points based on a config file
• Data enrichment to tease out interesting data points
• Ability to export the data to JSON or CSV
• Built in aggregation for interesting data points

Usage

You can use the CLI interactively or by passing command line arguments. To get started, let's install the package: npm i fullstory-cli -g.

Next, we need to create a story.js file in the root of our project. The story.js allows us to configure the CLI with the various options:

• apiKey: This is the API key you get out of FullStory. This is required.
• routes: This is a array of { route: string, page: string } that we can normalize our routes to. The routes table uses path-to-regexp under the hood to allow you to normalize complex URLs to human readable ones.
• transforms: This is a key/value map of properties we can use to transform data attributes.
• blacklists: This is a key/value map of properties that we want to exclude certain values from.

An example story.js might look like:

module.exports = {
  "apiKey": "XXXXXXXXXXXXXXXXXXXXX",
  "blacklists": {
    "Customer": [
      "sandbox",
    ],
    "UserEmailDomain": [
      'bob.com'
    ]
  },
  "transforms": {
    "Customer": (data) => {
      return data.PageUrlOrigin.replace('https://', '')
    }
  },
  "routes": [
    { "route": "/dashboard", "page": "/dashboard" },
    { "route": "/users/:id", "page": "/users/details" },
    { "route": "/users/:id/:tab?", "page": "/users/details" }
  ]
};

Now that everything is configured, we can run our CLI. The CLI can be ran interactively which allows a user to type in values dynamically or via command line arguments.

To run the CLI interactively, you can do sbc or if you want to run it your command line arguments like: sbc --offset=1 --type=JSON --aggregate=true.