Squirro Widget CLI Reference#

The squirro_widget command line tool, part of the Squirro Toolbox, is used to manage custom widgets on a Squirro cluster.

You can use the Squirro asset tool to upload and list custom widgets consistently with other types of custom code “assets”.

Basic Usage#

The squirro_widget command is used on the command line. It takes many connection options first (--cluster and --token), followed by a command (list in the example below) and depending on the command additional options after it.

squirro_widget \
    --token SQUIRRO_TOKEN \
    --cluster https://next.squirro.net  \
    list

Arguments#

The following table lists all the arguments.

Argument

Mandatory

Description

General Options

-h

Show a help message and exit.

–version

Output the tool version and exit.

–verbose, -v

Increase log verbosity.

  • Not specified: the tool outputs all warnings and errors.

  • Specified once or more: informational messages are also output.

  • Specified twice or more: debugging messages are shown.

      • Specified three times or more: more information is included in all messages.

–log-file

Path to a log file on disk, where the log output is to be stored. If this is not specified, the log messages are shown on the console.

Connection Options

–token TOKEN -t TOKEN

Yes

The Authenticating Token with which to authenticate. If the token value starts with a dash, you need to use an equal sign to specify the value like this: --token="-12345…"

–cluster URL
-c URL

The Squirro cluster into which to load the widget.

Commands#

The command is given as an argument after all the previous options. There are two supported commands:

  • list: Lists all the custom widgets that have been configured on the server.

  • upload: Uploads a new or modified custom widget.

List#

This command lists all the custom widgets that have been configured on the server.

The list command does not take any additional options beyond the default arguments.

An example:

squirro_widget \
    --token SQUIRRO_TOKEN \
    --cluster https://next.squirro.net  \
    list

Upload#

The upload command uploads a custom widget from the local disk and uploads it to the Squirro cluster. This command takes additional options beyond the default arguments.

Argument

Mandatory

Description

–config

Yes

A JSON representation of the configuration for the widget. The following keys are possible:

Key

Description

directory

The local directory in which the widget is stored - relative to the current working directory. The directory is also used to determine the widget name. That name is used for deduplication, any older widgets with the same name are overwritten.

title

The name of the widget. This is the name shown to users when they add the widget to a dashboard.

baseWidget

The name of the base widget from which this one inherits. This drives the configuration options that are displayed to the user when adding the widget to a dashboard.

author

The author of the widget

description

A short description of why the widget is needed or what it does

An example:

squirro_widget \
    --cluster https://next.squirro.net \
    --token $TOKEN \
    upload \
    --config '{"directory": "clock", "title": "Clock", "baseWidget": "Base", "author": "Developer Name", "description": "Displays a clock"}'