Skip to content
This repository has been archived by the owner on Dec 27, 2022. It is now read-only.
/ perses Public archive

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

License

Notifications You must be signed in to change notification settings

nick-kanakis/perses

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

99 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.