hawtio: A Java repository from chrisalbright

Introduction

Hawtio is a lightweight and modular Web console for managing Java applications.

Hawtio has lots of plugins such as: Apache ActiveMQ "Classic," Apache Camel, JMX, OSGi, Logs, Spring Boot, and Diagnostics. You can dynamically extend Hawtio with your own plugins or automatically discover plugins inside the JVM.

The only server side dependency (other than the static HTML/CSS/JS/images) is the excellent Jolokia library which has small footprint (around 300KB) and is available as a JVM agent, or comes embedded as a servlet inside the hawtio-default.war or can be deployed as an OSGi bundle.

Get Started

Running an executable JAR
Running a Spring Boot app
Deploying on OpenShift

For more details and other containers, see Get Started Guide.

Running an executable JAR

You can start up Hawtio on your machine using the following jbang command.

jbang app install hawtio@hawtio/hawtio
hawtio --help

Running a Spring Boot app

Attaching the Hawtio console to your Spring Boot app is simple.

Add io.hawt:hawtio-springboot to the dependencies in pom.xml:

<dependency>
  <groupId>io.hawt</groupId>
  <artifactId>hawtio-springboot</artifactId>
  <version>3.0-M1</version>
</dependency>

Enable the Hawtio and Jolokia endpoints by adding the following line in application.properties:
```
management.endpoints.web.exposure.include=hawtio,jolokia
spring.jmx.enabled=true
```

Now you should be able to run Hawtio in your Spring Boot app as follows:

mvn spring-boot:run

Opening http://localhost:8080/actuator/hawtio should show the Hawtio console.

See Spring Boot example for a working example app.

Contributing

We love contributions! Here are the resources on how to get you involved in Hawtio development.

Check out the GitHub issues for finding issues to work on.

License