Skip to main content

Get your logs from Logentries on the comandline

Project description

https://img.shields.io/pypi/v/loentries-clis.svg

Unmaintained: I’m no longer maintaining this package because I am no longer using Logentries. If you want to continue its maintenance please contact me.


Stream your logs from Logentries on the commandline. Provides the logentries command which makes it easy to call their Download API and pipe it around.

Setting up

  1. Install it:

    $ pip install logentries-cli
  2. Find your Logentries account key. At time of writing, this can be found at Accounts->Profile and appears when you press the “Show” button:

    https://raw.github.com/adamchainz/logentries-cli/master/account-key.png
  3. (Optional) store your account key in the environment variable LOGENTRIES_ACCOUNT_KEY. You could set this up in e.g. your bashrc. Your other option is to always pass it to logentries with --account-key.

  4. Filter your logs! Run with the syntax:

    $ logentries <logset> <logname> [-f filter] [-s start] [-e end]

    Verbose help for the options is provided with logentries -h.

Examples

$ logentries web nginx

With only the required arguments (logset and log) filled in, the last 20 minutes of messages from that log are downloaded. They are streamed so they play nicely with other commandline utilities.

$ logentries web nginx -f code=500

Passing a Logentries filter means that fewer messages are downloaded and you can analyze faster.

$ logentries web nginx -f 'code=500' -s '1am' -e '5 minutes ago'

A wide variety of date/time formats are supported for specifying the start and end of the time period to fetch messages for, thanks to the awesome parsedatetime and dateutil.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

logentries-cli-1.2.1.tar.gz (16.8 kB view hashes)

Uploaded Source

Built Distribution

logentries_cli-1.2.1-py2.py3-none-any.whl (16.6 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page