https://github.com/brennerm/aws-top

CLI dashboard for AWS services
https://github.com/brennerm/aws-top

aws tui

Last synced: 4 months ago
JSON representation

CLI dashboard for AWS services

• Host: GitHub
• URL: https://github.com/brennerm/aws-top
• Owner: brennerm
• License: mit
• Created: 2018-06-30T15:26:32.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2018-07-24T19:32:17.000Z (almost 8 years ago)
• Last Synced: 2025-09-30T04:02:08.153Z (9 months ago)
• Topics: aws, tui
• Language: Python
• Size: 247 KB
• Stars: 3
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
### aws-top is in an very early stage. You'll experience bugs and miss a lot of features. Feel free to open issues anyway.

aws-top is a CLI dashboard for a variety of AWS services.

![EC2 view](img/ec2.png)

Currently supported services:

- EC2

- Lambda

- S3

## Installation

1.

```commandline

$ pip install aws-top

```

2.

```commandline

$ git clone https://github.com/brennerm/aws-top && cd aws-top

$ python setup.py install

```

## Usage

### Authentication

Refer to the [boto3 configuration](https://boto3.readthedocs.io/en/latest/guide/configuration.html#credentials) to see all options to provide AWS credentials.

In general these should be preferred. Alternatively you can use the command line parameters that are listed below.

```commandline

$ aws-top -h

usage: awstop [-h] [-a ACCESS_KEY] [-s SECRET_KEY] [-S SESSION_TOKEN]

                 [-r REGION]

optional arguments:

  -h, --help            show this help message and exit

  -a ACCESS_KEY, --access-key ACCESS_KEY

  -s SECRET_KEY, --secret-key SECRET_KEY

  -S SESSION_TOKEN, --session-token SESSION_TOKEN

  -r REGION, --region REGION

```

### Execution

```commandline

$ aws configure # can be skipped if already configured

$ aws-top

```