/perses

A project to cause (controlled) destruction on your jvm application

Primary LanguageJavaMIT LicenseMIT

Perses

Build Status License Gitter

Cause (controlled) destruction to your jvm application

Perses (Ancient Greek: Πέρσης) was the Titan god of destruction. His name is derived from the Ancient Greek word perthō ("to destroy")

What is the goal.

Perses allows you to dynamically inject failure/latency at the bytecode level, without the need to add any dependency or restart/deploy the target app. Just load 2 jars at the same enviroment the target JVM is running and execute java -jar perses-injector.jar <Target Application name>.

Perses is designed to enable developpers and QAs to easily reproduce & debug tricky production issues.

For more information about how Perses works under the hood, how to set everything up & how to use it please visit the wiki.

How to install

All jars are available here. Select the version that matches the target application.

  1. Add perses-agent.jar & perses-injector-jar-with-dependencies.jar in the same environment as the target application.
  2. Execute java -jar perses-injector.jar <TARGET APPLICATION NAME>.
  3. Execute java -jar perses.jar
  4. Visit localhost:8777

For more information about how Perses works under the hood, how to set everything up & how to use it please visit the wiki.