https://github.com/oslabs-beta/anago
Anago is an open-source tool for monitoring Kubernetes cluster health throughout the software development lifecycle.
https://github.com/oslabs-beta/anago
amazon-web-services chartjs devops eksctl kubectl kubernetes prometheus react react-router typescript
Last synced: 28 days ago
JSON representation
Anago is an open-source tool for monitoring Kubernetes cluster health throughout the software development lifecycle.
- Host: GitHub
- URL: https://github.com/oslabs-beta/anago
- Owner: oslabs-beta
- License: mit
- Created: 2023-07-28T16:30:42.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-19T20:57:45.000Z (over 1 year ago)
- Last Synced: 2025-04-08T10:53:12.513Z (about 2 months ago)
- Topics: amazon-web-services, chartjs, devops, eksctl, kubectl, kubernetes, prometheus, react, react-router, typescript
- Language: TypeScript
- Homepage: https://www.anago.dev
- Size: 38.9 MB
- Stars: 43
- Watchers: 2
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Anago
Anago is a tool to help developers monitor and visualize their Kubernetes clusters. Team Anago is equipped for monitoring Kubernetes clusters hosted both on local servers and on cloud-based platforms. Anago provides out-of-the-box support for Prometheus and Prometheus’ Alertmanager for scraping metrics and alerts and integrates with Chart.JS for the dashboard graphs.
The name Anago, originates from Greek, meaning to lead to a higher place, to uplift, and to take to sea. In this spirit, Anago serves as a perfect compass to help you manage your containerized application deployments on the Kubernetes platform.
Let’s dive into how the features of Anago’s platform can simplify and streamline managing your Kubernetes clusters.
[](https://kubernetes.io/) [](https://www.docker.com/) [](https://aws.amazon.com/) [](https://prometheus.io/) [](https://www.chartjs.org/) [](https://helm.sh/) [](https://vitejs.dev/) [](https://vitest.dev/) [](https://www.npmjs.com/package/ts-node) [](https://www.typescriptlang.org/) [](https://developer.mozilla.org/en-US/docs/Web/JavaScript) [](https://react.dev/) [](https://reactrouter.com/en/main) [](https://expressjs.com/) [](https://nodejs.org/en) [](https://developer.mozilla.org/en-US/docs/Glossary/HTML5) [](https://www.npmjs.com/) [](https://eslint.org/)
## Table of Contents
1. [Anago](#Anago)
2. [Features](#features)
3. [Getting Started with Anago](#Getting-Started-with-Anago)
4. [Contributing](#Contributing)
5. [Progress](#Progress)
6. [Scripts](#Scripts)
7. [Our Team](#our-team)
8. [License](#license)
## Features
Anago is a Kubernetes cluster monitoring and visualization tool providing relevant, richly detailed insights into the health of your application deployments with the following useful features:
1. **Real-time Data Monitoring**: Anago seamlessly integrates with your cloud-based and/or locally hosted Kubernetes clusters to allow for a real-time analysis of cluster performance.
2. **Customizable Metrics**: Anago harnesses the power of Prometheus to scrape time-series data from your Kubernetes clusters. We offer customized query-building to configure your dashboard to display cluster metrics and data insights relevant to you. We provide the tools for your cluster management, and you decide which direction you want to take them.
3. **Alerts**: Anago displays relevant real-time alerts relating to cluster health concerns, allowing you to address issues with your deployments proactively to combat downtime in production.
4. **Horizontal Pod Autoscaler Monitoring**: Anago allows you to monitor actively deployed Horizontal Pod Autoscalers in real time or connect to your test application to see isolated test results before the rollout of new features or deployment configurations. Anago stores logs of notable historical timestamps for you to reference to not miss meaningful warning signs and/or longer-term trends, diminishing the abstraction of your HPA usage by providing insights into areas lacking efficiency alongside any bottlenecks that can slow your deployed applications and also drive up the cost of your clusters astronomically. Anago will act as an additional set of eyes and devise tailored recommendations on how to optimize your current HPA configurations.
5. **Cluster Visualization**: Anago provides flexible and detailed visualization of your Kubernetes clusters on our ClusterView dashboard. See your clusters in their entirety with all of their nested components, or filter to display specific clusters, nodes, and namespaces that are relevant to your needs. ClusterView provides extremely detailed insights into each component in your cluster with real-time data from Prometheus and the Kubernetes API. Alerts are displayed visually so you can see which parts of your cluster require your attention.
6. **Platform-agnostic**: Anago supports clusters hosted on cloud-computing platforms and local servers. We are flexible and adaptable for your scale and configuration needs and provide tools to help you integrate your clusters with our technology seamlessly. Anago is for everyone.
## Getting Started with Anago
Let’s walk through how to get your cluster [setup with Anago](/SetupREADME.md)
## Contributing
Contributions are part of the foundation of the Open Source Community. They create a space for developers to share, collaborate, learn, and inspire! Any contributions you choose to make are greatly appreciated.
If you wish to contribute, please follow these guidelines:
1. Fork and clone the repository
2. Branch off of the dev branch to create your own feature branch
- The Feature branch name should start with feat, fix, bug, docs, test, wip, or merge (e.g. feat/database)
- see the [Scripts](##Scripts) section below for additional details
3. Commit your changes (git commit -m '(feat/bugfix/style/etc.): [commit message here]')
- Please review [conventional commit](https://www.conventionalcommits.org/en/v1.0.0/) standards for more information
4. Once your new feature is built out, you can submit a pull request to dev
## Progress
| Feature | Status |
| ------------------------------------------------ | ------ |
| HPA Recommendations | ⏳ |
| Integrate CI/CD pipeline | ⏳ |
| Automated Monitoring Tool Deployment & Config | ⏳ |
| Increase Test Coverage | 🙏🏻 |
| Historical data page | 🙏🏻 |
| Ability to export metric data in-app | 🙏🏻 |
| OAuth2.0 with cloud-hosting providers (i.e. AWS) | 🙏🏻 |
| Stress-Test page | 🙏🏻 |
- ✅ = Ready to use
- ⏳ = In progress
- 🙏🏻 = Looking for contributors
## Scripts
Below are descriptions of each npm script:
- `npm run dev`: Starts the development server using Nodemon
- `npm run dev:front`: Starts the development for the frontend using Vite
- `npm run dev:back`: Starts the development server for the backend using Nodemon
- `npm run build`: Starts the build mode
- `npm run lint`: Applies standardized linting
- `npm run preview`: Runs a vite preview
- `npm vitest`: Runs tests with vitest
## Our Team
Alexandra Ashcraft
Halia Haynes
Rylie Pereira
Steve Schlepphorst
## License
By contributing, you agree that your contributions will be licensed under Anago's MIT License.