Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Sumo Logic Live Tail Command Line Interface (CLI)

Join the chat at

The Live Tail Command Line Interface (CLI) is a standalone application that allows you to start and use a Live Tail session from the command line, similar to tail -f. The output is directed to stdout - so you can pipe the output to commands (grep, awk etc)

This feature is documented here.


Platform specific binaries are provided for CLI.

Simply extract the archive and place the binaries to a location where you have read/write access.


Like SumoLogic, the Live Tail CLI enables you to tail logs in real time by specifying a filter. It uses accessId and accessKeys that are used with the SumoLogic API for authentication. You could either provide the credentials each time using -i and -k command line options, or enter them once when prompted and they would be saved locally in config.json file in the same directory as the CLI.

The first time you run the CLI, the tool will prompt you to choose your deployment. See Help for the correct endpoint.

Command Line Options

usage: livetail [-h] [-i ACCESSID] [-k ACCESSKEY] [-v] [-c] [filter]

positional arguments:
  filter         Live Tail filter

optional arguments:
  -h, --help     show this help message and exit
  -i ACCESSID    Access ID
  -k ACCESSKEY   Acccess Key
  -v, --version  show program's version number and exit
  -c             clear Live Tail


Tail all logs from a given Source Host.

./livetail “_sourceHost = localhost”

Tail logs from a sourceCategory, grep for a pattern, write it to a file

./livetail “_sourceCategory = service” | grep -i “rate limit exceeded” > out.txt

Happy Tailing!