Skip to main content

CLI (simple command line client) for AWS cloudwatch logs

Project description

nef

simple command line client for aws cloudwatch logs.

in the search for a cloudwatch CLI, you will find several other (3 as of writing this) tools:
https://github.com/jorgebastida/awslogs
https://github.com/winebarrel/cwli
https://github.com/knqyf263/utern

while these tools are great, they all have more features than i needed, and those i've tried are kind of complicated to figure out.

my goal in writing nef was to have a command line tool that lets me view logs and log groups easily and quickly without logging into the aws web console. it amounts to a thin wrapper for the aws cli log command, which simplifies both the input and the output.

see below for installation and usage info. see the project homepage for more info: https://gitlab.com/shindagger/nef

installation

pip install nef

dependencies

  • aws cli
  • python 3.6

flags

positional arguments:
  log            Which log group to view

optional arguments:
  -h, --help     show this help message and exit
  --start START  optional. give a start date and time.
                 format: YYYY-MM-DD HH:MM:SS
                 example: nef /path/to/log-group --start 2019-11-25
                 example 2: nef /path/to/log-group --start "2019-11-25 10:24"
                 example 3: nef /path/to/log-group --start "2019-11-25 10:24:32"
                 default (if arg not given): 2019-11-25 15:26:50
  --end END      optional. define an end date/time.
                 see --start for formatting info
  -c, --columns  show log groups in columns
  -j, --json     display output as json
  -v, --version  show program's version number and exit

usage

$ nef -h

show help message and exit.

$ nef

print out all log groups.

$ nef -c

print log groups in concise columnar format.

$ nef /path/to/log_group

show info (the last 24 hours) of the log group /path/to/log_group

$ nef /path/to/log_group --start 2019-11-25

show logs since the 25th of Nov 2019.

$ nef /path/to/log_group --start "2019-11-25 10:30"

optionally include a time part (be sure to wrap the string in quotes for the space).

Project details


Download files

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

Files for nef, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size nef-0.1.2-py3-none-any.whl (4.9 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size nef-0.1.2.tar.gz (4.5 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page