Funzionalità di diagnostica per i servizi Reliable con stato
La classe StatefulServiceBase dei servizi Reliable con stato in Azure Service Fabric genera eventi EventSource che possono essere usati per eseguire il debug del servizio, ottenere informazioni dettagliate sul funzionamento del runtime e ottenere assistenza per la risoluzione dei problemi.
Eventi EventSource
Il nome EventSource per la classe StatefulServiceBase di Reliable Services con stato è "Microsoft-ServiceFabric-Services". Gli eventi di questa origine evento vengono visualizzati nella finestra Eventi di diagnostica quando il servizio viene sottoposto a debug in Visual Studio.
Esempi di strumenti e tecnologie che consentono di raccogliere e/o visualizzare eventi EventSource sono PerfView, Diagnostica di Azure e la libreria TraceEvent di Microsoft.
evento
| Nome evento | ID evento | Level | Descrizione dell'evento |
|---|---|---|---|
| StatefulRunAsyncInvocation | 1 | Informazioni | Emesso quando l'attività RunAsync del servizio viene avviata |
| StatefulRunAsyncCancellation | 2 | Informazioni | Emesso quando l'attività RunAsync del servizio viene annullata |
| StatefulRunAsyncCompletion | 3 | Informazioni | Emesso quando l'attività RunAsync del servizio viene completata |
| StatefulRunAsyncSlowCancellation | 4 | Avviso | Emesso quando l'annullamento dell'attività RunAsync del servizio richiede troppo tempo |
| StatefulRunAsyncFailure | 5 | Errore | Emesso quando l'attività RunAsync del servizio genera un'eccezione |
Interpretazione degli eventi
Gli eventi StatefulRunAsyncInvocation, StatefulRunAsyncCompletion e StatefulRunAsyncCancellation consentono all'autore di un servizio di comprenderne il ciclo di vita e di definirne i tempi di avvio, annullamento e completamento. Queste informazioni possono esseri utili durante il debug dei problemi di un servizio o per la comprensione del ciclo di vita di quest'ultimo.
Gli sviluppatori devono prestare particolare attenzione agli eventi StatefulRunAsyncSlowCancellation e StatefulRunAsyncFailure in quanto indicano la presenza di problemi relativi al servizio.
L'evento StatefulRunAsyncFailure viene emesso ogni volta che l'attività RunAsync() del servizio genera un'eccezione. Normalmente, la generazione di un'eccezione indica la presenza di un errore o di un bug nel servizio. Inoltre, l'eccezione causa un esito negativo del servizio, con conseguente spostamento a un altro nodo. L'operazione di spostamento del servizio può risultare costosa e causare un ritardo per le richieste in ingresso. Gli sviluppatori dovrebbero determinare la causa dell'eccezione e, se possibile, limitare il problema.
L'evento StatefulRunAsyncSlowCancellation viene emesso ogni volta che una richiesta di annullamento dell'attività RunAsync richiede più di quattro secondi. L'eccessiva durata di un'operazione di annullamento influisce sulla possibilità di riavviare rapidamente il servizio su un altro nodo. Questo scenario può avere un impatto negativo sulla disponibilità complessiva del servizio.
Contatori delle prestazioni
Il runtime di Reliable Services definisce le categorie di contatori delle prestazioni seguenti:
| Category | Descrizione |
|---|---|
| Replicatore transazionale di Service Fabric | Contatori specifici di Replicatore transazionale di Service Fabric di Azure |
| Service Fabric TStore | Contatori specifici di Azure Service Fabric TStore |
Replicatore transazionale di Service Fabric viene usato da Reliable State Manager per replicare le transazioni all'interno di un determinato set di repliche.
Service Fabric TStore è un componente usato nelle raccolte Reliable Collections per archiviare e recuperare le coppie chiave-valore.
L'applicazione Performance Monitor di Windows , disponibile per impostazione predefinita nel sistema operativo Windows, può essere usata per raccogliere e visualizzare i dati dei contatori delle prestazioni. Diagnostica di Azure rappresenta una valida alternativa per la raccolta di tali dati e il relativo caricamento nelle tabelle di Azure.
Nomi delle istanze dei contatori delle prestazioni
Un cluster con un numero elevato di servizi Reliable Services o di partizioni di servizi Reliable Services disporrà di un numero considerevole di istanze di contatori delle prestazioni di Replicatore transazionale. Questo avviene anche per i contatori delle prestazioni TStore, ma viene moltiplicato anche per il numero di oggetti Reliable Dictionaries e Reliable Queues usati. I nomi delle istanze dei contatori delle prestazioni consentono di identificare la partizione, la replica del servizio e lo stato del provider specifici nel caso di TStore, a cui l'istanza del contatore delle prestazioni è associata.
Categoria Replicatore transazionale di Service Fabric
Per la categoria Service Fabric Transactional Replicator, i nomi delle istanze dei contatori sono nel formato seguente:
ServiceFabricPartitionId:ServiceFabricReplicaId
ServiceFabricPartitionId è la rappresentazione sotto forma di stringa dell'ID partizione di Service Fabric a cui è associata l'istanza del contatore delle prestazioni. L'ID partizione è un GUID e la relativa rappresentazione di stringa viene generata tramite Guid.ToString con l'identificatore di formato "D".
ServiceFabricReplicaId è l'ID associato a una determinata replica di un servizio Reliable Services. L'ID replica è incluso nel nome dell'istanza del contatore delle prestazioni per garantire l'univocità ed evitare conflitti con altre istanze del contatore delle prestazioni generate dalla stessa partizione. Informazioni dettagliate sulle repliche e il relativo ruolo nei servizi Reliable Services sono disponibili qui.
Di seguito è riportato un esempio di un nome di istanza per un contatore appartenente alla categoria Service Fabric Transactional Replicator:
00d0126d-3e36-4d68-98da-cc4f7195d85e:131652217797162571
Nell'esempio precedente, 00d0126d-3e36-4d68-98da-cc4f7195d85e è la rappresentazione sotto forma di stringa dell'ID partizione di Service Fabric e 131652217797162571 è l'ID replica.
Categoria Service Fabric TStore
Per la categoria Service Fabric TStore, i nomi delle istanze dei contatori sono nel formato seguente:
ServiceFabricPartitionId:ServiceFabricReplicaId:StateProviderId_PerformanceCounterInstanceDifferentiator_StateProviderName
ServiceFabricPartitionId è la rappresentazione sotto forma di stringa dell'ID partizione di Service Fabric a cui è associata l'istanza del contatore delle prestazioni. L'ID partizione è un GUID e la relativa rappresentazione di stringa viene generata tramite Guid.ToString con l'identificatore di formato "D".
ServiceFabricReplicaId è l'ID associato a una determinata replica di un servizio Reliable Services. L'ID replica è incluso nel nome dell'istanza del contatore delle prestazioni per garantire l'univocità ed evitare conflitti con altre istanze del contatore delle prestazioni generate dalla stessa partizione. Informazioni dettagliate sulle repliche e il relativo ruolo nei servizi Reliable Services sono disponibili qui.
StateProviderId è l'ID associato a un provider di stato all'interno di un servizio Reliable Services. L'ID del provider di stato è incluso nel nome dell'istanza del contatore delle prestazioni per differenziare un TStore da un altro.
PerformanceCounterInstanceDifferentiator è un ID di differenziazione associato a un'istanza del contatore delle prestazioni all'interno di un provider di stato. Il differenziatore viene incluso nel nome dell'istanza del contatore delle prestazioni per assicurarne l'univocità ed evitare conflitti con altre istanze di contatori delle prestazioni generate dallo stesso provider di stato.
StateProviderName è il nome associato a un provider di stato all'interno di un servizio Reliable Services. Il nome del provider di stato è incluso nel nome dell'istanza del contatore delle prestazioni per consentire agli utenti di identificare facilmente lo stato fornito.
Di seguito è riportato un esempio di un nome di istanza per un contatore appartenente alla categoria Service Fabric TStore:
00d0126d-3e36-4d68-98da-cc4f7195d85e:131652217797162571:142652217797162571_1337_urn:MyReliableDictionary/dataStore
Nell'esempio precedente, 00d0126d-3e36-4d68-98da-cc4f7195d85e è la rappresentazione in formato stringa dell'ID della partizione di Service Fabric, 131652217797162571 è l'ID della replica, 142652217797162571 è l'ID del provider di stato e 1337 è il differenziatore dell'istanza del contatore delle prestazioni. urn:MyReliableDictionary/dataStore è il nome del provider di stato che archivia i dati per la raccolta denominata urn:MyReliableDictionary.
Contatori delle prestazioni di Replicatore transazionale
Il runtime di Reliable Services genera gli eventi seguenti nella categoria Service Fabric Transactional Replicator
| Nome contatore | Descrizione |
|---|---|
| Operazioni di inizio transazione/sec | Numero di nuove transazioni di scrittura create al secondo. |
| Operazioni di transazione/sec | Numero di operazioni di aggiunta/aggiornamento/eliminazione eseguite su raccolte Reliable Collections al secondo. |
| Byte scaricamento log/sec | Numero di byte scaricati sul disco da Replicatore transazionale al secondo. |
| Operazioni limitate/sec | Numero di operazioni rifiutate al secondo da Replicatore transazionale a causa della limitazione. |
| Avg. Transaction ms/Commit | Latenza media commit per transazione in millisecondi |
| Media latenza scaricamento (ms) | Durata media delle operazioni di flush su disco avviate da Replicatore transazionale in millisecondi |
Contatori delle prestazioni di TStore
Il runtime di Reliable Services genera gli eventi seguenti nella categoria Service Fabric TStore
| Nome contatore | Descrizione |
|---|---|
| Item Count | Il numero di elementi nell'archivio. |
| Dimensioni disco | Le dimensioni totali del disco, in byte, dei file di checkpoint per l'archivio. |
| Byte scritti/sec per il file di checkpoint | Il numero di byte scritti al secondo per il file di checkpoint più recente. |
| Byte trasferiti su disco/sec per la copia | Il numero di byte letti (nella replica primaria) o scritti (in una replica secondaria) al secondo durante la copia nell'archivio. |