{"id":26267724,"url":"https://github.com/oslabs-beta/lumos","last_synced_at":"2025-07-14T03:05:50.918Z","repository":{"id":51674364,"uuid":"519360436","full_name":"oslabs-beta/Lumos","owner":"oslabs-beta","description":"Lumos is an AWS Lambda visualizer and open source alternative to AWS CloudWatch.","archived":false,"fork":false,"pushed_at":"2023-05-31T21:37:54.000Z","size":1990,"stargazers_count":34,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-30T19:11:28.463Z","etag":null,"topics":["aws","aws-lambda","lambda","serverless"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oslabs-beta.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"open-source-labs","custom":["https://donorbox.org/donations-to-oslabs-inc"]}},"created_at":"2022-07-29T22:06:40.000Z","updated_at":"2024-10-03T01:49:49.000Z","dependencies_parsed_at":"2025-04-30T19:11:25.629Z","dependency_job_id":"343e4d2a-da56-4ddc-9a08-8a41095a0247","html_url":"https://github.com/oslabs-beta/Lumos","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/oslabs-beta/Lumos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oslabs-beta%2FLumos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oslabs-beta%2FLumos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oslabs-beta%2FLumos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oslabs-beta%2FLumos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oslabs-beta","download_url":"https://codeload.github.com/oslabs-beta/Lumos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oslabs-beta%2FLumos/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265236734,"owners_count":23732494,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","aws-lambda","lambda","serverless"],"created_at":"2025-03-14T04:17:58.312Z","updated_at":"2025-07-14T03:05:50.866Z","avatar_url":"https://github.com/oslabs-beta.png","language":"JavaScript","funding_links":["https://github.com/sponsors/open-source-labs","https://donorbox.org/donations-to-oslabs-inc"],"categories":[],"sub_categories":[],"readme":"\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n    \u003cimg src='./client/assets/Lumos_Logo.png' width=\"600px\" align=\"center\" alt=\"Lumos Logo\" \u003e\n    \u003ch1\u003eLumos Lambda Metrics Visualizer\u003c/h1\u003e\n\u003c/div\u003e\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003cdetails open=\"open\"\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\u003ca href=\"#about-lumos\"\u003eAbout Lumos\u003c/a\u003e\u003c/li\u003e \n    \u003cli\u003e\u003ca href=\"#technologies-used\"\u003eTechologies Used\u003c/a\u003e\u003c/li\u003e      \n    \u003cli\u003e\u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\u003c/li\u003e      \n    \u003cli\u003e\u003ca href=\"#key-lambda-metrics\"\u003eKey Lambda Metrics\u003c/a\u003e\u003c/li\u003e   \n    \u003cli\u003e\u003ca href=\"#how-to-contribute\"\u003eHow to Contribute\u003c/a\u003e\u003c/li\u003e     \n    \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contributors\"\u003eContributors\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\u003c!-- ABOUT --\u003e\n\n## About Lumos\n\nServerless architecture is an integral benefit of cloud computing which allows developers to build and run services without having to manage the underlying infrastructure. Amazon Web Services' (AWS) Lambda is the dominant service in the serverless market and is relied upon by the world's largest companies due to its cost-effective, event-driven service that runs code in response to events and automatically manages the computing resources required by that code.\n\nOne drawback to using AWS's services is that navigating the AWS console can be quite challenging. Additionally, lack of descriptive documentation pertaining to AWS's Lambda service makes it difficult to visualize key function metrics at a glance. To solve this, we built Lumos, a free and open-source AWS lambda monitoring tool that allows users to connect their AWS account to track and visualize their key lambda metrics on a visually appealing UI.\n\n## Technologies Used\n\n- [React](https://reactjs.org/)\n- [Material-UI](https://material-ui.com)\n- [Chart.js](https://www.chartjs.org/)\n- [AWS Lambda](https://aws.amazon.com/lambda/)\n- [AWS SDK](https://aws.amazon.com/sdk-for-javascript/)\n- [AWS STS](https://docs.aws.amazon.com/STS/latest/APIReference/welcome.html)\n- [AWS CloudWatch](https://aws.amazon.com/cloudwatch/)\n- [Node](https://nodejs.org/en/)\n- [Express](https://expressjs.com)\n- [PostgreSQL](https://postgresql.org)\n- [Webpack](https://webpack.js.org/)\n- [Bcrypt](https://www.npmjs.com/package/bcrypt)\n- [JSON Web Token](https://jwt.io/)\n\n\u003c!-- GETTING STARTED --\u003e\n\n## Getting Started\n\nLumos requires access keys to sign programmatic requests to the AWS SDK. It is best practice to create an IAM user with permanent long-term credentials to interact with AWS services directly.\n\n1. In your AWS console, create an new IAM user. Make sure to check off \"Access key - Programmatic access\" when selecting an AWS credential type. Save these keys in a secure location. **_They cannot be retrieved after you've completed your IAM setup!_** If you lose your key, you will have to delete the access key and create a new one.\n\n- \u003cimg src='./client/assets/README/iamadduser.png'/\u003e\n\n2. Attach two existing policies directly to your IAM user's security policy:\n\n- \u003cimg src='./client/assets/README/iampermissions.png'/\u003e\n\n3. [Download and install the AWS CLI.](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)\n\n4. From your terminal, access the AWS CLI by typing in\n   `aws configure`. Follow the steps on your screen and input your access key ID and secret access key.\n\n\u003c!-- EXPLAINING KEY LAMBDA METRICS FOCUSED ON --\u003e\n\n## Key Lambda Metrics\n\nThe key lambda metrics we found to be of most interest to users were invocations, durations, and errors. One can visualize their lambda functions metrics across three different time periods: 24 hours, 1 week, or 1 month. Users can visualize their insights through two charts: donut and line. A donut chart will give an overview of all active invocations relating to the functions. The line chart will give a visualization of the number of times each lambda function has been invoked across selected time periods. Lumos also approximates the total cost of a user's lambda functions based on the function's duration and memory usage.\n\n\u003c!-- CONTRIBUTING --\u003e\n\n## How to Contribute\n\nAt Lumos, we open-sourced the project with the intention of having amazing people iterate on our project.\n\nIf you have any suggestions on how to improve Lumos, please follow the steps below:\n\n1. Fork Lumos\n2. Create your Feature Branch (`git checkout -b feature/YourFeature`)\n3. Add your changes using (`git add .`)\n4. Commit your Changes (`git commit -m 'Add Your Feature'`)\n5. Push to the Branch (`git push origin feature/YourFeature`)\n6. Open a Pull Request\n7. Hit the star button!!\n\nThank you and we truly appreciate all your contributions!\n\n\u003c!-- LICENSE --\u003e\n\n## License\n\nDistributed under the MIT License.\n\n\u003c!-- CONTACT --\u003e\n\n## Contributors\n\n- Adithya Chandrashekar [Github](https://github.com/addychandrashekar) | [Linkedin](https://www.linkedin.com/in/addyc/)\n- Adnan Pervez [Github](https://github.com/apervez) | [Linkedin](https://www.linkedin.com/in/adnan-pervez)\n- Carmen Hu [Github](https://github.com/BadWithNames) | [Linkedin](https://www.linkedin.com/in/hu-carmen)\n- Mario Arraya [Github](https://github.com/marioarraya) | [Linkedin](https://www.linkedin.com/in/mario-arraya/)\n- Michael Negron [Github](https://github.com/InternalShadow) | [Linkedin](https://www.linkedin.com/in/MichaelVNegron)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foslabs-beta%2Flumos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foslabs-beta%2Flumos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foslabs-beta%2Flumos/lists"}