Skip to main content

Chaos engineering toolkit reporting library

Project description

A general purpose reporting generator for Chaos Toolkit

Build, Test, and Lint

The Chaos Toolkit reporting extension library.


The purpose of this library is to provide reporting support to the Chaos Toolkit experiment results.


The library takes the journal generated by the chaos run command and transforms into a human friendly report. The report can be a standalone PDF or HTML document.


Install this package as any other Python packages:

$ pip install -U chaostoolkit-reporting

Notice that this draws a few dependencies:

Some of them are LGPL v3 licensed.

You will also need to install some additional dependencies that the chaos report command relies upon.


Once installed, a new report subcommand will be made available to the chaos command, use it as follows:

$ chaos report --export-format=html5 journal.json report.html

or, for a PDF document:

$ chaos report --export-format=pdf journal.json report.pdf

You can also generate a single report from many journals at once:

$ chaos report --export-format=pdf journal-1.json journal-2 journal-3 report.pdf

Or more succinctly:

$ chaos report --export-format=pdf journal-*.json report.pdf

Download a Docker Image

As the dependencies for this plugin can be difficult to get right, we also provide a docker image - note that this image is rather big with 1.4Gb to pull. You can install Docker from the Docker Hub.

$ docker pull chaostoolkit/reporting

Use a Docker container

To generate a PDF report using the Docker image you must first ensure that you are running the command from where the journal.json file, generated during an experiment run, can be found. To check for this you can run:

$ ls

And you should see the journal.json file:


Now you can run the docker command:

$ docker run \
    --user `id -u` \
    -v `pwd`:/tmp/result \
    -it \

This will create chaostoolkit.log and report.pdf files in this directory.

$ ls
chaostoolkit.log   journal.json   report.pdf

The report.json file will be owned by the user id returned by the command id -u, it should be your user. The reason we specify a user is that, by default, the container runs as root and the image doesn't make a guess about which user will run the container. If you don't have the id command you can set the value manually as follows instead: --user 1000:1000 assuming both your user and group ids are 1000.

The default command of the image is equivalent to running this without a container:

$ chaos report --export-format=pdf journal.json report.pdf

If you wish to override that command, pass the chaos report parameters as follows:

$ docker run \
    --user `id -u` \
    -v `pwd`:/tmp/result \
    -it \
    chaostoolkit/reporting -- report --export-format=html5 journal.json report.html

And the same files will be created:

$ ls
chaostoolkit.log   journal.json   report.pdf


Contributors to this project are welcome as this is an open-source effort that seeks discussions and continuous improvement.

From a code perspective, if you wish to contribute, you will need to run a Python 3.7+ environment. Then, fork this repository and submit a PR. The project cares for code readability and checks the code style to match best practices defined in PEP8. Please also make sure you provide tests whenever you submit a PR so we keep the code reliable.

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-reporting-0.17.1.tar.gz (28.5 kB view hashes)

Uploaded Source

Built Distribution

chaostoolkit_reporting-0.17.1-py2.py3-none-any.whl (29.5 kB view hashes)

Uploaded Python 2 Python 3

Supported by

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