Skip to main content

New Offset Diagnostics

· 2 min read
CEO and Co-Founder at Actyx

Local-first software is magical in that it almost always works — at least locally. With Actyx this is possible because Actyx is partition tolerant, i.e. a network issue does not immediately take everything down.

This also means that twins and applications aren't always in sync. And sometimes it can get a little tricky understanding where nodes stand with regard to synchronizing with each other.

That is why we are now releasing Offset Diagnostics in the Actyx Node Manager.

offsets-diagnostics

Actyx Node Manager 2.4.0 introduces two new features to help you better understand what is happening:

  • Find out which event streams a node has synchronized, and up to where.
  • Easily see how event synchronization is progressing in a swarm of nodes.
Offsets... what do you mean?

If you aren't familiar with event streams or offsets, have a look at the Event Streams Guide.

Which event streams does my node know?#

A new tab called Offsets is now available on the Node Details screen. This shows all event streams known by the node as well as the current offsets:

Offset details for each node

Additionally, the number of events the node knows it must get, but hasn't gotten yet is also shown where applicable.

How about the swarm as a whole?#

Under the Diagnostics screen a new tab called Offset Matrix is now available. This shows a matrix of all nodes configured in the Node Manager:

An example offset matrix in the Actyx Node Manager

Each row of the matrix shows how many events a node holds from all other connected nodes.

The color of the cells reflects the level of synchronization. A red cell would imply a large number of missing events, whereas a green cell means the node is completely up to date.

Requires Actyx 2.1.0#

This functionality is only available from nodes running Actyx 2.1.0 and above. If you connect to a node running an older version, you will see the following notice:

Notice when offsets aren't support by the Actyx version

Questions or suggestions#

We developed this feature based on user feedback. If you have questions or further suggestions, please don't hesitate to post in our Community Forum.