Skip to content

Latest commit

 

History

History
157 lines (115 loc) · 9.77 KB

README.md

File metadata and controls

157 lines (115 loc) · 9.77 KB

LogDNA CLI

All Contributors

The LogDNA CLI allows you to sign up for a new account and tail your logs right from the command line.

Deprecation Notice: LogDNA CLI deprecates supporting CentOS 6 and Debian 8 as of v2.

Getting Started

macOS

Download the LogDNA CLI installer for Mac.

Alternatively install via brew cask:

brew cask update
brew install --cask logdna-cli

Windows

To install on Windows, using chocolatey:

choco install logdna

Linux

For Ubuntu/Debian:

sudo wget -qO /tmp/logdna-cli.deb http://repo.logdna.com/linux/logdna-cli.deb && sudo dpkg -i /tmp/logdna-cli.deb

For RHEL/CentOS:

sudo wget -qO /tmp/logdna-cli.rpm http://repo.logdna.com/linux/logdna-cli.rpm && sudo rpm -ivh /tmp/logdna-cli.rpm

From Source

Follow these quick instructions to run the LogDNA CLI from source:

git clone https://github.com/logdna/logdna-cli.git
cd logdna-cli
npm install --production

# help
node index.js --help

# login using one of commands below
node index.js login
node index.js ssologin

Usage

Command Description
logdna register [email] This command is no longer functional. Please use https://www.mezmo.com/sign-up-today to register
logdna ssologin Log in to a LogDNA via single sign-on
logdna login [email] Log in to LogDNA
logdna tail [options] [query] Live tail with optional filtering. Options include -h, -a, -l, -t to filter by hosts, apps, levels or tags respectively. Run logdna tail --help to learn more.
logdna switch If your login has access to more than one account, this command allows you to switch between them
logdna search [options] [query] Basic search with optional filtering. Run logdna search --help for options.
logdna info Show current logged in user info
logdna update Update the CLI to the latest version

Examples

# Login
$ logdna login [email protected]

# Tail
$ logdna tail '("timed out" OR "connection refused") -request'
$ logdna tail -a access.log 500
$ logdna tail -l error,warn

# Search
$ logdna search "logdna cli" -a logdna.log -t tag1,tag2 -n 300
# Search via UNIX timestamps
$ logdna search "logdna" --from 1541100040931 --to 1541102940000
# Search via Natural Language (Chrono)
# Ensure to enclose natural langauge strings in ""
# Must include date reference (i.e., `May 26`, `yesterday`, or the like)
$ logdna search "logdna" --from "yesterday at 3pm" --to "today at 3:05pm"
$ logdna search "logdna" --timeframe "May 26 at 3pm to 3:05pm"
# Search with dev logs
$ logdna search "logdna" --timeframe "May 28 at 1pm to 3:05pm" -d

# Other
$ logdna info
$ logdna update

# Switch organization
$ logdna switch

> 1: ACME (active)
> 2: Strickland Propane
> Choose account [1-2]:

Developer Logs

Logs for troubleshooting during development are included. These logs will pipe to console and optionally to LogDNA.

Switch dev logs on via the -d or --dev flag.

In order to pipe the developer logs to LogDNA, you should set the account API Key using LOGDNA_API_KEY environment variable. Otherwise, dev logs will only been seen in the console.

Currently the dev log coverage is limited to the code regarding --timeframe, --from and --to in index.js.

Contributing

Contributions are always welcome. See the contributing guide to learn how you can help.

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Amir Abushareb

💻 📖

Braxton

💻 📖

Calvin Cochran

💻 📖

Ernest Iliiasov

💻 📖

Jacob Hull

💻 📖

Jonathan Stucklen

💻 📖

Lee Liu

💻 📖 ⚠️

Mike Hu

📖

Muaz Siddiqui

💻 📖

Ryan

💻 📖

Samir Musali

💻 📖 ⚠️

Steven Edouard

💻 📖

Yash Shah

💻 📖

vilyapilya

💻 📖

This project follows the all-contributors specification. Contributions of any kind welcome!