{"id":20504051,"url":"https://github.com/icinga/icinga-kubernetes","last_synced_at":"2025-10-19T22:02:49.970Z","repository":{"id":217867214,"uuid":"622526166","full_name":"Icinga/icinga-kubernetes","owner":"Icinga","description":null,"archived":false,"fork":false,"pushed_at":"2025-04-10T07:09:41.000Z","size":14407,"stargazers_count":12,"open_issues_count":32,"forks_count":3,"subscribers_count":14,"default_branch":"main","last_synced_at":"2025-04-13T20:47:32.213Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Icinga.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}},"created_at":"2023-04-02T11:35:11.000Z","updated_at":"2025-03-08T10:15:30.000Z","dependencies_parsed_at":"2024-02-27T14:28:01.459Z","dependency_job_id":"f599049d-a8b8-44ae-80fb-05be3cb1b891","html_url":"https://github.com/Icinga/icinga-kubernetes","commit_stats":null,"previous_names":["icinga/icinga-kubernetes"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Icinga%2Ficinga-kubernetes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Icinga%2Ficinga-kubernetes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Icinga%2Ficinga-kubernetes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Icinga%2Ficinga-kubernetes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Icinga","download_url":"https://codeload.github.com/Icinga/icinga-kubernetes/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248782278,"owners_count":21160716,"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":[],"created_at":"2024-11-15T19:35:57.702Z","updated_at":"2025-10-19T22:02:49.964Z","avatar_url":"https://github.com/Icinga.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Icinga for Kubernetes\n\nIcinga for Kubernetes is a set of components for monitoring and visualizing Kubernetes resources,\nconsisting of\n\n* the Icinga for Kubernetes daemon, which uses the Kubernetes API to monitor the configuration and\n  status changes of Kubernetes resources synchronizing every change in a database, and\n* [Icinga for Kubernetes Web](https://github.com/Icinga/icinga-kubernetes-web)\n  which connects to the database for visualizing Kubernetes resources and their state.\n\n![Icinga for Kubernetes Overview](doc/res/icinga-kubernetes-overview.png)\n\nThough any of the Icinga for Kubernetes components can run either inside or outside Kubernetes clusters,\nincluding the database, common setup approaches include the following:\n\n* All components run inside a Kubernetes cluster.\n* All components run outside a Kubernetes cluster.\n* Only the Icinga for Kubernetes daemon runs inside a Kubernetes cluster,\n  requiring configuration for an external service to connect to the database outside the cluster.\n\n![Icinga Kubernetes Web Dashboard](doc/res/icinga-kubernetes-dashboard.png)\n![Icinga Kubernetes Web Deployment](doc/res/icinga-kubernetes-deployment.png)\n![Icinga Kubernetes Web Stateful Set](doc/res/icinga-kubernetes-statefulset.png)\n![Icinga Kubernetes Web Replica Set](doc/res/icinga-kubernetes-replicaset.png)\n![Icinga Kubernetes Web Favorites Dashboard](doc/res/icinga-kubernetes-favorites-dashboard.png)\n\n## Multi-Cluster Support\n\nIcinga for Kubernetes supports multiple Kubernetes clusters by deploying several daemons,\neach connecting to a different cluster but writing data into the same database.\nThe web interface accesses this database to display resource information and state,\noffering the flexibility to view aggregated data from all clusters or focus on a specific cluster.\nThis setup ensures scalable monitoring and a unified view of resources across multiple Kubernetes environments.\n\n## Vision and Roadmap\n\nAlthough every Kubernetes cluster is different, Icinga for Kubernetes aims to provide a zero-configuration baseline for\nmonitoring Kubernetes. Our goal is to make it easy to understand the complete state of clusters, including resources,\nworkloads, relations, and performance. We strive to offer comprehensive monitoring that provides a clear and\nintuitive view of clusters' health, helping to identify problems and potential bottlenecks.\n\nThe Kubernetes API is leveraged to retrieve information about resources and watch ongoing changes.\nThis data is stored in a database to reduce pressure on the Kubernetes API and\nto enable powerful filtering through a relational model.\n\nCurrently, Icinga for Kubernetes utilizes all available information from the Kubernetes API to\ndetermine the state of resources and clusters. In future versions, we plan to integrate metrics.\n\nWe welcome your ideas on what should be included in the baseline.\nDo not hesitate to share your key metrics, important thresholds,\nor correlations used to set up alarms in your environments.\n\n## Optional Features\n\n### Metric Sync\n\nIcinga for Kubernetes integrates with Prometheus to synchronize predefined metrics and display charts in the UI.\nIn future versions, we plan to incorporate these metrics into state evaluation and alerting.\nTo enable this feature you just have to configure a Prometheus server URL\nthat collects metrics from your Kubernetes cluster.\n\n## Documentation\n\nIcinga for Kubernetes documentation is available at [icinga.com/docs](https://icinga.com/docs/icinga-kubernetes).\n\n## License\n\nIcinga for Kubernetes and the Icinga for Kubernetes documentation are licensed under the terms of the\n[GNU Affero General Public License Version 3](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ficinga%2Ficinga-kubernetes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ficinga%2Ficinga-kubernetes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ficinga%2Ficinga-kubernetes/lists"}