{"id":13470592,"url":"https://github.com/litmuschaos/litmus","last_synced_at":"2025-10-23T02:36:10.566Z","repository":{"id":37431276,"uuid":"85039965","full_name":"litmuschaos/litmus","owner":"litmuschaos","description":"Litmus helps  SREs and developers practice chaos engineering in a Cloud-native way. Chaos experiments are published at the ChaosHub  (https://hub.litmuschaos.io). Community notes is at https://hackmd.io/a4Zu_sH4TZGeih-xCimi3Q","archived":false,"fork":false,"pushed_at":"2025-05-07T19:35:38.000Z","size":143723,"stargazers_count":4686,"open_issues_count":437,"forks_count":724,"subscribers_count":69,"default_branch":"master","last_synced_at":"2025-05-11T05:48:06.843Z","etag":null,"topics":["chaos-engineering","chaos-experiments","chaos-testing","chaoshub","cloud-native","cncf","devops","fault-injection","fault-simulation","golang","google-summer-of-code","hacktoberfest","k8s","kubernetes","lfx","litmuschaos","operator-sdk","reliability-engineering","resilience-testing","site-reliability-engineering"],"latest_commit_sha":null,"homepage":"https://litmuschaos.io","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/litmuschaos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":"GOVERNANCE.md","roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-03-15T07:02:59.000Z","updated_at":"2025-05-11T00:03:28.000Z","dependencies_parsed_at":"2023-12-19T18:00:49.326Z","dependency_job_id":"2709cdfa-93ea-4e62-8796-3925508f7d62","html_url":"https://github.com/litmuschaos/litmus","commit_stats":{"total_commits":2745,"total_committers":265,"mean_commits":"10.358490566037736","dds":0.9336976320582878,"last_synced_commit":"970eb38581b3f07c1dc0c2ea5f53ce95b14b5515"},"previous_names":[],"tags_count":107,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/litmuschaos%2Flitmus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/litmuschaos%2Flitmus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/litmuschaos%2Flitmus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/litmuschaos%2Flitmus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/litmuschaos","download_url":"https://codeload.github.com/litmuschaos/litmus/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253523733,"owners_count":21921818,"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":["chaos-engineering","chaos-experiments","chaos-testing","chaoshub","cloud-native","cncf","devops","fault-injection","fault-simulation","golang","google-summer-of-code","hacktoberfest","k8s","kubernetes","lfx","litmuschaos","operator-sdk","reliability-engineering","resilience-testing","site-reliability-engineering"],"created_at":"2024-07-31T16:00:32.402Z","updated_at":"2025-10-23T02:36:10.560Z","avatar_url":"https://github.com/litmuschaos.png","language":"Go","funding_links":[],"categories":["Chaos Engineering","TypeScript","Go","Chaos testing","Tools and Libraries","Uncategorized","kubernetes","Notable Tools","一、核心工具集（按场景分类）","3. Fault Injection","Performance Testing","Reliability \u0026 Chaos Engineering"],"sub_categories":["Testing and Troubleshooting","Uncategorized","Misc","7. 测试与故障排查（验证稳定性）","Containers \u0026 Orchestrators","Chaos Engineering \u0026 Fault Injection"],"readme":"# [LitmusChaos](https://litmuschaos.io/)\n\u003cimg alt=\"LitmusChaos\" src=\"https://avatars.githubusercontent.com/u/49853472?s=200\u0026v=4\" width=\"200\" align=\"left\"\u003e\n\n### Open Source Chaos Engineering Platform\n\n[![Slack Channel](https://img.shields.io/badge/Slack-Join-purple)](https://slack.litmuschaos.io)\n![GitHub Workflow](https://github.com/litmuschaos/litmus/actions/workflows/push.yml/badge.svg?branch=master)\n[![Docker Pulls](https://img.shields.io/docker/pulls/litmuschaos/chaos-operator.svg)](https://hub.docker.com/r/litmuschaos/chaos-operator)\n[![GitHub stars](https://img.shields.io/github/stars/litmuschaos/litmus?style=social)](https://github.com/litmuschaos/litmus/stargazers)\n[![GitHub issues](https://img.shields.io/github/issues/litmuschaos/litmus)](https://github.com/litmuschaos/litmus/issues)\n[![Twitter Follow](https://img.shields.io/twitter/follow/litmuschaos?style=social)](https://twitter.com/LitmusChaos)\n[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/3202/badge)](https://www.bestpractices.dev/projects/3202)\n[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Flitmuschaos%2Flitmus.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2Flitmuschaos%2Flitmus?ref=badge_shield)\n[![YouTube Channel](https://img.shields.io/badge/YouTube-Subscribe-red)](https://www.youtube.com/channel/UCa57PMqmz_j0wnteRa9nCaw)\n[![Gurubase](https://img.shields.io/badge/Gurubase-Ask%20LitmusChaos%20Guru-006BFF)](https://gurubase.io/g/litmuschaos)\n\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n#### *Read this in [other languages](translations/TRANSLATIONS.md).*\n\n[🇰🇷](translations/README-ko.md) [🇨🇳](translations/README-chn.md) [🇧🇷](translations/README-pt-br.md) [🇮🇳](translations/README-hi.md)\n\n\n## Overview\n\nLitmusChaos is an open source Chaos Engineering platform that enables teams to identify weaknesses \u0026 potential outages in infrastructures by \ninducing chaos tests in a controlled way. Developers \u0026 SREs can practice Chaos Engineering with LitmusChaos as it is easy to use, based on modern \nChaos Engineering principles \u0026 community collaborated. It is 100% open source \u0026 a CNCF project.\n\nLitmusChaos takes a cloud-native approach to create, manage and monitor chaos. The platform itself runs as a set of microservices and uses Kubernetes \ncustom resources (CRs) to define the chaos intent, as well as the steady state hypothesis. \n\nAt a high-level, Litmus comprises of:  \n\n- **Chaos Control Plane**: A centralized chaos management tool called chaos-center, which helps construct, schedule and visualize Litmus chaos workflows  \n- **Chaos Execution Plane Services**: Made up of a chaos agent and multiple operators that execute \u0026 monitor the experiment within a defined \n  target Kubernetes environment. \n\n![architecture summary](/images/litmus-control-and-execution-plane-overview.png)\n\nAt the heart of the platform are the following chaos custom resources: \n\n- **ChaosExperiment**: A resource to group the configuration parameters of a particular fault. ChaosExperiment CRs are essentially installable templates \n  that describe the library carrying out the fault, indicate permissions needed to run it \u0026 the defaults it will operate with. Through the ChaosExperiment,  Litmus supports BYOC (bring-your-own-chaos) that helps integrate (optional) any third-party tooling to perform the fault injection. \n\n- **ChaosEngine**: A resource to link a Kubernetes application workload/service, node or an infra component to a fault described by the ChaosExperiment. \n  It also provides options to tune the run properties and specify the steady state validation constraints using 'probes'. ChaosEngine is watched by the \n  Chaos-Operator, which reconciles it (triggers experiment execution) via runners. \n\nThe ChaosExperiment \u0026 ChaosEngine CRs are embedded within a Workflow object that can string together one or more experiments in a desired order.\n\n- **ChaosResult**: A resource to hold the results of the experiment run. It provides details of the success of each validation constraint, \n  the revert/rollback status of the fault as well as a verdict. The Chaos-exporter reads the results and exposes information as prometheus metrics. \n  ChaosResults are especially useful during automated runs. \n\nChaosExperiment CRs are hosted on \u003ca href=\"https://hub.litmuschaos.io\" target=\"_blank\"\u003ehub.litmuschaos.io\u003c/a\u003e. It is a central hub where the \napplication developers or vendors share their chaos experiments so that their users can use them to increase the resilience of the applications \nin production.\n\n## Use cases\n\n- **For Developers**: To run chaos experiments during application development as an extension of unit testing or integration testing.\n- **For CI/CD pipeline builders**: To run chaos as a pipeline stage to find bugs when the application is subjected to fail paths in a pipeline.\n- **For SREs**: To plan and schedule chaos experiments into the application and/or surrounding infrastructure. This practice identifies the weaknesses \n  in the deployment system and increases resilience.\n\n## Getting Started with Litmus\n\nTo get started, check out the \u003ca href=\"https://docs.litmuschaos.io/docs/introduction/what-is-litmus\" target=\"_blank\"\u003eLitmus Docs\u003c/a\u003e and specifically the \u003ca href=\"https://docs.litmuschaos.io/docs/getting-started/installation#prerequisites\" target=\"_blank\"\u003eInstallation section\u003c/a\u003e of the \u003ca href=\"https://docs.litmuschaos.io/docs/getting-started/installation\" target=\"_blank\"\u003eGetting Started with Litmus\u003c/a\u003e page.\n\n## Contributing to Chaos Hub\n\nCheck out the \u003ca href=\"https://github.com/litmuschaos/community-charts/blob/master/CONTRIBUTING.md\" target=\"_blank\"\u003eContributing Guidelines for the Chaos Hub\u003c/a\u003e\n\n\n## Community\n\n### Community Resources:\n\nFeel free to reach out if you have any queries,concerns, or feature requests\n\n- Give us a star ⭐️ - If you are using LitmusChaos or think it is an interesting project, we would love a star ❤️\n\n- Follow LitmusChaos on Twitter [@LitmusChaos](https://twitter.com/LitmusChaos).\n\n- Subscribe to the [LitmusChaos YouTube channel](https://www.youtube.com/channel/UCa57PMqmz_j0wnteRa9nCaw) for regular updates \u0026 meeting recordings. \n\n- To join our [Slack Community](https://slack.litmuschaos.io/) and meet our community members, put forward your questions \u0026 opinions, join the #litmus channel on the [Kubernetes Slack](https://slack.k8s.io/). \n\n### Community Meetings\n\n1. Community Meetings\n- These will be hosted every 3rd Wednesday of every month at  5:30 PM GMT /6:30 PM CEST /10 PM IST\n- These meetings cover community updates, new feature or release announcements, and user/adopter stories. Everyone in the community is welcome to join and participate in discussions.\n\n\n2. Contributor Meetings\n- These will be hosted every second \u0026 last Thursday of every month at  2:30 PM GMT /3:30 PM CEST /7 PM IST\n- These meetings focus on both technical and non-technical contributions to LitmusChaos. Maintainers, current contributors, and aspiring contributors are encouraged to join to discuss issues, fixes, enhancements, and future contributions.\n\nFill out the [LitmusChaos Meetings invite form](https://forms.gle/qawjtFUeL431jmpv7) to get your Calendar invite!  \n\n- [Sync Up Agenda \u0026 Meeting Notes](https://hackmd.io/a4Zu_sH4TZGeih-xCimi3Q)\n- [Release Tracker](https://github.com/litmuschaos/litmus/milestones)\n\n### Videos\n\n- [What if Your System Experiences an Outage? Let's Build a Resilient Systems with Chaos Engineering](https://www.youtube.com/watch?v=3mjGEh905u4\u0026t=1s) @ [CNCF](https://www.youtube.com/@cncf)\n- [Enhancing Cyber Resilience Through Zero Trust Chaos Experiments in Cloud Native Environments](https://youtu.be/BelNIk4Bkng) @ [CNCF](https://www.youtube.com/@cncf)\n- [LitmusChaos, with Karthik Satchitanand](https://www.youtube.com/watch?v=ks2R57hhFZk\u0026t=503s) @ [The Kubernetes Podcast from Google](https://www.youtube.com/@TheKubernetesPodcast)\n- [Cultural Shifts: Fostering a Chaos First Mindset in Platform Engineering](https://www.youtube.com/watch?v=WUXFKxgZRsk) @ [CNCF](https://www.youtube.com/@cncf)\n- [Fire in the Cloud: Bringing Managed Services Under the Ambit of Cloud-Native Chaos Engineering](https://www.youtube.com/watch?v=xCDQp5E3VUs) @ [CNCF](https://www.youtube.com/@cncf)\n- [Security Controls for Safe Chaos Experimentation](https://www.youtube.com/watch?v=whCkvLKAw74) @ [CNCF](https://www.youtube.com/@cncf)\n- [Chaos Engineering For Hybrid Targets With LitmusChaos](https://www.youtube.com/watch?v=BZL-ngvbpbU\u0026t=751s) @ [CNCF](https://www.youtube.com/@cncf)\n- [Cloud Native Live: Litmus Chaos Engine and a microservices demo app](https://youtu.be/hOghvd9qCzI)\n- [Chaos Engineering hands-on - An SRE ideating Chaos Experiments and using LitmusChaos | July 2022](https://youtu.be/_x_7SiesjF0) \n- [Achieve Digital Product Resiliency with Chaos Engineering](https://youtu.be/PQrmBHgk0ps)\n- [Case Study: Bringing Chaos Engineering to the Cloud Native Developers](https://youtu.be/KSl-oKk6TPA) @ [CNCF](https://www.youtube.com/@cncf)\n- [Cloud Native Chaos Engineering with LitmusChaos](https://www.youtube.com/watch?v=ItUUqejdXr0) @ [CNCF](https://www.youtube.com/@cncf)\n- [How to create Chaos Experiments with Litmus | Litmus Chaos tutorial](https://youtu.be/mwu5eLgUKq4) @ [Is it Observable](https://www.youtube.com/c/IsitObservable)\n- [Cloud Native Chaos Engineering Preview With LitmusChaos](https://youtu.be/pMWqhS-F3tQ)\n- [Get started with Chaos Engineering with Litmus](https://youtu.be/5CI8d-SKBfc) @ [Containers from the Couch](https://www.youtube.com/c/ContainersfromtheCouch)\n- [Litmus 2 - Chaos Engineering Meets Argo Workflows](https://youtu.be/B8DfYnDh2F4) @ [DevOps Toolkit](https://youtube.com/c/devopstoolkit)\n- [Hands-on with Litmus 2.0 | Rawkode Live](https://youtu.be/D0t3emVLLko) @ [Rawkode Academy](https://www.youtube.com/channel/UCrber_mFvp_FEF7D9u8PDEA)\n- [Introducing LitmusChaos 2.0 / Dok Talks #74](https://youtu.be/97BiCNtJbDw) @ [DoK.community](https://www.youtube.com/channel/UCUnXJbHQ89R2uSfKsqQwGvQ)\n- [Introduction to Cloud Native Chaos Engineering](https://youtu.be/LK0oDLQE4S8) @ [Kunal Kushwaha](https://www.youtube.com/channel/UCBGOUQHNNtNGcGzVq5rIXjw)\n- [#EveryoneCanContribute cafe: Litmus - Chaos Engineering for your Kubernetes](https://youtu.be/IiyrEiK4stQ) @ [GitLab Unfiltered](https://www.youtube.com/channel/UCMtZ0sc1HHNtGGWZFDRTh5A)\n- [Litmus - Chaos Engineering for Kubernetes (CNCFMinutes 9)](https://youtu.be/rDQ9XKbSJIc) @ [Saiyam Pathak](https://www.youtube.com/channel/UCi-1nnN0eC9nRleXdZA6ncg)\n- [Chaos Engineering with Litmus Chaos by Prithvi Raj || HACKODISHA Workshop](https://youtu.be/eyAG0svCsQA) @ [Webwiz](https://www.youtube.com/channel/UC9yM_PkV0QIIsPA3qPrp)\n\n[And More....](https://www.youtube.com/channel/UCa57PMqmz_j0wnteRa9nCaw)\n\n### Blogs\n\n- CNCF: [Introduction to LitmusChaos](https://www.cncf.io/blog/2020/08/28/introduction-to-litmuschaos/)\n- Hackernoon: [Manage and Monitor Chaos via Litmus Custom Resources](https://hackernoon.com/solid-tips-on-how-to-manage-and-monitor-chaos-via-litmus-custom-resources-5g1s33m9)\n- [Observability Considerations in Chaos: The Metrics Story](https://dev.to/ksatchit/observability-considerations-in-chaos-the-metrics-story-6cb)\n\nCommunity Blogs:\n\n- LiveWyer: [LitmusChaos Showcase: Chaos Experiments in a Helm Chart Test Suite](https://livewyer.io/blog/2021/03/22/litmuschaos-showcase-chaos-experiments-in-a-helm-chart-test-suite/)\n- Jessica Cherry: [Test Kubernetes cluster failures and experiments in your terminal](https://opensource.com/article/21/6/kubernetes-litmus-chaos)\n- Yang Chuansheng(KubeSphere): [KubeSphere 部署 Litmus 至 Kubernetes 开启混沌实验](https://kubesphere.io/zh/blogs/litmus-kubesphere/)\n- Saiyam Pathak(Civo): [Chaos Experiments on Kubernetes using Litmus to ensure your cluster is production ready](https://www.civo.com/learn/chaos-engineering-kubernetes-litmus)\n- Andreas Krivas(Container Solutions):[Comparing Chaos Engineering Tools for Kubernetes Workloads](https://blog.container-solutions.com/comparing-chaos-engineering-tools)\n- Akram Riahi(WeScale):[Chaos Engineering : Litmus sous tous les angles](https://blog.wescale.fr/2021/03/11/chaos-engineering-litmus-sous-tous-les-angles/)\n- Prashanto Priyanshu(LensKart):[Lenskart’s approach to Chaos Engineering-Part 2](https://blog.lenskart.com/lenskarts-approach-to-chaos-engineering-part-2-6290e4f3a74e)\n- DevsDay.ru(Russian):[LitmusChaos at Kubecon EU '21](https://devsday.ru/blog/details/40746)\n\n\n## Adopters\n\nCheck out the \u003ca href=\"https://github.com/litmuschaos/litmus/blob/master/ADOPTERS.md\" target=\"_blank\"\u003eAdopters of LitmusChaos\u003c/a\u003e\n\n(_Send a PR to the above page if you are using Litmus in your chaos engineering practice_)\n\n## License\n\nLitmus is licensed under the Apache License, Version 2.0. See [LICENSE](./LICENSE) for the full license text. Some of the projects used by the Litmus project may be governed by a different license, please refer to its specific license.\n\n[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Flitmuschaos%2Flitmus.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Flitmuschaos%2Flitmus?ref=badge_large)\n\nLitmus Chaos is part of the CNCF Projects.\n\n[![CNCF](https://github.com/cncf/artwork/blob/main/other/cncf/horizontal/color/cncf-color.png)](https://landscape.cncf.io/?selected=litmus)\n\n## Important Links\n\n\u003ca href=\"https://docs.litmuschaos.io\"\u003e\n  Litmus Docs \u003cimg src=\"https://avatars0.githubusercontent.com/u/49853472?s=200\u0026v=4\" alt=\"Litmus Docs\" height=\"15\"\u003e\n\u003c/a\u003e\n\u003cbr\u003e\n\u003ca href=\"https://landscape.cncf.io/?selected=litmus\"\u003e\n  CNCF Landscape \u003cimg src=\"https://landscape.cncf.io/images/cncf-landscape-horizontal-color.svg\" alt=\"Litmus on CNCF Landscape\" height=\"15\"\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flitmuschaos%2Flitmus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flitmuschaos%2Flitmus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flitmuschaos%2Flitmus/lists"}