The ephemeral nature of AWS Lambda functions makes them difficult to monitor and debug. Current monitoring services either: (A) Rely on logs generated from AWS Cloudwatch, which offers limited and less granular data than ideal at less than real-time speed, or (B) Retroactively fit monitoring code onto existing Lambda functions, adding additional time, overhead, and expense to the deployment process.
Lassie’s integration with the AWS CLI allows users to follow the traditional process of deploying Lambda functions while instantly viewing performance metrics & visuals in a locally hosted browser window. The free, open-source nature of the tool allows for unlimited customization.
These instructions will get you Lassie's CLI running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
Configuration with AWS-CLI is provided. See CLI Commands below for more documentation.
Install the AWS-CLI
https://docs.aws.amazon.com/cli/latest/userguide/installing.html
Fork and download this repository.
git init https://github.com/aws-lassie/Lassie.git
A step by step series of starting the Lassie CLI to monitor your AWS Lambda functions globally on your terminal.
Go to the directory of the initialized git
npm link
Start Lassie's CLI by typing
lassie
End with an example of getting some data out of the system or using it for a little demo
Configure your AWS Credentials with Lassie. If there is an error in validating it will be displayed. Otherwise, once the configuration is succesful the result will be displayed.
lassie configure
If there is an error in creating the credentials the credentials will still be saved in the path. Credentials should be cleared if they do not work by manually going into the path below.
C:\Users\USERNAME \.aws\
To check linked accounts after configuration.
lassie la
To check listed users after configuration.
lassie user
To create a Lambda function you will be walked through a prompt. If there is an error in creating it will be displayed.
lassie createLambda
To check all current Lambda functions
lassie listLambdas
To delete a Lambda function you need the name of the Lambda function
lassie deleteLambda
Explain what these tests test and why
Give an example
Explain what these tests test and why
Give an example
Add additional notes about how to deploy this on a live system
- Dropwizard - The web framework used
- Maven - Dependency Management
- ROME - Used to generate RSS Feeds
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
We use SemVer for versioning. For the versions available, see the tags on this repository.
See also the list of contributors who participated in this project.
This project is licensed under the Apache License
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
- Hat tip to anyone whose code was used
- Inspiration
- etc