saw is a multi-purpose tool for AWS CloudWatch Logs
Colorized output that can be formatted in various ways
--expandExplode JSON objects using indenting
--rawStringPrint JSON strings instead of escaping ("\n", ...)
--invertInvert white colors to black for light color schemes
getcommands respectively, toggles display of the timestamp and stream name prefix.
Filter logs using CloudWatch patterns
--filter fooFilter logs for the text "foo"
Watch aggregated interleaved streams across a log group
saw watch productionStream logs from production log group
saw watch production --prefix apiStream logs from production log group with prefix "api"
# Get list of log groups saw groups # Get list of streams for production log group saw streams production
# Watch production log group saw watch production # Watch production log group streams for api saw watch production --prefix api # Watch production log group streams for api and filter for "error" saw watch production --prefix api --filter error
# Get production log group for the last 2 hours saw get production --start -2h # Get production log group for the last 2 hours and filter for "error" saw get production --start -2h --filter error # Get production log group for api between 26th June 2018 and 28th June 2018 saw get production --prefix api --start 2018-06-26 --stop 2018-06-28
By default Saw uses the region and credentials in your default profile. You can override these to your liking using the command line flags:
# Use personal profile saw groups --profile personal # Use us-west-1 region saw groups --region us-west-1
docker run --rm -it -v ~/.aws:$HOME/.aws tbrock/saw
brew tap TylerBrock/saw brew install saw
# Using yay yay saw # Using makepkg git clone https://aur.archlinux.org/saw.git cd saw makepkg -sri
rpm -i <link_to_rpm_you_need_from_releases>
wget <link_to_deb_you_need_from_releases> sudo dpkg -i <the_deb_name>
$GOPATH/binto your path
go install github.com/TylerBrock/[email protected]
cd %GOPATH%/bin saw ...
Alternatively you can hard code these in your shell's init scripts (bashrc, zshrc, etc...):
# Export profile and region that override the default export AWS_PROFILE='work_profile' export AWS_REGION='us-west-1'
From root of repository:
go test -v ./...