@kenjimiyao/aws-logs-tailer

A CLI tool to easily tail AWS CloudWatch Logs with interactive log group selection.

Features

• Interactive log group selection from all available CloudWatch Log Groups
• Support for AWS profiles with --profile option
• Real-time log tailing using AWS CLI's native tail --follow functionality
• Alphabetically sorted log group list for easy navigation

Prerequisites

• Node.js (v20.x or later)
• AWS CLI installed and configured
• AWS credentials with CloudWatch Logs permissions

Installation

npm install -g @kenjimiyao/aws-logs-tailer

Usage

Basic usage

tail-aws-logs

This will:

1. Fetch all available CloudWatch Log Groups from your AWS account
2. Display an interactive list for you to select from
3. Start tailing the selected log group

Using a specific AWS profile

tail-aws-logs --profile myprofile

Required AWS Permissions

The following IAM permissions are required:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "logs:DescribeLogGroups",
        "logs:FilterLogEvents"
      ],
      "Resource": "*"
    }
  ]
}

License

MIT

Author

kenjimiyao