{"id":26268073,"url":"https://github.com/oslabs-beta/armada","last_synced_at":"2025-04-30T19:26:46.737Z","repository":{"id":38820068,"uuid":"489481894","full_name":"oslabs-beta/Armada","owner":"oslabs-beta","description":"A Kubernetes monitoring tool to visualize large-scale activity and real-time comprehensive metrics within your cluster.","archived":false,"fork":false,"pushed_at":"2022-07-01T19:04:09.000Z","size":2527,"stargazers_count":86,"open_issues_count":0,"forks_count":11,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-12-31T13:04:26.919Z","etag":null,"topics":["chartjs","dashboard","express","grafana","javascript","k8s","k8s-cluster","kubernetes","kubernetes-cluster","kubernetes-monitoring","material-ui","monitoring","nodejs","prometheus","react","react-router","reactjs","redux"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"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":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-05-06T20:13:20.000Z","updated_at":"2024-12-16T06:18:10.000Z","dependencies_parsed_at":"2022-07-09T05:16:03.737Z","dependency_job_id":null,"html_url":"https://github.com/oslabs-beta/Armada","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oslabs-beta%2FArmada","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oslabs-beta%2FArmada/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oslabs-beta%2FArmada/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oslabs-beta%2FArmada/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oslabs-beta","download_url":"https://codeload.github.com/oslabs-beta/Armada/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243521211,"owners_count":20304188,"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","dashboard","express","grafana","javascript","k8s","k8s-cluster","kubernetes","kubernetes-cluster","kubernetes-monitoring","material-ui","monitoring","nodejs","prometheus","react","react-router","reactjs","redux"],"created_at":"2025-03-14T04:19:22.395Z","updated_at":"2025-03-14T04:19:22.957Z","avatar_url":"https://github.com/oslabs-beta.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Armada Logo](./assets/Logo.png?raw=true)\n\n# Armada\n\nA light-weight Kubernetes health monitoring tool.\n\n## Summary\n\nArmada is an open-source tool for monitoring the health of your Kubernetes cluster. It features a dashboard which delivers an at-a-glance overview of the status of your cluster. It also features a metrics page to view time-series data of your cluster's performance, and an alerts page and logs page to stay on top of any events that may arise.\n\n## Features\n\n### Dashboard - Easily Assess and Diagnose Cluster Health\n\nThe homepage dashboard provides a comprehensive and easily digestible overview of your cluster health and performance. It shows overall cluster resource usage, cluster statistics, and node and pod statuses. It also features charts tracking the most resource-intensive nodes and pods in your cluster. All data across the application is filterable by namespace.\n\n![homepage](https://user-images.githubusercontent.com/65976862/170833541-6d25fddd-6c65-4b40-8fa8-70576b4b28a1.gif)\n\n### Metrics - In-Depth View of Cluster Performance\n\nThe metrics page displays a curated selection of time-series data regarding your cluster. You can view CPU usage, memory usage, and network data for namespaces, nodes, and pods. Not seeing the information you're looking for? Simply go to the custom query page and submit your query to see customized time-series charts.\n\n![metrics](https://user-images.githubusercontent.com/65976862/170834565-8c23d13a-9114-436c-b7ea-7237ddc25fcd.gif)\n\n### Custom Metrics - Create a Custom View of Your Cluster Metrics\n\nFor additional flexibility, the custom metrics page allows users to select from over 800 Prometheus Queries to generate time-series charts with custom inputs for time range, step, and namespace.\n\n![custom](https://user-images.githubusercontent.com/100235225/171661130-87519aa0-8d4c-4b30-a04f-e4d42339723e.gif)\n\n### Alerts and Logs - Stay Updated on Cluster Events\n\nThe alerts page displays all Prometheus rules, filterable by group, name, status, and severity. Upon expanding a rule you can see any active alerts, along with associated descriptions. You can view event logs on the log page, filterable by type and reason.\n\n![alerts](https://user-images.githubusercontent.com/65976862/170834672-f55e9f6d-a04c-454f-84c3-5910138ad584.gif)\n\n## Getting Started\n\n### 1. Prerequisites\n\nBefore you start with Armada, make sure you have a configured and running Kubernetes cluster and Prometheus. You can find detailed instructions on how to set this up [here](https://github.com/marcel-dempers/docker-development-youtube-series/tree/master/monitoring/prometheus/kubernetes/1.23).\n\n### 2. Clone this repo\n\nRun this command in your terminal:\n\n```\ngit clone git@github.com:oslabs-beta/Armada.git\n```\n\n### 3. Install dependencies and start the app\n\nRun these commands from within the root directory:\n\n```\nnpm install\nnpm run build\nnpm run start\n```\n\n### 4. Port-forward Prometheus to 9090\n\nTo port-forward Prometheus, run the following command, replacing the terms in brackets with the namespace and service name.\n\n```\nkubectl port-forward -n \u003cnamespace\u003e svc/\u003cservice name\u003e 9090\n```\n\n### 5. Start using Armada!\n\nGo to http://localhost:3001/ and enjoy your new k8s experience!\n\n## Built With\n\n- [React](https://reactjs.org/)\n- [React Router](https://reactrouter.com/)\n- [Redux](https://redux.js.org/)\n- [Node](https://nodejs.org/)\n- [Express](https://expressjs.com/)\n- [Kubernetes-client](https://github.com/kubernetes-client/)\n- [Prometheus](https://prometheus.io/)\n- [Material UI](https://mui.com/)\n- [Chart.js](https://www.chartjs.org/)\n\n## The Team\n\n- Em Podhorcer [Github](https://github.com/epithe) [LinkedIn](https://www.linkedin.com/in/emily-podhorcer/)\n- Jessica Lee [Github](https://github.com/frandis) [LinkedIn](https://www.linkedin.com/in/jessica-lee-790a283b/)\n- Natalie Heller [Github](https://github.com/natwheller) [LinkedIn](https://www.linkedin.com/in/natwheller/)\n- Tori Wu [Github](https://github.com/tortortor0) [LinkedIn](https://www.linkedin.com/in/victoria-y-wu/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foslabs-beta%2Farmada","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foslabs-beta%2Farmada","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foslabs-beta%2Farmada/lists"}