Skip to content
This repository was archived by the owner on Dec 27, 2022. It is now read-only.

nick-kanakis/perses

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

92 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Perses

Build Status License Gitter

A project to cause (controlled) destruction to a 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 with surgical precision, without the need to add any dependency or even restart/deploy the target app, just load 2 jars at the same enviroment the target JVM is running and run a simple command java -jar perses-injector.jar <Target Application name>.

Perses is designed with Principles of Chaos Engineering in mind and in order 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.

Perses status

Perses is under development. Please feel free to raise any issues you might encounter.

JDK Version Status Release
8 Working 0.0.8
9 Working 0.9.0
10 Working 0.9.0
11 Working 0.9.0
12 Working 0.9.0

What is the goal.

Perses is a tool designed to give you insides to your jvm application by dynamically injecting failure/latency at the bytecode level with surgical precision. Perses is designed with Principles of Chaos Engineering in mind.

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.

About

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

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •