Skip to content

Commit 791bd10

Browse files
added v1.4.47 release notes (#6301)
* added v1.4.47 release notes * fixed contributor stats
1 parent 998dcca commit 791bd10

File tree

1 file changed

+81
-0
lines changed

1 file changed

+81
-0
lines changed

RELEASE_NOTES.md

+81
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,84 @@
1+
#### 1.4.47 December 9th 2022 ####
2+
Akka.NET v1.4.47 is a maintenance patch for Akka.NET v1.4.46 that includes a variety of bug fixes, performance improvements, and new features.
3+
4+
**Actor Telemetry**
5+
6+
Starting in Akka.NET v1.4.47 local and remotely deployed actors will now emit events when being started, stopped, and restarted:
7+
8+
```csharp
9+
public interface IActorTelemetryEvent : INoSerializationVerificationNeeded, INotInfluenceReceiveTimeout
10+
{
11+
/// <summary>
12+
/// The actor who emitted this event.
13+
/// </summary>
14+
IActorRef Subject {get;}
15+
16+
/// <summary>
17+
/// The implementation type for this actor.
18+
/// </summary>
19+
Type ActorType { get; }
20+
}
21+
22+
/// <summary>
23+
/// Event emitted when actor starts.
24+
/// </summary>
25+
public sealed class ActorStarted : IActorTelemetryEvent
26+
{
27+
public IActorRef Subject { get; }
28+
public Type ActorType { get; }
29+
}
30+
31+
/// <summary>
32+
/// Event emitted when actor shuts down.
33+
/// </summary>
34+
public sealed class ActorStopped : IActorTelemetryEvent
35+
{
36+
public IActorRef Subject { get; }
37+
public Type ActorType { get; }
38+
}
39+
40+
/// <summary>
41+
/// Emitted when an actor restarts.
42+
/// </summary>
43+
public sealed class ActorRestarted : IActorTelemetryEvent
44+
{
45+
public IActorRef Subject { get; }
46+
public Type ActorType { get; }
47+
48+
public Exception Reason { get; }
49+
}
50+
```
51+
52+
These events will be consumed from popular Akka.NET observability and management tools such as [Phobos](https://phobos.petabridge.com/) and [Petabridge.Cmd](https://cmd.petabridge.com/) to help provide users with more accurate insights into actor workloads over time, but you can also consume these events yourself by subscribing to them via the `EventStream`:
53+
54+
```csharp
55+
// subscribe to all actor telemetry events
56+
Context.System.EventStream.Subscribe(Self, typeof(IActorTelemetryEvent));
57+
```
58+
59+
**By default actor telemetry is disabled** - to enable it you'll need to turn it on via the following HOCON setting:
60+
61+
```hocon
62+
akka.actor.telemetry.enabled = on
63+
```
64+
65+
The performance impact of enabling telemetry is negligible, as you can [see via our benchmarks](https://github.com/akkadotnet/akka.net/pull/6294#issuecomment-1340251897).
66+
67+
**Fixes and Updates**
68+
69+
* [Akka.Streams: Fixed `System.NotSupportedException` when disposing stage with materialized `IAsyncEnumerable`](https://github.com/akkadotnet/akka.net/issues/6280)
70+
* [Akka.Streams: `ReuseLatest` stage to repeatedly emit the most recent value until a newer one is pushed](https://github.com/akkadotnet/akka.net/pull/6262)
71+
* [Akka.Remote: eliminate `ActorPath.ToSerializationFormat` UID allocations](https://github.com/akkadotnet/akka.net/pull/6195) - should provide a noticeable Akka.Remote performance improvement.
72+
* [Akka.Remote: Remoting and an exception as a payload message ](https://github.com/akkadotnet/akka.net/issues/3903) - `Exception` types are now serialized properly inside `Status.Failure` messages over the wire. `Status.Failure` and `Status.Success` messages are now managed by Protobuf - so you might see some deserialization errors while upgrading if those types are being exchanged over the wire.
73+
* [Akka.TestKit: `TestActorRef` can not catch exceptions on asynchronous methods](https://github.com/akkadotnet/akka.net/issues/6265)
74+
75+
You can see the [full set of tracked issues for Akka.NET v1.4.47 here](https://github.com/akkadotnet/akka.net/issues?q=is%3Aclosed+milestone%3A1.4.47).
76+
77+
| COMMITS | LOC+ | LOC- | AUTHOR |
78+
| --- | --- | --- | --- |
79+
| 10 | 2027 | 188 | Aaron Stannard |
80+
| 1 | 157 | 10 | Gregorius Soedharmo |
81+
182
#### 1.4.46 November 15th 2022 ####
283
Akka.NET v1.4.46 is a security patch for Akka.NET v1.4.45 but also includes some other fixes.
384

0 commit comments

Comments
 (0)