murmer 0.4.0

A distributed actor framework for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

//! Structured monitoring events emitted via the `tracing` crate.
//!
//! Each function emits a tracing event at the appropriate level with
//! structured fields. This lets you capture cluster lifecycle events
//! in whatever format your tracing subscriber supports (JSON logs,
//! OpenTelemetry spans, Prometheus metrics, etc.).

/// Emit a tracing event when a node joins the cluster.
pub fn trace_node_joined(node_id: &str, name: &str, class: &str) {
    tracing::info!(
        target: "murmer::cluster",
        event = "node_joined",
        node_id,
        node_name = name,
        node_class = class,
        "Node joined the cluster"
    );
}

/// Emit a tracing event when a node fails.
pub fn trace_node_failed(node_id: &str) {
    tracing::warn!(
        target: "murmer::cluster",
        event = "node_failed",
        node_id,
        "Node failure detected"
    );
}

/// Emit a tracing event when a node leaves gracefully.
pub fn trace_node_left(node_id: &str) {
    tracing::info!(
        target: "murmer::cluster",
        event = "node_left",
        node_id,
        "Node left gracefully"
    );
}

/// Emit a tracing event when an actor is placed on a node.
pub fn trace_actor_placed(label: &str, node_id: &str, reason: &str) {
    tracing::info!(
        target: "murmer::actor",
        event = "actor_placed",
        actor_label = label,
        node_id,
        reason,
        "Actor placed on node"
    );
}

/// Emit a tracing event when an actor is displaced due to node failure.
pub fn trace_actor_displaced(label: &str, node_id: &str, strategy: &str) {
    tracing::warn!(
        target: "murmer::actor",
        event = "actor_displaced",
        actor_label = label,
        node_id,
        crash_strategy = strategy,
        "Actor displaced by node departure"
    );
}

/// Emit a tracing event when an actor is redistributed to a new node.
pub fn trace_actor_redistributed(label: &str, from_node: &str, to_node: &str) {
    tracing::info!(
        target: "murmer::actor",
        event = "actor_redistributed",
        actor_label = label,
        from_node,
        to_node,
        "Actor redistributed to new node"
    );
}

/// Emit a tracing event for a cluster health snapshot.
pub fn trace_cluster_health(alive: usize, total: usize, actors: usize) {
    tracing::info!(
        target: "murmer::cluster",
        event = "health_snapshot",
        alive_nodes = alive,
        total_nodes = total,
        total_actors = actors,
        "Cluster health snapshot"
    );
}