We at codecentric Netherlands love Axon Framework and how easy it makes Event-Sourcing and CQRS. However, it's not always possible or desirable to run Axon Server so you can easily manage events and tokens.
This is where Axon Open Admin comes in. It hooks into the JPA or Jdbc Tokenstore and lets you the containing tokens, such as splitting, merging, and the likes. Clone the project and fire up the demo to see it in real life, or just add the Starter to your Spring Boot application!
The application is smart enough to determine what actions need to be taken at the right moment. It will also notify you of the progress.
You can also explore you Eventstore in Axon Admin. You can either tail the event log (last x events) or you can specify a date range to retrieve.
The date range preview also comes with an approximation how many events will be retrieved.
Searching inside events is currently not supported, but raise an issue if you'd like that functionality.
Add the following dependency to your maven project:
<dependency>
<groupId>nl.codecentric.axon-open-admin</groupId>
<artifactId>axon-open-admin</artifactId>
<version>0.0.10</version>
</dependency>
When your application now boots you can access the administration interface at /(your-context-path)/axon-admin/. Enjoy!
We recommend configuring Spring Boot Security to secure these endpoints, as they are open to abuse.
There are a few things to keep in mind if you are planning on using this library:
- It only supports Axon 4.5. We are currently not planning on supporting older versions, since the working of this library depends on the private API of Axon Framework at the moment.
- There is a known issue with
spring-boot-devtools. With devtools enabled your application will fail to boot. - All nodes need to be reachable from the front-end you are accessing. If some other node is behind another load balancer, the application will not be able to take actions.
At codecentric we blog about certain challenges or opportunities we encounter when using Axon Framework. Currently we have the following published:
- Replaying for a single aggregate in Axon Framework
- Dealing with personal data in Axon Framework
- Taking advantage of Metadata in Axon Framework
Take a look if you're interested. Happy reading!