hmrc / play-health

A health monitor endpoint for Play applications

GitHub
Version Matrix

#Play Health Plugin

Apache-2.0 license

Build Status Download

Plugin to provide common health check functionality for Play +2.2.3 projects.

##Endpoints

This adds two endpoints:

     /ping/ping     - Returns 200 and an empty body
	 /admin/details - Returns information about the running service

##Setup

Add the jar to the projects dependencies:

    "uk.gov.hmrc" %% "play-health" % "[INSERT VERSION]"

For Java 7 use versions <= 0.8.0

Add plugin to play.plugins:

    {priority}:uk.gov.hmrc.play.health.HealthPlugin

Additionally, add the following to the routes file:

    ->     /                                    health.Routes

Configuration

The plugin expects to find the apps name in the application.conf under the key appName. For the /admin/details endpoint to work as expected, the applications manifest.mf must include a key Implementation-Title with the same value as appName.

License

This code is open source software licensed under the Apache 2.0 License.

Documentation

Markdown Badge

Create badge

×
Markdown:
[![play-health Scala version support](https://index.scala-lang.org/hmrc/play-health/play-health/latest-by-scala-version.svg)](https://index.scala-lang.org/hmrc/play-health/play-health)
libraryDependencies += "uk.gov.hmrc" %% "play-health" % "0.2.0"
Ammonite REPL 
import $ivy.`uk.gov.hmrc::play-health:0.2.0`
<dependency>
  <groupId>uk.gov.hmrc</groupId>
  <artifactId>play-health_2.10</artifactId>
  <version>0.2.0</version>
</dependency>
compile group: 'uk.gov.hmrc', name: 'play-health_2.10', version: '0.2.0'
Mill build tool 
ivy"uk.gov.hmrc::play-health:0.2.0"
Try online with Scastie
Try on Scastie

Statistics

Contributors

License

5 Dependencies

Java Dependencies