Skip to main content

Chaos engineering toolkit

Project description

# chaostoolkit

[![Build Status](https://travis-ci.org/chaostoolkit/chaostoolkit.svg?branch=master)](https://travis-ci.org/chaostoolkit/chaostoolkit) [![Docker Stars](https://img.shields.io/docker/stars/_/chaostoolkit.svg)](https://hub.docker.com/r/chaostoolkit/chaostoolkit/) [![Python versions](https://img.shields.io/pypi/pyversions/chaostoolkit.svg)](https://www.python.org/) [![Requirements Status](https://requires.io/github/chaostoolkit/chaostoolkit/requirements.svg?branch=master)](https://requires.io/github/chaostoolkit/chaostoolkit/requirements/?branch=master) [![Has wheel](https://img.shields.io/pypi/wheel/chaostoolkit.svg)](http://pythonwheels.com/)

A chaos engineering toolkit for your system and microservices.

## Context and Purpose

The chaostoolkit aims at making it simple and straightforward to run experiments against your live system to observe its behavior and learn about potential weaknesses.

The idea is that your system is complex and no matter how well you planned

and designed, it would be challenging to claim anyone knows how it would react under certain conditions.

Following in the steps of giants like Netflix or LinkedIn, we believe in the [principles of chaos engineering][principles]. Creating the conditions to stress your system should help your team become better at handling those situations while allowing your system to evolve nicely.

[principles]: http://principlesofchaos.org/

The chaostoolkit is, as its name implies, a toolkit for you to run those experiments at the platform and/or application level. For instance, by killing a microservice, your experiment could probe the system for other services and see the impact of tsuch a failure.

The goal is not to break things, though this is one way to run an experiment, but to create the conditions of stress that can make you learn from your system.

## Getting Started

chaostoolkit is a command line tool that runs your experiment, then generates a report to share with your team for discussion.

Running an experiment is as simple as:

` $ chaos run experiment.json `

chaostoolkit takes your experiment as a description file, encoded in JSON, and runs its steps sequentially.

Please, read the main documentation to [install chaostoolkit][install] and learn more about it.

[install]: https://chaostoolkit.github.io/chaostoolkit/usage/install/

## Learn More

chaostoolkit is open and you are more than welcome to discuss and share your experiments with its community.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chaostoolkit-0.1.9.tar.gz (8.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

chaostoolkit-0.1.9-py2.py3-none-any.whl (13.8 kB view details)

Uploaded Python 2Python 3

File details

Details for the file chaostoolkit-0.1.9.tar.gz.

File metadata

  • Download URL: chaostoolkit-0.1.9.tar.gz
  • Upload date:
  • Size: 8.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for chaostoolkit-0.1.9.tar.gz
Algorithm Hash digest
SHA256 5acd8603b4ce18ec5ff3d4641e7616604d740f8e1bb3fcc5c1eae785613bd82e
MD5 68704f261af41f1e137fa7e39e1fd3f2
BLAKE2b-256 3980ce737d8adc6fdc6acacc45505de4e1605645329238edb3c35b2db2b7d41d

See more details on using hashes here.

File details

Details for the file chaostoolkit-0.1.9-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for chaostoolkit-0.1.9-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 6f84ce5a6e3b86e11ffabbb8b324d1715bc98873e202b83b69b5bb20448f5dcb
MD5 3787e3f5c477c47802d1cf11bdbd5c61
BLAKE2b-256 5de74686a10b204b0a69058bf21a28cc343e80946cd397047df9f66ca44245e7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page