Skip to content

About

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

Resources

Code of conduct

Contributing

Stars

27 stars

Watchers

22 watching

Forks

Repository files navigation

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 user@example.com

# 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!

About

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

Resources

Code of conduct

Contributing

Stars

27 stars

Watchers

22 watching

Forks

Releases

Packages

Used by

Contributors

Languages