Skip to main content
TermDefinition
ActorFundamental unit of computation. Isolated entity that processes messages sequentially and communicates via message passing.
ActorSystemTop-level runtime hosting actors. Manages lifecycle, messaging, clustering, remoting. See Actor System.
PIDProcess identifier. Live handle to a running actor. Used for Tell, Ask, and all interactions.
PathCanonical location of an actor: goakt://system@host:port/path/to/actor. Returned by pid.Path().
GrainVirtual actor. Identity-addressed; framework manages activation and passivation.
MailboxPer-actor message queue. Messages enqueued by senders, dequeued by the processing goroutine.
GuardianBuilt-in actor serving as root of the actor tree. Root, system, and user guardians.
SupervisorParent’s failure-handling policy. Defines resume, restart, stop, or escalate.
DirectiveSpecific supervision action: Resume, Restart, Stop, Escalate.
PassivationAutomatic shutdown of actors to reclaim resources. Two types: per-actor (idle-based) and system eviction (capacity-based). See Passivation.
System evictionNode-wide limit on active actors. When exceeded, passivates by LRU, LFU, or MRU. Configured via WithEvictionStrategy.
ReentrancyAbility to process other messages while awaiting an async Ask response.
StashSide buffer where an actor can park messages for later processing. Requires WithStashing(). See Stashing.
BehaviorA function func(ctx *ReceiveContext) that handles messages. Actors can switch behaviors via Become/UnBecome. See Behaviors.
PipeToRuns a task asynchronously and delivers the result to a target actor. See PipeTo.
TestKitTest helpers: throwaway actor system, Probe, GrainProbe. See TestKit.
Dead LetterMessage sent to a non-existent or stopped actor. Captured by the dead-letter actor.
Death WatchSubscription to an actor’s termination; receive Terminated when it stops.
Cluster SingletonActor with exactly one instance across the cluster. Hosted on the coordinator (oldest node); relocated when that node leaves. See Singletons.
RelocationAutomatic migration of actors and grains from a departed node to remaining cluster nodes. See Relocation.
Discovery ProviderPluggable backend for finding peer nodes (Consul, etcd, K8s, NATS, mDNS, static).
ExtensionSystem-wide plugin registered at ActorSystem creation. Accessible via ctx.Extension(id).
DependencyPer-actor resource injected at spawn. Must be serializable for relocation.
Event StreamIn-process mechanism for system and cluster events (ActorStarted, NodeJoined, Deadletter, etc.). Subscribers use Subscribe() and Iterator(). See Event Streams.
PubSubApplication-level topic-based messaging. Topic actor manages Subscribe/Unsubscribe/Publish. Requires WithPubSub() or cluster. See PubSub.
ClientStandalone package for interacting with a GoAkt cluster from outside the actor system (CLI, API server, batch job). Tell, Ask, Spawn, grains. See Client.