• This repository has been archived on 27/Dec/2022
  • Stars
    star
    66
  • Rank 468,167 (Top 10 %)
  • Language
    Java
  • License
    MIT License
  • Created over 5 years ago
  • Updated over 3 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

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

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.