Command Line Interface

Gremlin Command line interface allows the user to perform commands directly from the host. The impact of the attack will be localized to that host.

Commands

Attacks

‍

The <span class="code-class-custom">attack</span> command starts a localized Gremlin experiment. Please visit experiments for all experiments and parameters.

# Example of a CPU attack
gremlin attack cpu -l 60 -c 1
Setting up cpu gremlin with guid 'd626a85b-6303-11e9-bdf9-4029fe350366' for 60 seconds on 1 core
Setup successfully completed
Running cpu gremlin with guid 'd626a85b-6303-11e9-bdf9-4029fe350366' for 60 seconds on 1 core
Attack on cpu_1 completed successfully

‍

Attack-container

The <span class="code-class-custom">attack-container</span> command starts an experiment against a locally-hosted Docker container. Please visit experiments for all experiments and parameters.

In order to run <span class="code-class-custom">attack-container</span>, the container must reside on the host and must be specified.

# Example of a Container experiment
gremlin attack-container a1a9ee7eb256 -l 60 -c 1

‍

Check

The <span class="code-class-custom">check</span> command inspects the state of your Gremlin installation. The currently-supported set of checks is: <span class="code-class-custom">api</span>, <span class="code-class-custom">auth</span>, <span class="code-class-custom">docker</span>, <span class="code-class-custom">env</span>, <span class="code-class-custom">files</span>, <span class="code-class-custom">os</span>, <span class="code-class-custom">proxy</span>, <span class="code-class-custom">tags</span>, <span class="code-class-custom">version</span>.

You may run an individual check by passing it as an argument to the <span class="code-class-custom">check</span> command. For example, <span class="code-class-custom">gremlin check proxy</span>. If you leave this off (<span class="code-class-custom">gremlin check</span>), then all checks will be run.

This output is not sent to Gremlin, but it may be helpful to contact Gremlin Support to triage an installation issue.

# Example of running "gremlin check os":
gremlin check os

os
====================================================
OS Name                              : Ubuntu
OS Version                           : 16.04
System Time                          : 1569450673 (2019-09-25 22:31:13)
NTP Time                             : 1569450673 (2019-09-25 22:31:13)

‍

Help

The <span class="code-class-custom">help</span> command list all of the available commands and displays help.

Init

The init commands sets up the agent configuration. A prompt will appear to request a <span class="code-class-custom">Team ID</span> and <span class="code-class-custom">Team Secret</span>.

# Registers agent to control plane using specified Team ID and Team Secret. Gremlind will restart after completion
gremlin init
Please input your Team ID:
9676868b-60d2-5ebe-aa66-b8b3cef23bb9
Please input your Team Secret:

Using 9676868b-60d2-5ebe-aa66-b8b3cef23bb9 for Organization Id
Using 172.31.0.108 for identifier

‍

Please see the table below for optional parameters.

‍

Logout

The <span class="code-class-custom">logout</span> command removes this Gremlin Agent from the Gremlin Control Plane.

Rollback

The <span class="code-class-custom">rollback</span> command interrupts an active experiment. It can also revert the last impact.

gremlin rollback
Rolling back f1c1e96c-630e-11e9-92d3-ad4cfee292e2
Rollback running in PID 28383, attack running in PID 28155, rollback issuing a kill to attack process, which will roll itself back
Reverted 1 attack

‍

Rollback-container

The <span class="code-class-custom">rollback-container</span> command interrupts an active experiment against a local Docker container.

Status

The <span class="code-class-custom">status</span> command will display the status of any experiments.

# Example of gremlin status
gremlin status
        ARGS                 START                END                  GUID
↻       cpu -l 300 -c 1      2019-04-20 01:52:24                       f1c1e96c-630e-11e9-92d3-ad4cfee292e2

‍

To display a specific attack use <span class="code-class-custom">-u</span> followed by the <span class="code-class-custom">GUID</span>.

# Example of status of a specific GUID
gremlin status -u 601e52e7-630f-11e9-bdf9-4029fe350366
601e52e7-630f-11e9-bdf9-4029fe350366 - Successful

Start Time              End Time
2019-04-20 01:55:29     2019-04-20 02:00:30

Args
cpu -l 300 -c 1

‍

Version

The <span class="code-class-custom">version</span> command will state the installed version of Gremlin.

gremlin version
gremlin version 2.10.0