Ciclo di vita degli attori, Garbage Collection automatica ed eliminazione manuale
Un attore viene attivato la prima volta che viene effettuata una chiamata a uno dei suoi metodi. Un attore viene disattivato (tramite Garbage Collection del runtime di Actors) se rimane inutilizzato per un periodo di tempo configurabile. Un attore e il relativo stato possono essere eliminati manualmente in qualsiasi momento.
Attivazione di un attore
Quando un attore viene attivato, si verifica quanto segue:
- Quando viene effettuata una chiamata per un attore che non è ancora attivo, viene creato un nuovo attore.
- Viene caricato lo stato dell'attore, se viene mantenuto.
- Viene chiamato il metodo
OnActivateAsync(C#) oonActivateAsync(Java), che può essere sottoposto a override nell'implementazione dell'attore. - A questo punto l'attore è considerato attivo.
Disattivazione di un attore
Quando un attore viene disattivato, si verifica quanto segue:
- Quando un attore rimane inutilizzato per un determinato periodo di tempo, viene rimosso dalla tabella degli attori attivi.
- Viene chiamato il metodo
OnDeactivateAsync(C#) oonDeactivateAsync(Java), che può essere sottoposto a override nell'implementazione dell'attore. Ciò elimina tutti i timer dell'attore. Le operazioni dell'attore come le modifiche di stato non devono essere chiamate da questo metodo.
Suggerimento
Il runtime di Fabric Actors emette alcuni eventi relativi all'attivazione e alla disattivazione. che sono utili per la diagnostica e il monitoraggio delle prestazioni.
Garbage Collection degli attori
Quando un attore viene disattivato, i riferimenti all'oggetto attore vengono rilasciati e possono essere garbage collection normalmente da Common Language Runtime (CLR) o Java Virtual Collector (JVM). L'operazione di Garbage Collection pulisce solo l'oggetto attore, ma non rimuove lo stato archiviato nel gestore di stato dell'attore. Alla successiva attivazione dell'attore viene creato un nuovo oggetto attore e viene ripristinato il relativo stato.
Quali criteri determinano l'uso degli attori ai fini della disattivazione e dell'operazione di Garbage Collection?
- Ricezione di una chiamata
IRemindable.ReceiveReminderAsync(applicabile solo se l'attore usa promemoria)
Nota
Se l'attore usa i timer e viene eseguito il callback di timer, questa azione non viene considerata per determinare l'uso dell'attore.
Prima di approfondire i concetti relativi alla disattivazione, è importante definire i termini seguenti:
- Intervallo di analisi. Intervallo di tempo in cui il runtime di Actors esegue l'analisi della tabella degli attori attivi per identificare quelli che possono essere disattivati e sottoposti a Garbage Collection. Il valore predefinito è 1 minuto.
- Timeout inattiva. Periodo di tempo in cui un attore deve rimanere inutilizzato (inattivo) prima di poter essere disattivato e sottoposto a Garbage Collection. Il valore predefinito è 60 minuti.
Non è in genere necessario modificare questi valori predefiniti. Se necessario, però, questi intervalli possono essere modificati tramite ActorServiceSettings durante la registrazione del servizio Actor:
public class Program
{
public static void Main(string[] args)
{
ActorRuntime.RegisterActorAsync<MyActor>((context, actorType) =>
new ActorService(context, actorType,
settings:
new ActorServiceSettings()
{
ActorGarbageCollectionSettings =
new ActorGarbageCollectionSettings(10, 2)
}))
.GetAwaiter()
.GetResult();
}
}
public class Program
{
public static void main(String[] args)
{
ActorRuntime.registerActorAsync(
MyActor.class,
(context, actorTypeInfo) -> new FabricActorService(context, actorTypeInfo),
timeout);
}
}
Per ogni attore attivo, il runtime di Actors tiene traccia del periodo di inattività. Il runtime dell'attore controlla ognuno degli attori ogni ScanIntervalInSeconds per verificare se può essere garbage collection e contrassegna se è stato inattiva per IdleTimeoutInSeconds.
Ogni volta che un attore viene usato, il periodo di inattività viene reimpostato su 0. A questo punto, l'attore può essere sottoposto a Garbage Collection solo se rimane nuovamente inattivo per il numero di secondi definito da IdleTimeoutInSeconds. È importante ricordare che l'uso di un attore è determinato in base all'esecuzione di un metodo di interfaccia o di un callback di promemoria dell'attore. L'uso di un attore non è determinato in base all'esecuzione del callback dei timer.
Il diagramma seguente mostra il ciclo di vita di un unico attore per illustrare questi concetti.
Nell'esempio viene illustrato l'impatto delle chiamate ai metodi degli attori, dei promemoria e dei timer sulla durata dell'attore. Per questo esempio è opportuno evidenziare i punti seguenti:
- ScanInterval e IdleTimeout sono impostati rispettivamente su 5 e 10. (Unità non è rilevante in questo caso, poiché l’obiettivo è solo di illustrare il concetto.)
- L'analisi degli attori da sottoporre a Garbage Collection viene eseguita in T=0,5,10,15,20,25, come definito dall’intervallo di analisi di 5.
- Viene attivato un timer periodico in T=4,8,12,16,20,24 e ne viene eseguito il callback. Questo non influisce sul tempo di inattività dell'attore.
- Una chiamata a un metodo dell'attore in T=7 reimposta il tempo di inattività su 0 ritardando l'operazione di Garbage Collection dell'attore.
- Un callback di promemoria dell'attore eseguito in T=14 ritarda ulteriormente l'operazione di Garbage Collection dell'attore.
- Durante l'analisi di Garbage Collection in T=25, il tempo di inattività dell'attore supera infine il timeout di inattività di 10 e l'attore viene sottoposto a Garbage Collection.
Un attore non viene mai sottoposto a Garbage Collection mentre è in esecuzione uno dei relativi metodi, indipendentemente dal tempo impiegato per l'esecuzione di tale metodo. Come accennato in precedenza, l'esecuzione dei metodi dell'interfaccia dell'attore e dei callback di promemoria impedisce l'operazione di Garbage Collection, reimpostando su 0 il tempo di inattività dell'attore. L'esecuzione di callback di timer non ha invece l'effetto di reimpostare su 0 il tempo di inattività. Tuttavia, l'operazione di Garbage Collection dell'attore viene rinviata finché il callback di timer non ha completato l'esecuzione.
Eliminazione manuale degli attori e del relativo stato
L'operazione di Garbage Collection degli attori disattivati pulisce solo l'oggetto attore, ma non rimuove i dati archiviati in State Manager dell'attore. Quando un attore viene riattivato, i suoi dati vengono nuovamente resi disponibili tramite il gestore di stato. Nei casi in cui gli attori archiviano dati nel gestore di stato e vengono disattivati ma mai riattivati, può essere necessario pulire i relativi dati. Per esempi di eliminazione degli attori, vedere Eliminare gli attori e il relativo stato.