-
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Signed-off-by: Felipe Bonezi <[email protected]>
- Loading branch information
1 parent
4fc46d3
commit e5bee07
Showing
1 changed file
with
58 additions
and
13 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -2,52 +2,97 @@ | |
|
||
[![CI](https://github.com/felipebonezi/play-actuator/actions/workflows/continouos-integration.yml/badge.svg)](https://github.com/felipebonezi/play-actuator/actions/workflows/continouos-integration.yml) | ||
[![Renovate](https://img.shields.io/badge/renovate-enabled-brightgreen.svg)](https://renovatebot.com) | ||
[![Version](https://img.shields.io/github/v/release/felipebonezi/play-actuator?logo=java)](https://github.com/felipebonezi/play-actuator/releases) | ||
[![CLA assistant](https://cla-assistant.io/readme/badge/felipebonezi/play-actuator)](https://cla-assistant.io/felipebonezi/play-actuator) | ||
[![Licence](https://img.shields.io/github/license/felipebonezi/play-actuator?color=blue)](https://github.com/felipebonezi/play-actuator/blob/main/LICENSE) | ||
|
||
Play! Framework plugin with actuator actions about your application. | ||
Play! Framework plugin with actuator routes that gives you infos about application uptime. | ||
You may consider some indicators to define what is `Up` or `Down` for your (check more info at `Health endpoint details`). | ||
|
||
This project is inspired by `Spring Boot Actuator` architecture | ||
([Check this post to know more about it](https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/#actuator)) | ||
. | ||
|
||
## How to use? | ||
[![Version](https://img.shields.io/github/v/release/felipebonezi/play-actuator?logo=java)](https://github.com/felipebonezi/play-actuator/releases) | ||
|
||
You must import as project dependency in your `build.sbt` file. | ||
You can import as a project dependency in your `build.sbt` file. | ||
|
||
```sbt | ||
libraryDependencies ++= "io.github.felipebonezi" % "play-actuator" % "(version)" | ||
libraryDependencies ++= "io.github.felipebonezi" %% "play-actuator" % "(version)" | ||
``` | ||
|
||
After that, you need to configure `play.actuator.ActuatorRouter` into project `conf/routes` file. | ||
|
||
``` | ||
```scala | ||
-> /actuator play.actuator.ActuatorRouter | ||
``` | ||
|
||
Run your project and check Actuators endpoints - e.g. `/actuator/health`. | ||
|
||
## Actuator endpoints | ||
|
||
| Endpoint ID | Description | Path | Ready to use | | ||
|-------------|----------------------------------------------|---------------------|--------------| | ||
| health | Displays your application’s health status. | `/actuator/health` | ✔️ | | ||
| info | Displays information about your application. | `/actuator/info` | ✖️ | | ||
| logfile | Returns the contents of the log file. | `/actuator/logfile` | ✖️ | | ||
Below we have all project endpoints available on this project. | ||
|
||
| Endpoint ID | Description | Path | Ready to use? | | ||
|-------------|----------------------------------------------|---------------------|---------------| | ||
| health | Displays your application’s health status. | `/actuator/health` | ✔️ | | ||
| info | Displays information about your application. | `/actuator/info` | ✖️ | | ||
| logfile | Returns the contents of the log file. | `/actuator/logfile` | ✖️ | | ||
|
||
## Health endpoint details | ||
|
||
You can check all health indicators by simple activating each configuration. | ||
|
||
### Disk Space Indicator | ||
|
||
Show to you the total, free and usable disk space. | ||
|
||
**No need of any extra dependency, it's under the hood.** | ||
|
||
`play.actuator.health.indicators.diskSpace = true` | ||
|
||
### JDBC Indicator | ||
### Database Indicator | ||
|
||
Show to you information about your database using JDBC or Slick connection. | ||
|
||
`play.actuator.health.indicators.database = true` | ||
|
||
It depends on which dependency indicator you'll use. | ||
**You need to choose only one dependency to work with!** | ||
|
||
#### JDBC | ||
```sbt | ||
libraryDependencies ++= "io.github.felipebonezi" %% "play-actuator-jdbc-indicator" % "(version)" | ||
``` | ||
|
||
`play.actuator.health.indicators.jdbc = true` | ||
#### Slick | ||
```sbt | ||
libraryDependencies ++= "io.github.felipebonezi" %% "play-actuator-slick-indicator" % "(version)" | ||
``` | ||
|
||
### Redis Indicator | ||
|
||
Show to you information about your Redis connection. | ||
**For now, it only works with [play-redis](https://github.com/KarelCemus/play-redis) as your connector.** | ||
|
||
`play.actuator.health.indicators.redis = true` | ||
|
||
## Scala compatibility | ||
|
||
This project is compatible with Scala `2.12` and `2.13`, so you need to use the right version. | ||
Be aware that we're considering to drop `2.12` compatibility, so, we advise you to use `2.13` as your preferred version. | ||
|
||
## Sponsors & Backers | ||
|
||
If you find Play Actuator useful to you, please consider [become a backer](https://github.com/sponsors/felipebonezi). | ||
If your company seems to feel the same, please consider [become a sponsor](https://github.com/sponsors/felipebonezi). | ||
|
||
<div align="center"> | ||
<a href="https://opencollective.com/felipebonezi" target="_blank"> | ||
<img src="https://opencollective.com/felipebonezi/donate/[email protected]?color=blue" width="250" /> | ||
</a> | ||
</div> | ||
|
||
### Thank you to all our backers on OpenCollective! | ||
|
||
<a href="https://opencollective.com/felipebonezi#section-contributors"><img src="https://opencollective.com/felipebonezi/organizations.svg?width=890&button=false&avatarHeight=46"></a> | ||
<a href="https://opencollective.com/felipebonezi#section-contributors"><img src="https://opencollective.com/felipebonezi/individuals.svg?width=890&button=false&avatarHeight=46"></a> |