cloudspotting User Guide
Although cloudspotting is very easy to use, we've written this guide to help you make the most out of it.
The first time you open the application the Settings view appears. There you enter your Amazon Web Services (AWS) security credentials, that's your Access Key ID and your Secret Access Key. Once you click 'Save', cloudspotting will fetch all your EC2 instances, Elastic Block Stores and Elastic Load Balancers across all Amazon's regions. It will also fetch their status and any CloudWatch alarms associated with them. As soon as this process is completed, the map will show you an overview of your items for each region.
If you need to monitor another account or if your credentials change at some time in the future, you can go back to Settings and change your access keys.
You can add a new service using the '+' button. You are then asked for the service's name and forwarded to the service editing view where you can select which items comprise it.
For example, you might be running a web service that makes use of EC2 instances in different regions, multiple volumes and a load balancer. Once you've added all these items to a service, cloudspotting shows you a single status with that name in the services list on the app's main screen.
The services list also includes an 'All Items' entry where you can view all of your AWS items, despite of service assignments.
Different statuses in cloudspotting are represented by different colors. Here's a bit about what each color means:
- Grey indicates that an item is not being monitored. Items not being monitored are EC2 instances that are in a state other than 'running'.
- Green indicates that an item's state is OK.
- Yellow indicates that an item is in warning state.
- Red indicates that an item is in alarm state. This can be for the following reasons:
- A CloudWatch alarm associated with this item is in 'ALARM' state.
- Status checks results are not 'passed' (for EC2 Instances and Elastic Block Stores)
- Health checks results are not 'InService' (for Elastic Load Balancers)
Users have the option to mute the alerts of an item that is in alarm state. Alerts are then still received, but the item's state is changed to warning. As soon as all of an item’s alerts are resolved its state becomes OK.
cloudspotting continuously monitors AWS to update the status of all your items and services.
Tip: You can also pull-to-refresh while you're on the app's main screen.
Every time an alert is received, cloudspotting creates a notice about it. Notices contain more information about the alert, such as its name and a brief description about what happened.
In the Notices list, the user can mute or unmute alerts, or delete them once they are resolved.