This is a simple admin interface for Spring Boot applications.

This application provides a simple GUI to administrate Spring Boot applications in some ways. At the moment it provides the following features for every registered application.

• Show name/id and version number
• Show health status
• Download main logfile
• Show details, like
• JVM & memory metrics
• Counter & gauge Metrics
• Datasource Metrics
• View Java, System- & Environment-properties
• Support for Spring Clouds postable /env- &/refresh-endpoint
• Easy loggerlevel management (for Logback)
• Interact with JMX-Beans
• View Threaddump
• View Traces
• Desktop notification on status change

Add the following dependency to your pom.xml.

<dependency>
	<groupId>de.codecentric</groupId>
	<artifactId>spring-boot-admin-server</artifactId>
	<version>1.2.1</version>
</dependency>
<dependency>
	<groupId>de.codecentric</groupId>
	<artifactId>spring-boot-admin-server-ui</artifactId>
	<version>1.2.1</version>
</dependency>

Create the Spring Boot Admin Server with only one single Annotation.

@Configuration
@EnableAutoConfiguration
@EnableAdminServer
public class Application {
	public static void main(String[] args) {
		SpringApplication.run(Application.class, args);
	}
}

See also the example project in this repository.

For configuring Hazelcast support see spring-boot-admin-server or hazelcast-example project

To get all your boot applications shown in spring boot admin you have two choices:

1. either you include the spring-boot-admint-starter-client into your applications

or

2. you add a DiscoveryClient (e.g. Eureka) to your spring boot admin server.

Note: If you don't include the spring-boot-admin-starter-client the logfile won't be availible, due to the fact that the logfile endpoint won't be exposed.

Each application that want to register itself to the admin application has to include the spring-boot-admin-starter-client as dependency. This starter JAR includes some AutoConfiguration features that includes registering tasks, controller, etc.

<dependency>
	<groupId>de.codecentric</groupId>
	<artifactId>spring-boot-admin-starter-client</artifactId>
	<version>1.2.1</version>
</dependency>

Inside your configuration (e.g. application.properties) you also have to define the URL of the Spring Boot Admin Server, e.g.

spring.boot.admin.url=http://localhost:8080

For all configuration options see spring-boot-starter-admin-client

Just add spring-clouds @EnableDiscoveryClient annotation and include an appropriate implementation (e.g. Eureka) to your classpath.

@Configuration
@EnableAutoConfiguration
@EnableDiscoveryClient
@EnableAdminServer
public class SpringBootAdminApplication {
	public static void main(String[] args) {
		SpringApplication.run(SpringBootAdminApplication.class, args);
	}
}

<dependency>
	<groupId>org.springframework.cloud</groupId>
	<artifactId>spring-cloud-starter-eureka</artifactId>
	<version>1.0.1.RELEASE</version>
</dependency>

See the sample discovery sample project

In order to build spring-boot-admin you need to have node.js and npm on your PATH.

mvn clean package

mvn build-helper:parse-version versions:set -DnewVersion=${parsedVersion.majorVersion}.${parsedVersion.minorVersion}.${parsedVersion.incrementalVersion}
mvn -Psign-artifacts clean deploy

Example:

mvn build-helper:parse-version versions:set versions:commit -DnewVersion=1.0.0-SNAPSHOT