https://github.com/nick-kanakis/perses

A project to cause (controlled) destruction on your jvm application
https://github.com/nick-kanakis/perses

chaos-engineering jvm

Last synced: 2 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/nick-kanakis/perses
• Owner: nick-kanakis
• License: mit
• Archived: true
• Created: 2019-04-11T16:37:52.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2021-08-02T04:34:09.000Z (over 3 years ago)
• Last Synced: 2024-07-31T18:01:59.194Z (5 months ago)
• Topics: chaos-engineering, jvm
• Language: Java
• Homepage:
• Size: 253 KB
• Stars: 65
• Watchers: 6
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-java - Perses - Dynamically injects failure/latency at the bytecode level according to principles of chaos engineering. (Projects / Bytecode Manipulation)
• awesome-java-zh - Perses - 根据混沌工程的原理在字节码级别动态注入故障/延迟。 (项目 / 字节码操作)
• awesome-chaos-engineering - Perses - A project to cause (controlled) destruction to a JVM application. (3. Fault Injection / Languages)
• awesome-java - Perses - Dynamically injects failure/latency at the bytecode level according to principles of chaos engineering. (Projects / Bytecode Manipulation)

README

        
# Perses

[![Build Status](https://travis-ci.org/nicolasmanic/perses.svg?branch=master)](https://travis-ci.org/nicolasmanic/perses)

[![License](https://img.shields.io/pypi/l/ansicolortags.svg)](https://github.com/nicolasmanic/perses/blob/master/LICENSE)

[![Gitter](https://badges.gitter.im/perses-app/community.svg)](https://gitter.im/perses-app/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)

## 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 `. 

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](https://github.com/nicolasmanic/perses/wiki).

### How to install

All jars are available [here](https://github.com/nicolasmanic/perses/releases). 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 `.

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](https://github.com/nicolasmanic/perses/wiki).