Switch branches/tags
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
34 lines (27 sloc) 2.05 KB

awslogs logs [options] [substrings]*

Print log statements from a log group. It will take all arguments and look for a log group containing all of them so you don't have to enter the exact group name, but can just put in a few fragements that uniquely identify a log group. E.g. Instead of having to write /aws/codebuild/msearch-indexer-bulk-build as the full log group name you can use codebuild index bulk to uniquely identify the group. If multiple log groups match it will fail and print the names of the matching groups.

It will use filter-log-events from the awscli to regularly get new log events and print any events that haven't been seen before.

By default the command will watch regularly for new messages and print them to the console. This can be stopped with ctrl-c.

This command is heavily inspired by the great awslogs tool by jorgebastida. The main difference compared to awslogs (apart from being written in bash and not python) is that it supports new log-streams coming in while logs are being watched and some UX improvements like matching log-groups with substrings.


  • -G: Remove the log group name from the output
  • -S: Add the stream name to the log output
  • -p: Set a log stream prefix so only log stream with that prefix are read from
  • -f: Filter log events you want to see. See Filter Patter Syntax
  • -s: Start time to search from. Uses Gnu Date which supports a complex date syntax. Automatically converts to UTC. (e.g. "now", "-5minutes", "-3days", "Monday", "15:30", "2017-01-01T06:30"). The current implementation doesn't allow for whitespace in the dates.
  • -e: End time to search to. Same syntax as start time before. Will disable log watching (implicit -w argument)
  • -t: Print timestamp for log message
  • -i: Print ingestion time for log message
  • -w: Do not watch the log and end after getting the first set of log messages