Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/everythingme/redshift_console
Redshift Ops Console
https://github.com/everythingme/redshift_console
Last synced: 4 days ago
JSON representation
Redshift Ops Console
- Host: GitHub
- URL: https://github.com/everythingme/redshift_console
- Owner: EverythingMe
- License: apache-2.0
- Created: 2015-04-06T11:17:16.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2015-10-26T06:14:16.000Z (about 9 years ago)
- Last Synced: 2024-11-08T17:15:49.639Z (4 days ago)
- Language: JavaScript
- Size: 1.11 MB
- Stars: 93
- Watchers: 13
- Forks: 22
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Redshift Console
_Redshift Console_'s goal is to be the tool to monitor and manage a Redshift cluster. The first release has basic tools to monitor running queries, WLM queue and your tables/schemas.
After over a year of managing our Redshift cluster with a collection of scripts and queries, we decided to bundle this into a more user friendly tool that can be used by a wider audience. This project also aims to uncover all the useful information hidden in [Redshift's Developer Guide](http://docs.aws.amazon.com/redshift/latest/dg/) (such as the [table design status](http://docs.aws.amazon.com/redshift/latest/dg/c_analyzing-table-design.html) query).
### Features
* Inflight queries view with option to cancel any query and view related alerts (when available; from [STL_ALERT_EVENT_LOG](http://docs.aws.amazon.com/redshift/latest/dg/r_STL_ALERT_EVENT_LOG.html)).
* WLM queue view.
* Schemas view with additional information for each table including: total size (rows/MB), unsorted area size, is the table properly distributed and more.
* Load errors (aggregated view) from the past 24h, based on [STL_LOAD_ERRORS](http://docs.aws.amazon.com/redshift/latest/dg/r_STL_LOAD_ERRORS.html)
### Roadmap
This project is safe for usage, but still in its early stage (version 0.1). Future versions will include:
* Loads - Progress of current operations and history of recent ones.
* Vacuum status.
* SNS/CloudWatch integration to show metrics and events from AWS' console.
* Proactive notifications re. important events in the system: long running queries, problems, changes to the schema, dangerous levels of unsorted areas and more.
We are always happy to receive feedback and suggestions, especially if they are accompanied by a pull request.
## Usage
You can either use the PyPI package or the docker image.
#### PyPI
1. The easiest way to install the project is from pypi:
```bash
$ pip install redshift-console
```
2. Settings are set from environment variables. The main setting to set is the connection string to your Redshift cluster: (make sure the user has sufficient permissions)
```bash
$ export REDSHIFT_CONNECTION_STRING='user= password= host= port= dbname='
```
3. Start the server:
```bash
$ redshift-console runserver
Starting server on port 5000 (debug mode: False).
```
#### Docker
```bash
$ docker run -e REDSHIFT_CONNECTION_STRING="user= password= host= port=5439 dbname=" -p 5000:5000 everythingme/redshift_console
Starting server on port 5000 (debug mode: False).
```
## Authors
[Arik Fraimovich](http://github.com/arikfr) and [Oren Itamar](http://github.com/orenitamar).