akka

Supervision and Monitoring in Akka

Remarks#

References: akka.io/docs

Check out my blog: https://blog.knoldus.com/2016/08/07/supervision-and-monitoring-in-akka/

What is supervision?

Describes a dependency relationship between actors, the parent and child releationship. Parent is unique because it has created the child actor, so the parent is responsible for reacting when failures happens in his child.

And parent decides which choice needs to be selected. When a parent receives the failure signal from it’s child then depending on the nature of failure, the parent decides from following options:

Resume: Parent starts the child actor keeping its internal state.

Restart: Parent starts the child actor by clearing it’s internal state.

Stop: Stop the child permanently.

Escalate: Escalate the failure by failing itself and propagate failure to its parent.

Akka Life Cycle

Akka Life Cycle

It is always important to view a part of supervision hierarchy, which explains the escalate option. Each supervisor should cover with all possible failure cases.

Actor System

Actor System: Source: doc.akka.io

/user: The User Guardian Actor

Actor created using system.actorOf() are children of user guardian actor. Whenever user guardian terminates, all user created actors will be terminated too. Top level user created actors are determined by user guardian actor that how they will be supervised. Root Guardian is the supervisor of user guardian.

/root: The Root Guardian

The root guardian actor is the father of all actor system. It supervises user guardian actor and system guardian actor.

Supervision Strategies

There are two type of supervision strategies that we follow to supervise any actor:

  1. One-For-One Strategy

  2. One-For-All Strategy

case object ResumeException extends Exception
 
case object StopException extends Exception
case object RestartException extends Exception
 
override val supervisorStrategy =
 OneForOneStrategy(maxNrOfRetries = 10, withinTimeRange = 1 second){
 case ResumeException => Resume
 case RestartException => Restart
 case StopException => Stop
 case _: Exception => Escalate
 }

What is Monitoring?

Lifecycle Monitoring in Akka is usually referred to as DeathWatch.

Monitoring is thus used to tie one actor to another so that it may react to the other actor’s termination, in contrast to supervision which reacts to failure.

Monitoring

Monitoring

Monitoring is particularly useful if a supervisor cannot simply restart its children and has to terminate them, e.g. in case of errors during actor initialization. In that case it should monitor those children and re-create them or schedule itself to retry this at a later time.

Code Repository

Supervision and Monitoring


This modified text is an extract of the original Stack Overflow Documentation created by the contributors and released under CC BY-SA 3.0 This website is not affiliated with Stack Overflow