cloudtail

README

cloudtail

GNU tail-like Implementation for AWS CloudWatch Logs

Head to the releases section to download pre-compiled binaries for Linux (All Distributions), macOS, and Windows.

Only amd64 binaries are provided, easy to add others if requested.

 OPTIONS
  
  -version
        Display version and exit

  -f    Follow the log group (Waits for a non-existant log group to become available)
  -l    list available log groups and exit
  -n int
        Number of lines to dump (default 10)
  -p int
        with -f, terminate after process ID, PID dies (default -1)
  -q    never output metadata for log events
  -s int
        Interval (in seconds) to sleep during a follow (default 3)
  -v    always output metadata for log events

$> cloudtail [OPTIONS] logGroup # accepts substring

Docker

For whatever reason, there is a docker image you can use also.

$> alias ctail='docker run --rm -it tinyzimmer/cloudtail:latest  /cloudtail'
$> ctail --help

AWS Credentials

See the AWS documentation for configuring an SDK client. The order in which cloudtail checks credentials is:

• Shared Credentials File (Linux/macOS: $HOME/.aws/credentials, Windows: $env:HOME\.aws\credentials)
• Environment Credentials
• EC2 IAM Instance Profile (not tested)

Build

$> go get -u github.com/tinyzimmer/cloudtail

TODO

• I know just from how it's written anything over n=50 will behave oddly, shouldn't affect -f
• pid poll can be threaded off probably to be more efficient. I only put it there anyway because original tail has it.
• bytes filters
• stream locking for follow
• date and search filters
• more inline comments
• custom output formats (json, yaml, etc.)
• multitail abilities - display multiple log groups side by side

-r                   keep trying to open a group even if it is
                     non-existant or permissions are denied at first