Glossar

A

Actor. Eine Entität mit eigenem State und Verhalten, die Nachrichten eine nach der anderen verarbeitet. Die grundlegende Recheneinheit im Actor-Modell. Siehe Actor.

ActorPath. Der eindeutige hierarchische Name für einen Actor in einem System, z. B. actor-ts://my-app/user/api/sessions/user-42. Siehe Actor Paths.

ActorRef. Ein typisiertes Handle auf einen Actor — der Wert, den Du tellst. Siehe Actor.

ActorSelection. Eine Beschreibung eines Lookups für einen Actor per Pfad-String; bei Bedarf zu einem ActorRef aufgelöst. Siehe Actor Paths.

ActorSystem. Der oberste Container für Actors; einer (oder wenige) pro Prozess. Besitzt den Dispatcher, Scheduler, Supervisionsbaum und Extensions. Siehe ActorSystem.

AllForOneStrategy. Eine Supervisionsstrategie, bei der der Fehler eines Kindes dazu führt, dass dieselbe Direktive auf jedes Geschwister angewendet wird. Siehe Supervision.

Ask. Request/Response über Actors — ref.ask(msg, timeout) gibt ein Promise für die Antwort zurück. Siehe Ask Pattern.

At-least-once Delivery. Eine Nachrichten-Delivery-Garantie, bei der Duplikate möglich, aber keine Verluste sind. Siehe Delivery.

B

Backoff Supervisor. Ein Supervisor, der sein Kind mit exponentiellem Backoff zwischen Versuchen neu startet. Siehe Backoff Supervisor.

Become. Ersetze den aktuellen Message-Handler durch einen neuen. Siehe Become und Stash.

Behavior. In der Typed API ein Wert, der beschreibt, wie die nächste Nachricht zu behandeln ist. Zusammengesetzt mit Behaviors.*-Kombinatoren. Siehe Behaviors.

Broadcast. Eine Router-Strategie (oder ein Broadcast<T>-Wrapper), die eine Nachricht an jeden Routee sendet. Siehe Strategies.

C

Circuit Breaker. Ein Drei-Zustands-Wrapper (closed/open/half-open), der nach anhaltenden Downstream-Fehlern schnell fehlschlägt. Siehe Circuit Breaker.

Cluster. Eine Gruppe von Actor-Systemen, die Membership per Gossip austauschen und Nachrichten über das Netzwerk routen. Siehe Cluster Overview.

ClusterSharding. Verteilt Per-Key-Actors über Cluster-Nodes mit automatischem Rebalancing. Siehe Sharding Overview.

ClusterSingleton. Genau ein Actor cluster-weit, gehostet auf dem Leader. Siehe Singleton Overview.

Command. In Event Sourcing eine Anfrage, etwas zu tun — unterscheidet sich vom Event, das aufzeichnet, was passiert ist. Siehe PersistentActor.

CoordinatedShutdown. Phasen-Shutdown-DSL mit Task-Registrierung pro benannter Phase. Siehe Coordinated Shutdown.

CRDT. Conflict-free Replicated Data Type — ein Datentyp, dessen Merge-Operation kommutativ, assoziativ und idempotent ist, sodass Gossip-Konvergenz ohne Koordination funktioniert. Siehe Distributed Data.

D

DeadLetter. Der synthetische Empfänger für Nachrichten ohne lebendes Ziel. Siehe ActorSystem.

Death Watch. Mechanismus eines Actors, benachrichtigt zu werden, wenn ein anderer Actor stoppt. Siehe Death Watch.

Direktive. Die Entscheidung des Supervisors für einen Kind-Fehler: Restart / Resume / Stop / Escalate. Siehe Supervision.

Discriminated Union. Ein TypeScript-Typ-Pattern, bei dem jede Variante ein Tag-Feld (kind) hat — die Konvention des Frameworks für Nachrichten. Siehe Messages.

Dispatcher. Plant die Nachrichtenverarbeitung eines Actors auf den JavaScript-Event-Loop. Siehe Dispatchers.

DistributedData. CRDT-replizierter State über den Cluster. Siehe Distributed Data Overview.

DistributedPubSub. Topic-basiertes Publish/Subscribe über den Cluster. Siehe PubSub.

Downing-Strategie. Logik, die entscheidet, welche Seite einer Netzwerkpartition gewinnt und welche sich selbst down setzt. Siehe Downing Strategies.

DurableStateActor. Persistiert einen einzelnen State-Snapshot pro persistenceId (vs. das Event-Log des PersistentActor). Siehe Durable State.

E

Entity. In Sharding ein einzelner Actor, identifiziert durch eine Entity-ID. Siehe Sharding Overview.

Envelope. Der interne Wrapper um eine Nachricht im Transit: { message, sender, context?, trace? }.

Event. In Event Sourcing das persistierte Fakt, das aufzeichnet, dass etwas passiert ist. Unterscheidet sich von einem Command. Siehe PersistentActor.

Event Adapter. Schema-Evolutions-Upcaster für Events. Siehe Migration Overview.

Event Sourcing. Ein Persistenz-Modell, bei dem State durch das Wiederabspielen eines Event-Logs abgeleitet wird. Siehe Persistence Overview.

Event Stream. Systemweiter Pub/Sub-Bus, scoped auf ein ActorSystem. Siehe Event Stream.

Extension. Plugin-Mechanismus — lazy initialisierte, system-scoped Services (Cluster, Persistenz, Metriken, …). Siehe ActorSystem.

F

Failure Detector. Phi-Accrual-Detector, der unerreichbare Peers basierend auf fehlenden Heartbeats markiert. Siehe Failure Detector.

FIFO. First-In-First-Out — die Default-Mailbox-Reihenfolge. Siehe Mailboxes.

FSM. Endlicher-Zustandsautomat-Pattern; sowohl in-memory als auch event-sourced Varianten existieren. Siehe FSM Overview.

G

Gossip. Das Membership-Propagation-Protokoll des Clusters — Mitglieder tauschen ihre Sichten periodisch aus, bis Konvergenz. Siehe Cluster Overview.

Guardian. Top-Level-System-Actors: /user, /system, /deadLetters. Siehe ActorSystem.

H

HOCON. Human-Optimized Configuration Object Notation — das Konfigurations-Format, das actor-ts verwendet. Siehe Konfiguration.

J

Journal. Der Append-Only-Event-Store für PersistentActors. Siehe Persistence Overview.

K

Kill. Systemnachricht, die ActorKilledError auslöst — triggert die Supervisionsstrategie. Siehe Poison Pill und Kill.

L

Lease. Koordinations-Primitiv — genau ein Actor hält einen benannten Lease zu einer Zeit. Wird verwendet, um Split-Brain für Singletons und Sharding-Koordinatoren zu verhindern. Siehe Coordination.

LogContext / MDC. Mapped Diagnostic Context — Key-Value-Store pro Async-Stack, der mit tell und über Cluster-Hops propagiert. Siehe Logging.

M

Mailbox. Die Nachrichten-Queue pro Actor. Default unbounded FIFO; bounded und Priority-Varianten werden ausgeliefert. Siehe Mailboxes.

Message. Jeder Wert, der an einen Actor telld wird. Konvention: Discriminated Union, getaggt durch kind. Siehe Messages.

N

Node. In einem Cluster eine einzelne ActorSystem-Instanz, an ein host:port gebunden. Siehe Cluster Overview.

O

onReceive. Die Methode eines Actors, die jede eingehende Nachricht behandelt. Siehe Actor.

OneForOneStrategy. Die Default-Supervisionsstrategie — ein fehlerhaftes Kind bekommt die Direktive; Geschwister sind unbetroffen. Siehe Supervision.

P

Passivation. Stoppen einer untätigen geshardeten Entität, um Speicher freizugeben; die nächste Nachricht für dieselbe ID re-spawnt sie. Siehe Sharding Overview.

persist. In PersistentActor der Aufruf, der ein Event ins Journal schreibt und den Callback aufruft, nachdem das Event über onEvent angewendet wurde. Siehe PersistentActor.

persistenceId. Die eindeutige Kennung für den Event-Stream einer Entität im Journal.

PersistentActor. Event-sourced Actor-Basisklasse. Siehe PersistentActor.

Phi Accrual. Der zugrunde liegende Algorithmus des Failure Detectors — Verdacht akkumuliert basierend auf Heartbeat-Historie.

pipeTo. Route das eventuelle Ergebnis eines Promise als Nachricht in die Mailbox eines Actors. Siehe Future Patterns.

PoisonPill. Systemnachricht, die einen Graceful-Stop-nach-Drain triggert. Siehe Poison Pill und Kill.

Pool. Ein Router, der seine Routees aus Props erzeugt. Siehe Pool vs Group.

Projection. Read-Side-View, gebaut aus dem Event-Stream eines PersistentActor. Siehe Projections.

Props. Immutable Beschreibung dafür, wie ein Actor konstruiert wird — Factory + Supervisionsstrategie + Dispatcher + Mailbox. Siehe Props.

R

Reachability. Ob der Failure Detector einen Peer aktuell als heartbeatend sieht.

Receive Timeout. Timer, der feuert, wenn keine User-Nachricht in N ms angekommen ist. Siehe Receive Timeout.

Rebalance. Der Prozess von Sharding, Shards zwischen Nodes zu verschieben, wenn sich die Membership ändert. Siehe Rebalance.

Remember Entities. Sharding-Option, die die aktive Entity-ID-Menge persistiert, sodass sie nach einem Koordinator-Failover re-spawnen. Siehe Remember Entities.

replyTo. Konvention: ein Feld auf einer Request-Nachricht, das den ActorRef für die Antwort trägt. Siehe Messages.

Region. Der Sharding-Actor pro Node, der Entities für die ihm gehörenden Shards hostet und andere routet. Siehe Sharding Overview.

Restart. Supervisor-Direktive — die kaputte Instanz wegwerfen, eine frische bauen. Siehe Supervision.

Resume. Supervisor-Direktive — den State behalten, die fehlerhafte Nachricht überspringen. Siehe Supervision.

Routee. Ein Actor, der Nachrichten empfängt, die von einem Router geroutet werden.

Router. Ein Actor, der jede Nachricht an einen (oder alle) seiner Routees gemäß einer Strategie weiterleitet. Siehe Router.

S

Scheduler. System-Level-Scheduler — führt verzögerte und periodische Tasks aus. Unterscheidet sich vom per-Actor TimerScheduler. Siehe Timers and Scheduling.

Seed Node. Eine Adresse, die ein beitretender Node kontaktiert, um in den Cluster einzutreten. Siehe Joining and Seeds.

Shard. Eine Teilmenge von Entity-IDs, die zusammen gehasht werden. Gehört zu jeder Zeit genau einer Node. Siehe Sharding Overview.

Snapshot. Periodischer State-Dump, der die Recovery für PersistentActors verkürzt. Siehe Snapshots.

Split-Brain. Wenn eine Netzwerkpartition den Cluster in zwei Hälften teilt, die beide denken, die andere sei weg. Siehe Downing Strategies.

Stash. Park die aktuell behandelte Nachricht für späteres Replay. Siehe Become und Stash.

Supervisionsstrategie. Logik pro Elternteil, die den Fehler eines Kindes auf eine Direktive abbildet. Siehe Supervision.

T

tell. Fire-and-forget Send. Das Default-Actor-Verb. Siehe Messages.

Terminated. Systemnachricht, die an Watchers geliefert wird, wenn ein beobachteter Actor stoppt. Siehe Death Watch.

Tombstone. In Gossip ein Record, der gehalten wird, nachdem ein Mitglied entfernt wurde, um zu verhindern, dass veralteter Gossip es wiederbelebt.

Tracer. Observability-Abstraktion für Distributed Tracing — wickelt typischerweise ein OpenTelemetry-SDK. Siehe Tracing.

ts-pattern. Library, die für match().exhaustive()-Dispatch auf Discriminated Unions verwendet wird. Siehe Pattern Matching.

Typed Actor. Die funktionale Alternative zum Subclassen von Actor — Actors als Behavior<T>-Werte. Siehe Typed Overview.

U

Unbecome. Stelle das vorherige Verhalten nach einem become wieder her, das es aufgestapelt hat. Siehe Become und Stash.

Unreachable. Ein Cluster-Mitglied, das der Failure Detector als nicht heartbeatend markiert. Noch nicht offiziell downgesetzt. Siehe Failure Detector.

V

Vector Clock. Logische Uhr, die in Replicated Event Sourcing verwendet wird, um nebenläufige Updates zu tracken. Siehe Replicated ES — Vector Clocks.

W

Watch / Unwatch. Abonniere (oder kündige) die Terminated-Benachrichtigung für einen anderen Actor. Siehe Death Watch.

Weakly-Up. Ein transienter Member-Zustand — gossip-sichtbar, aber noch nicht vom Leader bestätigt. Siehe Weakly-Up.