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).

example

Usage example

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

nef-1.1.0.tar.gz (4.8 kB view details)

Uploaded Source

Built Distribution

nef-1.1.0-py3-none-any.whl (5.3 kB view details)

Uploaded Python 3

File details

Details for the file nef-1.1.0.tar.gz.

File metadata

  • Download URL: nef-1.1.0.tar.gz
  • Upload date:
  • Size: 4.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.4

File hashes

Hashes for nef-1.1.0.tar.gz
Algorithm Hash digest
SHA256 c47fde64d5aad97a1de5f0d163fbb7da7ccfe5d11237b45aab52c870ecc757f2
MD5 df41a2622fe89506a7ccad2a191beecf
BLAKE2b-256 55f8f824c60ebe750d39e711fc5316568b98e9286497487e455c292dd9e7d11e

See more details on using hashes here.

File details

Details for the file nef-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: nef-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 5.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.4

File hashes

Hashes for nef-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 58556edb0cad31915f222a7db5aafd9e4879dbe34daf1a41f64e4b040d106877
MD5 3b56056694a6b4b8394d64d8b6d800b4
BLAKE2b-256 bb5322ae758bd9108277fbf78867105219a910364941f43956c346fe1016e22b

See more details on using hashes here.

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