{"id":26267751,"url":"https://github.com/oslabs-beta/kubernautics","last_synced_at":"2025-04-30T19:14:41.543Z","repository":{"id":207055017,"uuid":"714091516","full_name":"oslabs-beta/Kubernautics","owner":"oslabs-beta","description":"Kubernautics is an open-source tool for monitoring metrics of target applications deployed within a Kubernetes cluster.","archived":false,"fork":false,"pushed_at":"2023-11-30T22:43:20.000Z","size":3004,"stargazers_count":29,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-30T19:14:14.266Z","etag":null,"topics":["chartjs","devops","devspace","kubectl","kubernetes","prometheus","react","react-router"],"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.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-11-03T22:34:46.000Z","updated_at":"2024-07-07T16:28:03.000Z","dependencies_parsed_at":"2023-11-23T01:26:10.646Z","dependency_job_id":"ee6b0310-3202-484d-9239-3aeaa2a63e47","html_url":"https://github.com/oslabs-beta/Kubernautics","commit_stats":null,"previous_names":["oslabs-beta/kubernautics"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oslabs-beta%2FKubernautics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oslabs-beta%2FKubernautics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oslabs-beta%2FKubernautics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oslabs-beta%2FKubernautics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oslabs-beta","download_url":"https://codeload.github.com/oslabs-beta/Kubernautics/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251767195,"owners_count":21640470,"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":["chartjs","devops","devspace","kubectl","kubernetes","prometheus","react","react-router"],"created_at":"2025-03-14T04:18:07.108Z","updated_at":"2025-04-30T19:14:41.488Z","avatar_url":"https://github.com/oslabs-beta.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kubernautics\n\n\u003cdiv align= \"center\"\u003e\n\u003cimg src =\"assets/images/nautics-resize.jpg\" /\u003e\n\u003c/div\u003e\n\u003cdiv \u003e\nKubernautics is an open-source \u003cb\u003e cluster monitoring solution \u003c/b\u003e that looks to prioritize ease of deployment, ease of use, and a low resource footprint. The program is placed directly into the cluster it is meant to monitor, and interfaces with your Prometheus deployment to provide detailed, reliable metric data. When you arrive at the UI, at your disposal are two dynamic tools to shape your monitoring experience; the dashboard of prometheus-fed cluster and application metrics, and the kubernetes cluster visualizer.\n\n\u003c/div\u003e\n\n## Table of Contents\n\n\u003col\u003e\n  \u003cli\u003e\n    \u003ca href=\"#built-with\"\u003eBuilt with\u003c/a\u003e\n  \u003c/li\u003e\n  \u003cli\u003e\n    \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e\n  \u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"#getting-started-with-kubernautics\"\u003eGetting Started with Kubernautics\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"#progress\"\u003eProgress\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=\"#our-team\"\u003eOur Team\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n\u003c/ol\u003e\n\n## Built with\n\n\u003cdiv align= \"center\"\u003e\n\n[![Kubernetes][Kubernetes-logo]](https://kubernetes.io)\n[![Docker][Docker-logo]](https://www.docker.com)\n[![Prometheus][Prometheus-logo]](https://prometheus.io)\n[![ChartJS][Chartjs-logo]](https://www.chartjs.org)\n[![ReactRouter][ReactRouter-logo]](https://reactrouter.com/en/main)\n[![Express][Express-logo]](https://expressjs.com)\n[![React][React-logo]](https://react.dev)\n[![Jest][Jest-logo]](https://jestjs.io)\n[![MUI][MUI-logo]](https://mui.com)\n[![Webpack][Webpack-logo]](https://webpack.js.org)\n[![Helm][Helm-logo]](https://helm.sh)\n[![Javascript][Javascript-logo]](https://www.javascript.com)\n[![npm][npm-logo]](https://www.npmjs.com)\n[![Node.JS][Node-logo]](https://nodejs.org/en)\n[![HTML5][HTML-logo]](https://developer.mozilla.org/en-US/docs/Web/HTML)\n\n\u003c/div\u003e\n\n## Features\n\n### 1. Realtime Monitoring Dashboard\n\n- Kubernautics compiles all metrics you want to track and constantly pulls information based off of the custom metric scrape rate\n\n### 2. Customizable Metrics\n\n- Kubernautics simplifies the Prometheus scraping tasks and provides additional information to each query task\n  \u003cbr\u003e\n  ![homepage](https://i.imgur.com/Iqkai3C.gif)\n\n### 3. Cluster Visualization\n\n- Kubernautics depicts the interdependencies within your cluster but also employs a color-coded system for ease of navigation\n  \u003cbr\u003e\n  ![visualizer](https://i.imgur.com/wF4wX7t.gif)\n\n## Getting Started with Kubernautics\n### Building the Container Image\nThe Kubernautics container image must currently be built from source. Download a copy of this repo, and once inside run --\n```\ndocker build . -t kubernautics:latest\n```\n-- to yield an image that can be deployed into your cluster.\n\n### Deploying to your cluster\nKubernautics currently assumes it can communicate with prometheus at the following address --\n```\nhttp://prometheus-kube-prometheus-prometheus:9090\n```\n-- which is the default configuration when Prometheus is deployed via the [Community Helm Chart](https://prometheus-community.github.io/helm-charts). We plan to make this configurable in the future.\n\nFor a reference deployment, you can run `npm run cluster:prod up` from inside the repository. You will need `minikube` and `devspace` installed locally on your machine; see [the setup guide for developers](/DEV_SETUP.md) for more info.\n\n## How to Contribute\n\n1. Fork the Project\n2. Create your Feature Branch based off of Dev\n\n- `git checkout -b feature/NewFeature`\n\n3. [Setup/enter the development environment](/DEV_SETUP.md)\n\n3. Commit your Changes\n\n- `git commit -m 'What was changed: Description of the NewFeature'`\n\n4. Push to the Branch\n\n- `git push origin feature/NewFeature`\n\n5. Open a Pull Request (from `feature/NewFeature` to `dev`)\n\n- make sure newest dev branch has been merged\n\n## Progress\n\n| Feature                                 | Status |\n| --------------------------------------- | ------ |\n| Customizable Cluster Visualizer         | ⏳     |\n| Additional Chart Typing                 | ⏳     |\n| Automate Prometheus Configs/Deployment  | ⏳     |\n| Increase Test Coverage                  | 🙏🏻     |\n| Reduce Resource Usage                   | 🙏🏻     |\n| Deployment with cloud-hosting providers | 🙏🏻     |\n\n- ✅ = Ready to use\n- ⏳ = In progress\n- 🙏🏻 = Looking for contributors\n\n## Our Team\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003cimg src=\"https://gravatar.com/userimage/230916546/d26e38adbf07961ad978c884b76d2388.jpeg?size=256\" alt= “Jordan” width=\"150px;\" alt=\"\"/\u003e\n      \u003cbr /\u003e\n      \u003csub\u003e\u003cb\u003eJordan Buranskas\u003c/b\u003e\u003c/sub\u003e\n      \u003cbr /\u003e\n      \u003ca href=\"https://www.linkedin.com/in/jordan-buranskas-22471841/\"\u003e\u003cimg src=\"https://img.shields.io/badge/LinkedIn-%230077B5.svg?logo=linkedin\u0026logoColor=white\" height=\"20px\"/\u003e\u003c/a\u003e\n      \u003ca href=\"https://github.com/JordanBuranskas\"\u003e\u003cimg src=\"https://img.shields.io/badge/github-%23121011.svg?style=for-the-badge\u0026logo=github\u0026logoColor=white\" height=\"20px\"/\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003cimg src=\"https://gravatar.com/userimage/243322748/e2ebd147ef0c3ec2881c70e21d3921b7.jpeg?size=256\" alt= \"Edward\" width=\"150px\"/\u003e\n      \u003cbr /\u003e\n      \u003csub\u003e\u003cb\u003eEdward Li\u003c/b\u003e\u003c/sub\u003e\n      \u003cbr /\u003e\n    \u003ca href=\"https://www.linkedin.com/in/edward-li-/\"\u003e\u003cimg src=\"https://img.shields.io/badge/LinkedIn-%230077B5.svg?logo=linkedin\u0026logoColor=white\" height=\"20px\"/\u003e\u003c/a\u003e\n      \u003ca href=\"https://github.com/edli-dot\"\u003e\u003cimg src=\"https://img.shields.io/badge/github-%23121011.svg?style=for-the-badge\u0026logo=github\u0026logoColor=white\" height=\"20px\"/\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003cimg src=\"https://gravatar.com/userimage/243322599/685076119aa1254f3d14a00ae5514fbd.jpeg?size=256\" alt= \"Matin\" width=\"150px;\" /\u003e\n      \u003cbr /\u003e\n      \u003csub\u003e\u003cb\u003eMatin Schams\u003c/b\u003e\u003c/sub\u003e\n      \u003cbr /\u003e\n      \u003ca href=\"https://www.linkedin.com/in/matin-schams/\"\u003e\u003cimg src=\"https://img.shields.io/badge/LinkedIn-%230077B5.svg?logo=linkedin\u0026logoColor=white\" height=\"20px\"/\u003e\u003c/a\u003e\n      \u003ca href=\"https://github.com/matinschams\"\u003e\u003cimg src=\"https://img.shields.io/badge/github-%23121011.svg?style=for-the-badge\u0026logo=github\u0026logoColor=white\" height=\"20px\"/\u003e\u003c/a\u003e\n    \u003c/td\u003e\n     \u003ctd align=\"center\"\u003e\n      \u003cimg src=\"https://gravatar.com/avatar/9636423b6c2c755d6c9f368b38fe92d63d3d39e898a6a8113b467d0a3e6243a5?s=256\" alt= \"Tyler\" width=\"150px\"/\u003e\n      \u003cbr /\u003e\n      \u003csub\u003e\u003cb\u003eTyler Shelton\u003c/b\u003e\u003c/sub\u003e\n      \u003cbr /\u003e\n      \u003ca href=\"https://www.linkedin.com/in/tylerdshelton/\"\u003e\u003cimg src=\"https://img.shields.io/badge/LinkedIn-%230077B5.svg?logo=linkedin\u0026logoColor=white\" height=\"20px\"/\u003e\u003c/a\u003e\n      \u003ca href=\"https://github.com/tylershelton\"\u003e\u003cimg src=\"https://img.shields.io/badge/github-%23121011.svg?style=for-the-badge\u0026logo=github\u0026logoColor=white\" height=\"20px\"/\u003e\u003c/a\u003e\n    \u003c/td\u003e\n  \u003ctr\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## License\n\nBy contributing, you agree that your contributions will be licensed under Kubernautics's MIT License.\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e\u003c/p\u003e\n\n[Kubernetes-logo]: https://img.shields.io/badge/KUBERNETES-326CE5?style=for-the-badge\u0026logo=KUBERNETES\u0026logoColor=white\n[Docker-logo]: https://img.shields.io/badge/DOCKER-2496ED?style=for-the-badge\u0026logo=DOCKER\u0026logoColor=white\n[Prometheus-logo]: https://img.shields.io/badge/Prometheus-E6522C?style=for-the-badge\u0026logo=Prometheus\u0026color=black\n[Chartjs-logo]: https://img.shields.io/badge/Chart.js-FF6384?style=for-the-badge\u0026logo=Chart.js\u0026logoColor=white\u0026color=FF6384\n[DevSpace-logo]: https://example.com/path/to/devspace-logo.png\n[ReactRouter-logo]: https://img.shields.io/badge/ReactRouter-CA4245?style=for-the-badge\u0026logo=React%20Router\u0026color=rgb(180%2C180%2C180)\n[React-logo]: https://img.shields.io/badge/React-61DAFB?style=for-the-badge\u0026logo=React\u0026color=rgb(90%2C90%2C90)\n[Jest-logo]: https://img.shields.io/badge/Jest-C21325?style=for-the-badge\u0026logo=Jest\n[MUI-logo]: https://img.shields.io/badge/MUI-%23007FFF?style=for-the-badge\u0026logo=MUI\u0026logoColor=white\n[Webpack-logo]: https://img.shields.io/badge/Webpack-%238DD6F9?style=for-the-badge\u0026logo=Webpack\u0026logoColor=blue\n[Helm-logo]: https://img.shields.io/badge/Helm-0F1689?style=for-the-badge\u0026logo=Helm\n[Javascript-logo]: https://img.shields.io/badge/Javascript-F7DF1E?style=for-the-badge\u0026logo=Javascript\u0026color=rgb(45%2C45%2C45)\n[Express-logo]: https://img.shields.io/badge/Express-000000?style=for-the-badge\u0026logo=Express\n[npm-logo]: https://img.shields.io/badge/npm-CB3837?style=for-the-badge\u0026logo=npm\n[Node-logo]: https://img.shields.io/badge/Node.js-339933?style=for-the-badge\u0026logo=Node.js\u0026logoColor=white\u0026color=339933\n[HTML-logo]: https://img.shields.io/badge/HTML-E34F26?style=for-the-badge\u0026logo=HTML5\u0026logoColor=white\u0026color=E34F26\n[Git-logo]: https://img.shields.io/badge/github-%23121011.svg?style=for-the-badge\u0026logo=github\u0026logoColor=white\n[Linkedin-logo]: https://img.shields.io/badge/LinkedIn-%230077B5.svg?logo=linkedin\u0026logoColor=white\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foslabs-beta%2Fkubernautics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foslabs-beta%2Fkubernautics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foslabs-beta%2Fkubernautics/lists"}