Skip to content

Commit

Permalink
More human-friendly README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
piotr-yuxuan committed Sep 28, 2023
1 parent 039ac60 commit d4b2b3b
Show file tree
Hide file tree
Showing 5 changed files with 9 additions and 2 deletions.
11 changes: 9 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
# `springbootplayground`
# `spring-boot-playground`

This is a simple project to demonstrate usage of:
- Java 21 (LTS)
- Spring Boot
- React (single-page application)
- PostgreSQL

![](./doc/Spring playground.jpg)

# Getting Started

Expand Down Expand Up @@ -43,10 +44,14 @@ Now on your machine different services are available:
- Grafana: http://localhost:3000
- Prometheus: http://localhost:9090

![](./doc/OpenAPI.png)

Grafana dashboards:
- https://grafana.com/grafana/dashboards/6756-spring-boot-statistics/
- Ideally there would be a standard dashboard for endpoints and another for database connections.

![](./doc/Grafana.png)

# Load Simulation

A load simulation is described using the Java DSL. You can run it with Gatling:
Expand All @@ -57,6 +62,8 @@ mvn gatling:test

Of course it doesn't have a lot of meaning to run such simulation a local computer with a lot of different possible perturbation. An isolated, network-optimised environment in AWS is more repeatable. Still, it can give a rough, uneducated hint at the performance. Keep in mind that your local machine may have a limitation on the number of open file descriptors (`ulimit`), which further degrades the ability to simulate high load.

![](./doc/Gatling.png)

A note on AWS resources: instances should be in the same availability zone (ha ha), and Elastic Fabric Adapter network interface should help make the CPU and memory the limiting factors, not the network IO.

# Reference Documentation
Expand Down
Binary file added doc/Gatling.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/Grafana.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/OpenAPI.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/Spring playground.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit d4b2b3b

Please sign in to comment.