Install Sprkl

Watch how to install Sprkl in VSCode video here!
Prerequisites
Supported OSs
Mac
Linux
​WSL (for Windows machines). Information about running VSCode in WSL can be found here​
Node v16.10 and up (Java, C#, and Python are partially supported via our Kubernetes Setup).
Install
​
               VSCode
​
​
                 Web 
​
VSCode
Web
Install the Sprkl VSCode Extension directly from VSCode.
Once installed, click on the Sprkl icon on the left panel.
Register and follow the activation instructions.
​Register and follow the activation instructions.
Once activated, the Grafana button will be enabled, and you can navigate to the Sprkl dashboard in Grafana. 
Setup Client
1. Install the Sprkl Client 
The Sprkl Client contains NodeJS libraries installed under $HOME/.sprkl/lib, and the Sprkl CLI installed under $HOME/.sprkl/bin.
npx @sprkl/scripts install --id=$ID
Use the id provided in the vscode window as $ID.
2. Add Sprkl CLI to PATH
To make sprkl binaries executable, we need to add the required binaries to a directory accessible by your PATH.
A. Create symlinks
Create symlinks to a directory known by PATH, in Unix systems (both macOS and Linux), usually /usr/local/bin is a popular choice.
ln -sf $HOME/.sprkl/bin/sprkl /usr/local/bin/sprkl
ln -sf $HOME/.sprkl/bin/sprkl-nodejs /usr/local/bin/sprkl-nodejs
It might require privileges. If so, try to run with sudo:
sudo ln -sf $HOME/.sprkl/bin/sprkl /usr/local/bin/sprkl
sudo ln -sf $HOME/.sprkl/bin/sprkl-nodejs /usr/local/bin/sprkl-nodejs
B. Add directly to $PATH in your shell config
Add the sprkl binaries directory to the PATH environment in your shell config. Usually $HOME/.bashrc for bash, and $HOME/.zshrc for zsh, etc.
export PATH="$PATH:$HOME/.sprkl/bin"
After updating the PATH variable, reload your shell.
3. Activate client
Activate and configure the install Sprkl CLI to work with your registered user. Use the id and the token provided in the VSCode or Web activation page as $ID and $TOKEN
sprkl cloud activate --cloud.token=$TOKEN --cloud.id=$ID
All set. You're done. The dashboard should be empty as Sprkl analyzes code changes. After you make a code change and run Sprkl, the dashboard will be filled with info.
Post installation: VSCode (left), Web (right)
Following that, you can choose between bare metal,  Docker, or running Sprkl with Kubernetes, if you're working with Kubernetes on your development environments. 
Or, start with a sample project.
Check out next: Instrument your code.
Videos
Navigate to instrument your code to get started.

Getting started

Instrument your code

Last modified 6mo ago