Skip to content

Commit 08bedd9

Browse files
smcvbsmcvb
committed
Merge branch '4.9'
# Conflicts: # README.md # axon-framework/monitoring/README.md
2 parents 7146c9f + d1559f5 commit 08bedd9

File tree

21 files changed

+186
-9
lines changed

21 files changed

+186
-9
lines changed

‎README.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Introduction
22

3+
> Legacy Documentation Warning!
4+
>
5+
> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
6+
> You can find the latter at https://docs.axoniq.io/
7+
>
8+
> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
9+
310
Welcome to the Axon Manual!
411

512
Axon provides the Axon Framework and the Axon Server to help build applications centered on three core concepts - CQRS \(Command Query Responsibility Segregation\) / Event Sourcing and DDD \(Domain Driven Design\).
@@ -13,7 +20,9 @@ There, you will find information about Axon training, support options, upcoming
1320
> **Monitoring with AxonIQ Console**
1421
>
1522
> We have built a platform that makes it very easy to monitor your Axon Framework applications. It measures everything in your applications, aggregates, metrics and processors.
23+
>
1624
> ![../../.gitbook/assets/console/graphs.png](../../.gitbook/assets/console/graphs.png)
25+
>
1726
> You can find more information on our [product page](https://www.axoniq.io/products/axoniq-console) or [log in directly](https://console.axoniq.io/).
1827
1928
## How to use this guide

‎architecture-overview/README.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Architecture Overview
22

3+
> Legacy Documentation Warning!
4+
>
5+
> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
6+
> You can find the latter at https://docs.axoniq.io/
7+
>
8+
> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
9+
310
Axon based applications follow an architectural pattern which is based on the principles of Domain-Driven Design \(DDD\), Command Query Responsibility Segregation \(CQRS\) and Event-Driven Architecture \(EDA\). The combination of these principles make Axon based applications more robust and adaptable to accommodate change required by the changes in our business domain.
411

512
Axon finds its use in both large monolithic applications, wherein the internal structure is essential to keep the monolith adaptable, as well as microservices, where the distributed nature of the system adds complexity.

‎axon-framework/introduction.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,13 @@
11
# Introduction
22

3-
This section of the reference guide intends to cover in detail the capabilities that the Axon Framework provides to help build applications based on [CQRS/DDD](../architecture-overview/#ddd-and-cqrs) and [Event Sourcing](../architecture-overview/event-sourcing.md)
4-
5-
> Breaking Changes in Axon Framework 4.7!
3+
> Legacy Documentation Warning!
64
>
7-
> Against our normal approach towards minor releases, we sadly had to introduce breaking changes between Axon Framework 4.6 and 4.7.
8-
> Our apologies for this.
5+
> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
6+
> You can find the latter at https://docs.axoniq.io/
97
>
10-
> To help you with your upgrade we have constructed a dedicated page [here](upgrading-to-4-7.md) that helps you on your path to upgrade to 4.7.
11-
> If you find any irregularities concerning your upgrade, be sure to reach out to us!
8+
> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
9+
10+
This section of the reference guide intends to cover in detail the capabilities that the Axon Framework provides to help build applications based on [CQRS/DDD](../architecture-overview/#ddd-and-cqrs) and [Event Sourcing](../architecture-overview/event-sourcing.md)
1211

1312
A summary of the various sub-sections is given below.
1413

‎axon-framework/monitoring/README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,9 @@ This section contains all information regarding metrics, tracing and monitoring
66
> **Monitoring with AxonIQ Console**
77
>
88
> We have built a platform that makes it very easy to monitor your Axon Framework applications. It measures everything in your applications, aggregates, metrics and processors.
9+
>
910
> ![../../.gitbook/assets/console/graphs.png](../../.gitbook/assets/console/graphs.png)
11+
>
1012
> You can find more information on our [product page](https://www.axoniq.io/products/axoniq-console) or [log in directly](https://console.axoniq.io/).
1113
1214
A summary of the various subsections is given below.

‎axon-server/administration/monitoring/diagnostics.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
When reaching out to AxonIQ for Axon Server support related questions, the support team needs information about the environment and its current state. Axon Server provides an endpoint that collects the relevant information into a zip file.
44

5-
The URL is `internal/diagnose/download`.
5+
The URL is `v1/diagnose/download` (in Axon Server versions before 2024.0 the URL is `internal/diagnose/download`).
66

77
The zip file contains the following information:
88

‎axon-server/introduction.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Introduction
22

3+
> Legacy Documentation Warning!
4+
>
5+
> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
6+
> You can find the latter at https://docs.axoniq.io/
7+
>
8+
> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
9+
310
Axon Server is the flagship product of AxonIQ, and companion product to the Open Source Axon Framework. Axon Server itself is available in two editions, Standard and Enterprise, with Axon Server Standard Edition \(SE\) available under the AxonIQ Open Source license, while Axon Server Enterprise Edition \(EE\) is licensed as a commercial product with a full range of support options.
411

512
This section of the reference guide covers all aspects around Setup/Administration/Security/Tuning and Configuration of your Axon Server deployment \(SE / EE\)

‎extensions/jgroups.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# JGroups
22

3+
> Legacy Documentation Warning!
4+
>
5+
> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
6+
> You can find the latter at https://docs.axoniq.io/
7+
>
8+
> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
9+
310
JGroups is an alternative approach to distributing command bus \(commands\) besides Axon Server.
411

512
The `JGroupsConnector` uses \(as the name already gives away\) [JGroups](http://www.jgroups.org/) as the underlying discovery and dispatching mechanism.

‎extensions/jobrunrpro.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# JobRunrPro
22

3+
> Legacy Documentation Warning!
4+
>
5+
> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
6+
> You can find the latter at https://docs.axoniq.io/
7+
>
8+
> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
9+
310
The purpose of this extension is to leverage some features only available in the Pro version of [JobRunr](https://www.jobrunr.io/en/documentation/pro/).
411
Only the Pro version allows to search existing jobs by status and label. This is required for the deadline manager to implement the `cancelAll` methods.
512
The [deadline managers](../axon-framework/deadlines/deadline-managers.md) section has more in depth information on deadline managers.

‎extensions/kafka.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Kafka
22

3+
> Legacy Documentation Warning!
4+
>
5+
> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
6+
> You can find the latter at https://docs.axoniq.io/
7+
>
8+
> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
9+
310
Apache Kafka is a very popular system for publishing and consuming events. Its architecture is fundamentally different from most messaging systems and combines speed with reliability.
411

512
Axon provides an extension dedicated to _publishing_ and _receiving_ event messages from Kafka. The Kafka Extension should be regarded as an alternative approach to distributing events, besides \(the default\) Axon Server. It's also possible to use the extension to stream events from Kafka to Axon server, or the other way around.

‎extensions/kotlin.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Kotlin
22

3+
> Legacy Documentation Warning!
4+
>
5+
> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
6+
> You can find the latter at https://docs.axoniq.io/
7+
>
8+
> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
9+
310
[Kotlin](https://kotlinlang.org/) is a programming language which interoperates fully with Java and the JVM. As Axon is written in Java it can be used in conjunction with Kotlin too, offering a different feel when using the framework.
411

512
Some of Axon's API's work perfectly well in Java, but have a rather awkward feel when transitioning over to Kotlin. The goal of the [Kotlin Extension](https://github.com/AxonFramework/extension-kotlin) is to remove that awkwardness, by providing [inline and reified](https://kotlinlang.org/docs/reference/inline-functions.html) methods of Axon's API.

‎extensions/mongo.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Mongo
22

3+
> Legacy Documentation Warning!
4+
>
5+
> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
6+
> You can find the latter at https://docs.axoniq.io/
7+
>
8+
> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
9+
310
The `MongoEventStorageEngine` has an `@PostConstruct` annotated method, called `ensureIndexes` which will generate the indexes required for correct operation. That means, when running in a container that automatically calls `@PostConstruct` handlers, the required unique index on "Aggregate Identifier" and "Event Sequence Number" is created when the event store is created.
411

512
Note that there is always a balance between query optimization and update speed. Load testing is ultimately the best way to discover which indices provide the best performance.

‎extensions/reactor/reactor.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Reactor
22

3+
> Legacy Documentation Warning!
4+
>
5+
> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
6+
> You can find the latter at https://docs.axoniq.io/
7+
>
8+
> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
9+
310
Overlooking Axon Frameworks architecture, you can notice that in general systems using the framework are "Message Driven", "Responsive", "Resilient" and "Elastic".
411
According to [Reactive Manifesto](https://www.reactivemanifesto.org/), the same holds for Reactive Systems in general.
512

‎extensions/spring-amqp.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Spring AMQP
22

3+
> Legacy Documentation Warning!
4+
>
5+
> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
6+
> You can find the latter at https://docs.axoniq.io/
7+
>
8+
> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
9+
310
Spring AMQP is an alternative approach to distributing events, besides Axon Server which is the default.
411

512
Axon provides out-of-the-box support to transfer events to and from an AMQP message broker, such as [RabbitMQ](https://www.rabbitmq.com/).

‎extensions/spring-aot.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Spring Ahead of Time
22

3+
> Legacy Documentation Warning!
4+
>
5+
> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
6+
> You can find the latter at https://docs.axoniq.io/
7+
>
8+
> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
9+
310
[Spring AOT processing](https://docs.spring.io/spring-boot/docs/current/reference/html/native-image.html#native-image.introducing-graalvm-native-images.understanding-aot-processing)
411
is part of the process to create a native binary from a Spring (Boot) application. This extension will help in adding a
512
lot of hints which are needed for Axon Framework. Please note this extension can only be used with Spring Boot 3, as

‎extensions/spring-cloud.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Spring Cloud
22

3+
> Legacy Documentation Warning!
4+
>
5+
> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
6+
> You can find the latter at https://docs.axoniq.io/
7+
>
8+
> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
9+
310
Spring Cloud is an alternative approach to distributing the command bus \(commands\), besides Axon Server as the default.
411

512
The Spring Cloud Extension uses the service registration and discovery mechanism described by [Spring Cloud](https://spring.io/projects/spring-cloud) for distributing the command bus.

‎extensions/tracing.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Tracing
22

3+
> Legacy Documentation Warning!
4+
>
5+
> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
6+
> You can find the latter at https://docs.axoniq.io/
7+
>
8+
> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
9+
310
This extension provides functionality to trace command, event and query messages flowing through an Axon application by providing a specific implementation of the `CommandGateway`, `QueryGateway`, `MessageDispatchInterceptor` and `MessageHandlerInterceptor`. The [Open Tracing](https://opentracing.io/) standard is used to provide tracing capabilities, which thus allows usage of several Open Tracing implementations.
411

512
With this instrumentation, we can chain synchronous and asynchronous commands and queries, all belonging to the same parent span. A request can be visualized and analysed across Axon clients, command handlers, query handlers and event handlers, when running together or decomposed and deployed as separate parts \(distributed\).

‎getting-started/quick-start.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Quick Start
22

3+
> Legacy Documentation Warning!
4+
>
5+
> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
6+
> You can find the latter at https://docs.axoniq.io/
7+
>
8+
> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
9+
310
Axon provides a _**Quick Start Toolkit**_ to familiarize yourself with the setup required for Axon Framework and Axon Server SE \(Standard Edition\).
411

512
The only pre-requisite to run the Quick Start is to have a Java 8+ JRE in your system.

‎release-notes/README.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Release Notes
22

3+
> Legacy Documentation Warning!
4+
>
5+
> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
6+
> You can find the latter at https://docs.axoniq.io/
7+
>
8+
> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
9+
310
This section details out all the release notes for the Major/Minor versions released up to date for both the Axon Framework and Axon Server.
411

512
| Section | |

‎release-notes/rn-axon-server/README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,8 @@ The release notes section for the Axon Server for all major/minor releases.
44

55
| Release Type | Version |
66
|:-------------------------------|:-------------------------------------------------|
7-
| _**Major**_ | [2024.0](rn-as-major-releases.md#release-2024.0) |
7+
| _**Major**_ | [2024.1](rn-as-major-releases.md#release-2024.1) |
8+
| | [2024.0](rn-as-major-releases.md#release-2024.0) |
89
| | [2023.2](rn-as-major-releases.md#release-2023.2) |
910
| | [2023.1](rn-as-major-releases.md#release-2023.1) |
1011
| | [2023.0](rn-as-major-releases.md#release-2023.0) |

‎release-notes/rn-axon-server/rn-as-major-releases.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,32 @@
11
# Major Releases
22

3+
## Release 2024.1
4+
5+
### Persistent streams
6+
7+
Persistent streams provide the option to open an event stream from a client and let Axon Server track the progress. This
8+
was already available as a preview version in 2024.0, but is now available by default. Persistent streams are supported
9+
in Axon Framework 4.10 as an alternative to tracking or pooled streaming event processors.
10+
11+
For more information see [subcribing event processor](https://library.axoniq.io/axon_framework_old_ref/events/event-processors/subscribing.html) in the Axon Framework section.
12+
13+
### Bug fixes and improvements
14+
15+
- Prevent stale threads when an Axon Server node closes the connection to another node
16+
- Clean up metrics from disconnected clients
17+
- prevent WARN log messages when a query completed message was received from an unexpected client
18+
- Allow context with ephemeral events without a license
19+
- Fix for listing event processors when there are more than 512 event processors
20+
21+
### Docker image changes
22+
23+
The default Java version for the Docker images has changed from Java 11 to Java 17. This means that the docker images with tag "latest", "latest-nonroot", "2024.1.0", and "2024.1.0-nonroot" use Java 17. Java 11 based images are still available with the "-jdk-11" extensions in the tag name.
24+
25+
### Dependency updates
26+
27+
- gRPC version updated to 1.65.1
28+
29+
330
## Release 2024.0
431

532
### Database Update

0 commit comments

Comments
 (0)