{"id":30119995,"url":"https://github.com/stakater/chowkidar","last_synced_at":"2025-10-23T02:32:41.282Z","repository":{"id":93163914,"uuid":"131047110","full_name":"stakater/Chowkidar","owner":"stakater","description":"A kubernetes controller that watches/observes events \u0026 then takes configured actions  – [✩Star] if you're using it!","archived":false,"fork":false,"pushed_at":"2023-12-15T17:58:11.000Z","size":13284,"stargazers_count":55,"open_issues_count":2,"forks_count":9,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-07-12T07:33:06.334Z","etag":null,"topics":["kube-alert","kubernetes","kubernetes-controller","kubewatch","openshift"],"latest_commit_sha":null,"homepage":"https://stakater.com/opensource","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stakater.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}},"created_at":"2018-04-25T18:22:15.000Z","updated_at":"2023-10-06T17:01:16.000Z","dependencies_parsed_at":"2024-01-18T09:04:34.304Z","dependency_job_id":"b8ce05fa-f1e4-482e-bafd-042083888f06","html_url":"https://github.com/stakater/Chowkidar","commit_stats":{"total_commits":150,"total_committers":12,"mean_commits":12.5,"dds":0.7666666666666666,"last_synced_commit":"0fcac91cae2689fc92988ff2ff72cc4d0fd390b0"},"previous_names":[],"tags_count":35,"template":false,"template_full_name":null,"purl":"pkg:github/stakater/Chowkidar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stakater%2FChowkidar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stakater%2FChowkidar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stakater%2FChowkidar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stakater%2FChowkidar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stakater","download_url":"https://codeload.github.com/stakater/Chowkidar/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stakater%2FChowkidar/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269727088,"owners_count":24465397,"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","status":"online","status_checked_at":"2025-08-10T02:00:08.965Z","response_time":71,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["kube-alert","kubernetes","kubernetes-controller","kubewatch","openshift"],"created_at":"2025-08-10T12:52:31.895Z","updated_at":"2025-10-23T02:32:39.076Z","avatar_url":"https://github.com/stakater.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ![](assets/web/chowkidar-white-round-border-100px.png) Chowkidar\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/stakater/chowkidar?style=flat-square)](https://goreportcard.com/report/github.com/stakater/chowkidar)\n[![Go Doc](https://img.shields.io/badge/godoc-reference-blue.svg?style=flat-square)](http://godoc.org/github.com/stakater/chowkidar)\n[![Release](https://img.shields.io/github/release/stakater/chowkidar.svg?style=flat-square)](https://github.com/stakater/chowkidar/releases/latest)\n[![GitHub tag](https://img.shields.io/github/tag/stakater/chowkidar.svg?style=flat-square)](https://github.com/stakater/chowkidar/releases/latest)\n[![Docker Pulls](https://img.shields.io/docker/pulls/stakater/chowkidar.svg?style=flat-square)](https://hub.docker.com/r/stakater/chowkidar/)\n[![Docker Stars](https://img.shields.io/docker/stars/stakater/chowkidar.svg?style=flat-square)](https://hub.docker.com/r/stakater/chowkidar/)\n[![MicroBadger Size](https://img.shields.io/microbadger/image-size/stakater/chowkidar.svg?style=flat-square)](https://microbadger.com/images/stakater/chowkidar)\n[![MicroBadger Layers](https://img.shields.io/microbadger/layers/stakater/chowkidar.svg?style=flat-square)](https://microbadger.com/images/stakater/chowkidar)\n[![license](https://img.shields.io/github/license/stakater/chowkidar.svg?style=flat-square)](LICENSE)\n\n[![Get started with Stakater](https://stakater.github.io/README/stakater-github-banner.png)](http://stakater.com/?utm_source=Chowkidar\u0026utm_medium=github)\n\n## WHY NAME CHOWKIDAR?\nChowkidar, an Urdu word, is used for Watchman in Pakistan. This Chowkidar will watch over your cluster, looking for any anomaly in the cluster and will act as you want it to.\n\n## Problem\nWe would like to watch for relevant events happening inside kubernetes and then perform actions depending upon the criteria.\ne.g. I would like to get a slack notification when a pod is submitted without requests \u0026 limits.\n\n## Solution\n\nChowkidar allows you to have multiple controllers that will continuously watch types in all the namespaces and automatically perform any actions given in the yaml file. With this, you can easily check for any criteria on your Pods/other types and take corresponding actions.\n\n## Deploying to Kubernetes\n\n### Vanilla Manifests\n\nYou have to first clone or download the repository contents. The kubernetes deployment and files are provided inside `deployments/kubernetes/manifests` folder.\n\n### Configuring\n\nFirst of all you need to modify `configs/config.yaml` file. Following are the available options that you can use to customize the controllers:\n\n| Key                   |Description                                                                    |\n|-----------------------|-------------------------------------------------------------------------------|\n| type                  | The type of Resource you want to monitor, like Pods, Deployments, etc         |\n| watchcriterion        | The criterion for which you want to take actions for the controller e.g. ResourceExists,etc     |\n| actions               | The Array of actions that you want to take, e.g. send message to Slack, etc   |\n\n### Supported Types\nCurrently we are supporting,\n- Pods\n\n\nWe will be adding support for other Types as well in the future\n\n### Supported Criterion\nCurrently we are supporting following Criterion\n- resourceExists: It will make sure Pods should have Resources and if not found, it will take action\n\n\nWe will be adding support for other Criterion as well in the future\n\n### Supported Actions\nCurrently we are supporting following Actions with their Parameters,\n- Slack: you need to provide `token` and `Channel Name` as Parameters in the yaml file\n\nWe will be adding support for other Actions as well in the future\n\n#### Deploying\n\nYou can deploy Chowkidar by running the following kubectl commands:\n\n```bash\nkubectl apply -f configmap.yaml -n \u003cnamespace\u003e\nkubectl apply -f rbac.yaml -n \u003cnamespace\u003e\nkubectl apply -f deployment.yaml -n \u003cnamespace\u003e\n```\n\n### Helm Charts\n\nOr alternatively if you configured `helm` on your cluster, you can deploy Chowkidar via helm chart located under `deployments/kubernetes/chart/Chowkidar` folder.\n\n## Help\n\n**Got a question?**\nFile a GitHub [issue](https://github.com/stakater/Chowkidar/issues), or send us an [email](mailto:stakater@gmail.com).\n\n### Talk to us on Slack\nJoin and talk to us on the #tools-imc channel for discussing Chowkidar\n\n[![Join Slack](https://stakater.github.io/README/stakater-join-slack-btn.png)](https://slack.stakater.com/)\n[![Chat](https://stakater.github.io/README/stakater-chat-btn.png)](https://stakater-community.slack.com/messages/CAN960CTG)\n\n## Contributing\n\n### Bug Reports \u0026 Feature Requests\n\nPlease use the [issue tracker](https://github.com/stakater/Chowkidar/issues) to report any bugs or file feature requests.\n\n### Developing\n\nPRs are welcome. In general, we follow the \"fork-and-pull\" Git workflow.\n\n 1. **Fork** the repo on GitHub\n 2. **Clone** the project to your own machine\n 3. **Commit** changes to your own branch\n 4. **Push** your work back up to your fork\n 5. Submit a **Pull request** so that we can review your changes\n\nNOTE: Be sure to merge the latest from \"upstream\" before making a pull request!\n\n## Changelog\n\nView our closed [Pull Requests](https://github.com/stakater/Chowkidar/pulls?q=is%3Apr+is%3Aclosed).\n\n## License\n\nApache2 © [Stakater](http://stakater.com)\n\n## About\n\n`Chowkidar` is maintained by [Stakater][website]. Like it? Please let us know at \u003chello@stakater.com\u003e\n\nSee [our other projects][community]\nor contact us in case of professional services and queries on \u003chello@stakater.com\u003e\n\n  [website]: http://stakater.com/\n  [community]: https://github.com/stakater/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstakater%2Fchowkidar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstakater%2Fchowkidar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstakater%2Fchowkidar/lists"}