chaosmonkey README

The project's README from github.com/Netflix/chaosmonkey. As one markdown file: README.md.

logo

NetflixOSS Lifecycle Build Status GoDoc GoReportCard

Chaos Monkey randomly terminates virtual machine instances and containers that run inside of your production environment. Exposing engineers to failures more frequently incentivizes them to build resilient services.

See the documentation for info on how to use Chaos Monkey.

Chaos Monkey is an example of a tool that follows the Principles of Chaos Engineering.

Requirements

This version of Chaos Monkey is fully integrated with Spinnaker, the continuous delivery platform that we use at Netflix. You must be managing your apps with Spinnaker to use Chaos Monkey to terminate instances.

Chaos Monkey should work with any backend that Spinnaker supports (AWS, Google Compute Engine, Azure, Kubernetes, Cloud Foundry). It has been tested with AWS, GCE, and Kubernetes.

Install locally

To install the Chaos Monkey binary on your local machine:

go get github.com/netflix/chaosmonkey/cmd/chaosmonkey

How to deploy

See the docs for instructions on how to configure and deploy Chaos Monkey.

Support

Simian Army Google group.

chaosmonkey (Netflix/chaosmonkey)

Searching Database…

What is this?Chaos Monkey is a resiliency tool from Netflix that randomly terminates virtual machine instances and containers in your production environment, so engineers face failures often enough that they build services able to tolerate them.
Wait, it sabotages my production on purpose?Yes — it deliberately kills running production instances. The tool follows the Principles of Chaos Engineering: injecting real failures regularly so weaknesses show up before a real outage finds them.
How do I get it running?Install the Chaos Monkey binary on your local machine, then follow the documentation to configure and deploy it. It is written in Go, so it ships as a single binary.
Can I just point it at any infrastructure, or is there a catch?There is a catch: this version is fully integrated with Spinnaker, the continuous delivery platform Netflix uses, and you must be managing your apps through Spinnaker for Chaos Monkey to terminate instances.
Which clouds does it actually work with?It should work with any backend that Spinnaker supports: AWS, Google Compute Engine, Azure, Kubernetes and Cloud Foundry. So far it has been tested with AWS, GCE and Kubernetes.
Why would anyone build a tool that breaks production on purpose?Because frequent, controlled failures are the cheapest way to make services resilient. Randomly terminating instances turns outages into routine events that engineers design for, instead of rare emergencies they discover at 3am.
What is the Simian Army?The Simian Army is the Netflix family of failure-testing tools that Chaos Monkey belongs to; the README routes support questions to the Simian Army Google group.
Is it free to use?Yes — Chaos Monkey is open source under the Apache-2.0 license, and you run it in your own environment at no cost beyond the infrastructure it manages.
Creator
Netflix
Size
2 MB
Stars
17.2K
Age
9y
Commits · 90 Days