Akka.DistributedData 1.5.0-beta1

Akka.NET

Akka.NET logo

Gitter

Akka.NET is a .NET port of the popular Akka project from the Scala / Java community. We are an idiomatic .NET implementation of the actor model built on top of the .NET Common Language Runtime.

Akka.NET is a .NET Foundation project.

.NET Foundation Logo

How is Akka.NET Used?

Akka.NET can be used in-process or inside large, distributed real-time systems; we support a wide variety of use cases.

Akka.NET can be used to solve the following types of problems:

  1. Concurrency - Akka.NET actors only process messages one-at-a-time and they do so in first in, first out (FIFO) order; this means that any application state internal to an actor is automatically thread-safe without having to use locks or any other shared-memory synchronization mechanisms.
  2. Stream Processing - Akka.NET actors and Akka.Streams make it easy to build streaming applications, used for processing incoming streams of data or incoming streams of live events such as UI or network events inside native applications.
  3. Event-Driven Programming - actors make it easy to build event-driven applications, as actors' message-processing routines naturally express these types of designs.
  4. Event Sourcing and CQRS - Akka.Persistence, used by actors to make their state re-entrant and recoverable across restarts or migrations between nodes, natively supports event sourcing. Akka.Persistence.Query can be used to compute CQRS-style projections and materialized views from Akka.Persistence data.
  5. Location Transparency - Akka.Remote makes it simple for actors in remote processes to transparently communicate with each other.
  6. Highly Available, Fault-Tolerant Distributed Systems - Akka.Cluster, Akka.Cluster.Sharding, and other tools built on top of Akka.Cluster make it possible to build highly available and fault-tolerant distributed systems by leveraging peer-to-peer programming models with topology-aware message routing and distribution.
  7. Low Latency, High Throughput - Akka.NET aims to be low latency and high throughput, processing 10s millions of messages per second in-memory and hundreds of thousands of messages per second over remote connections.

Where Can I Learn Akka.NET?

You can start by taking the Akka.NET Bootcamp, but there are many other great learning resources for Akka.NET Online.

Build Status

Stage Status
Build Build Status
NuGet Pack Build Status
.NET Framework Unit Tests Build Status
.NET Framework MultiNode Tests Build Status
.NET Core (Windows) Unit Tests Build Status
.NET Core (Linux) Unit Tests Build Status
.NET Core (Windows) MultiNode Tests Build Status
.NET Core (Linux) MultiNode Tests
Docs Build Status

Install Akka.NET via NuGet

If you want to include Akka.NET in your project, you can install it directly from NuGet

To install Akka.NET Distributed Actor Framework, run the following command in the Package Manager Console

PM> Install-Package Akka
PM> Install-Package Akka.Remote

And if you need F# support:

PM> Install-Package Akka.FSharp

Builds

Please see Building Akka.NET.

To access nightly Akka.NET builds, please see the instructions here.

Support

If you need help getting started with Akka.NET, there's a number of great community resources online:

If you and your company are interested in getting professional Akka.NET support, you can contact Petabridge for dedicated Akka.NET support.

Showing the top 20 packages that depend on Akka.DistributedData.

Packages Downloads
Akka.DistributedData.LightningDB
Replicated data using CRDT structures
59
Akka.Cluster.Sharding
Sharded actors with managed lifecycle for Akka.NET cluster
58
Akka.Cluster.Sharding
Sharded actors with managed lifecycle for Akka.NET cluster. Used to distribute state in a fault-tolerant, consistent fashion over an Akka.NET cluster.
56
Akka.Cluster.Sharding
Sharded actors with managed lifecycle for Akka.NET cluster
56
Akka.Cluster.Sharding
Sharded actors with managed lifecycle for Akka.NET cluster
54
Akka.DistributedData.LightningDB
Replicated data using CRDT structures
50
Akka.DistributedData.LightningDB
Replicated data using CRDT structures
44
Akka.DistributedData.LightningDB
Replicated data using CRDT structures
42
Akka.Cluster.Sharding
Sharded actors with managed lifecycle for Akka.NET cluster. Used to distribute state in a fault-tolerant, consistent fashion over an Akka.NET cluster.
40
Akka.Cluster.Sharding
Sharded actors with managed lifecycle for Akka.NET cluster. Used to distribute state in a fault-tolerant, consistent fashion over an Akka.NET cluster.
38
Akka.Cluster.Sharding
Sharded actors with managed lifecycle for Akka.NET cluster
36
Akka.Cluster.Sharding
Sharded actors with managed lifecycle for Akka.NET cluster. Used to distribute state in a fault-tolerant, consistent fashion over an Akka.NET cluster.
35
Akka.DistributedData.LightningDB
Replicated data using CRDT structures
33
Akka.Cluster.Sharding
Sharded actors with managed lifecycle for Akka.NET cluster. Used to distribute state in a fault-tolerant, consistent fashion over an Akka.NET cluster.
32
Akka.DistributedData.LightningDB
Replicated data using CRDT structures
31
Akka.DistributedData.LightningDB
Replicated data using CRDT structures
30
Akka.Cluster.Sharding
Sharded actors with managed lifecycle for Akka.NET cluster
30

Version 1.5.0-beta1 contains **breaking API changes** and new API changes for Akka.NET. Breaking Changes: Logging** In [https://github.com/akkadotnet/akka.net/pull/6408](https://github.com/akkadotnet/akka.net/pull/6408) the entire `ILoggingAdapter` interface was rewritten in order to improve extensibility and performance (logging is now 30-40% faster in all cases and allocates ~50% fewer objects for large format strings). All of the changes made here are _source compatible_, but not _binary compatible_ - meaning that users and package authors will need to do the following: Add `using Akka.Event` in all files that used the `ILoggingAdapter` and Recompile. > NOTE: you can use a [`global using Akka.Event` directive](https://devblogs.microsoft.com/dotnet/welcome-to-csharp-10/#global-using-directives) to do this solution / project-wide if your project supports C# 10 and / or .NET 6. In addition to improving the performance of the `ILoggingAdapter` system, we've also made it more extensible - for instance, you can now globally configure the `ILogMessageFormatter` via the following HOCON: ``` akka { loglevel=INFO, loggers=["Akka.Logger.Serilog.SerilogLogger, Akka.Logger.Serilog"] logger-formatter="Akka.Logger.Serilog.SerilogLogMessageFormatter, Akka.Logger.Serilog" } ``` That will allow users to use the `SerilogLogMessageFormatter` globally throughout their applications - no more annoying calls like this inside individual actors that want to use semantic logging: ```csharp private readonly ILoggingAdapter _logger = Context.GetLogger<SerilogLoggingAdapter>(); ``` Breaking Changes: Akka.Persistence.Sql.Common** This is a breaking change that should effect almost no users, but [we deleted some old, bad ideas from the API surface](https://github.com/akkadotnet/akka.net/pull/6412) and it might require all Akka.Persistence.Sql* plugins to be recompiled. For what it's worth, [Akka.Persistence.Sql.Common's performance has been improved significantly](https://github.com/akkadotnet/akka.net/pull/6384) and we'll continue working on that with some additional API changes this week. Other Changes and Additions** [Akka.Actor: New API - `IActorRef.WatchAsync`](https://github.com/akkadotnet/akka.net/pull/6102) - adds a new extension method to `IActorRef` which allows users to subscribe to actor lifecycle notifications outside of the `ActorSystem`. [Akka.Actor: Suppress `System.Object` warning for serializer configuration changes](https://github.com/akkadotnet/akka.net/issues/6377) If you want to see the [full set of changes made in Akka.NET v1.5.0 so far, click here](https://github.com/akkadotnet/akka.net/milestone/7?closed=1). | COMMITS | LOC+ | LOC- | AUTHOR | | --- | --- | --- | --- | | 12 | 15 | 15 | dependabot[bot] | | 11 | 1930 | 1278 | Aaron Stannard | | 2 | 143 | 73 | Sergey Popov | | 1 | 26 | 4 | Thomas Stegemann | | 1 | 1 | 1 | Michel van Os |

.NET 6.0

.NET Standard 2.0

Version Downloads Last updated
1.5.38 2 02/21/2025
1.5.37 2 01/30/2025
1.5.36 3 01/30/2025
1.5.35 3 01/15/2025
1.5.34 3 01/14/2025
1.5.33 1 01/28/2025
1.5.32 9 12/10/2024
1.5.31 7 11/16/2024
1.5.30 18 10/05/2024
1.5.29 10 10/05/2024
1.5.28 13 09/05/2024
1.5.28-beta1 7 09/06/2024
1.5.27.1 12 07/26/2024
1.5.27 6 07/26/2024
1.5.27-beta2 9 07/07/2024
1.5.27-beta1 10 07/13/2024
1.5.26 16 06/27/2024
1.5.25 33 06/17/2024
1.5.24 29 06/08/2024
1.5.23 11 06/07/2024
1.5.22 12 06/07/2024
1.5.21 12 06/07/2024
1.5.20 31 05/04/2024
1.5.19 21 04/16/2024
1.5.18 25 03/13/2024
1.5.17.1 16 03/07/2024
1.5.17 16 03/07/2024
1.5.16 18 02/15/2024
1.5.15 17 02/15/2024
1.5.14 20 12/10/2023
1.5.13 34 09/25/2023
1.5.13-beta1 12 04/09/2024
1.5.12 17 08/30/2023
1.5.11 13 02/15/2024
1.5.10 18 08/31/2023
1.5.9 15 08/24/2023
1.5.8 15 08/30/2023
1.5.7 15 03/20/2024
1.5.6 15 02/15/2024
1.5.5 17 02/15/2024
1.5.4 15 06/14/2023
1.5.3 16 06/12/2023
1.5.2 17 02/15/2024
1.5.1 18 05/15/2023
1.5.0 18 06/14/2023
1.5.0-beta6 23 02/15/2024
1.5.0-beta5 19 08/30/2023
1.5.0-beta4 20 08/30/2023
1.5.0-beta3 18 02/15/2024
1.5.0-beta2 18 05/17/2023
1.5.0-beta1 19 02/15/2024
1.5.0-alpha4 15 08/30/2023
1.5.0-alpha3 16 05/17/2023
1.5.0-alpha2 12 04/09/2024
1.5.0-alpha1 7 04/09/2024
1.4.51 21 08/31/2023
1.4.50 18 08/29/2023
1.4.49 20 05/07/2023
1.4.49-beta1 13 09/01/2023
1.4.48 20 08/26/2023
1.4.47 19 08/30/2023
1.4.46 21 08/29/2023
1.4.45 22 08/26/2023
1.4.44 20 08/28/2023
1.4.43 24 08/29/2023
1.4.42 25 08/29/2023
1.4.41 19 08/31/2023
1.4.40 22 08/30/2023
1.4.39 20 08/28/2023
1.4.38 20 08/29/2023
1.4.37 21 08/30/2023
1.4.36 24 08/25/2023
1.4.35 21 08/27/2023
1.4.34 22 05/16/2023
1.4.33 20 08/30/2023
1.4.32 18 02/15/2024
1.4.31 37 04/27/2022
1.4.30 19 12/30/2023
1.4.29 19 08/31/2023
1.4.28 21 08/27/2023
1.4.27 26 08/29/2023
1.4.26 21 08/31/2023
1.4.25 21 08/26/2023
1.4.24 22 08/26/2023
1.4.23 22 08/26/2023
1.4.22 19 08/30/2023
1.4.21 24 08/29/2023
1.4.21-beta1 13 08/31/2023
1.4.20 20 08/30/2023
1.4.19 19 08/31/2023
1.4.18 21 08/30/2023
1.4.17 20 08/31/2023
1.4.16 19 08/30/2023
1.4.15 17 08/29/2023
1.4.14 22 08/26/2023
1.4.13 19 08/26/2023
1.4.12 19 08/30/2023
1.4.11 19 12/08/2023
1.4.10 20 02/15/2024
1.4.9 20 06/13/2023
1.4.8 14 06/13/2023
1.4.7 17 06/14/2023
1.4.6 19 06/12/2023
1.4.5 21 06/13/2023
1.4.4 21 05/17/2023
1.4.3 20 06/14/2023
1.4.2 24 06/14/2023
1.4.1 18 02/15/2024
1.4.1-rc3 17 01/07/2024
1.4.1-rc2 16 02/15/2024
1.4.1-rc1 17 03/20/2024
1.4.0-beta4 18 05/15/2023
1.4.0-beta3 12 08/31/2023
1.4.0-beta2 19 08/29/2023
1.4.0-beta1 18 02/15/2024
1.4.0-beta 20 06/14/2023
1.3.19-beta 30 05/04/2024
1.3.18-beta 18 02/15/2024
1.3.17-beta 17 08/29/2023
1.3.16-beta 21 05/15/2023
1.3.15-beta 21 08/31/2023
1.3.14-beta 17 02/15/2024
1.3.13-beta 15 05/15/2023
1.3.12-beta 17 08/30/2023
1.3.11-beta 15 03/20/2024
1.3.10-beta 16 02/15/2024
1.3.9-beta68 11 08/25/2023
1.3.9-beta67 14 08/24/2023
1.3.9-beta 17 02/15/2024
1.3.8-beta66 10 04/09/2024
1.3.8-beta65 11 08/27/2023
1.3.7-beta64 14 08/31/2023
1.3.7-beta63 14 04/09/2024
1.3.6-beta62 12 04/09/2024
1.3.6-beta61 16 08/31/2023
1.3.5-beta60 13 05/18/2023
1.3.5-beta59 17 08/31/2023
1.3.4-beta58 16 08/25/2023
1.3.4-beta57 15 08/29/2023
1.3.3-beta56 16 08/27/2023
1.3.3-beta55 11 08/28/2023
1.3.2-beta54 15 08/29/2023
1.3.2-beta53 14 08/26/2023
1.3.2-beta 16 06/12/2023
1.3.1-beta52 13 05/19/2023
1.3.1-beta51 14 08/28/2023
1.3.0-beta50 12 08/30/2023
1.3.0-beta48 14 08/28/2023
1.3.0-beta47 15 08/31/2023
1.3.0-beta46 13 08/31/2023
1.2.3.43-beta 15 08/25/2023
1.2.3.41-beta 22 05/16/2023
1.2.2.40-beta 18 05/18/2023
1.2.2.39-beta 18 05/18/2023
1.2.1.38-beta 18 08/30/2023
1.2.1.37-beta 20 08/28/2023
1.2.0.36-beta 18 05/19/2023
1.2.0.35-beta 19 02/15/2024
1.2.0.34-beta 16 03/20/2024
1.2.0.33-beta 15 03/12/2024
1.1.3.32-beta 18 10/15/2023
1.1.3.31-beta 15 03/20/2024