Contatori delle prestazioni di WCF

  • Articolo

Windows Communication Foundation (WCF) include un vasto insieme di contatori delle prestazioni che consentono di misurare le prestazioni dell'applicazione.

Attivazione dei contatori delle prestazioni

È possibile attivare i contatori delle prestazioni per un servizio WCF tramite il file di configurazione app.config del servizio WCF nel modo seguente:

<configuration>
    <system.serviceModel>
        <diagnostics performanceCounters="All" />
    </system.serviceModel>
</configuration>

L'attributo performanceCounters può essere impostato per attivare un tipo specifico di contatori delle prestazioni. I valori validi sono:

  • All: vengono attivati tutti i contatori della categoria (ServiceModelService, ServiceModelEndpoint e ServiceModelOperation).
  • ServiceOnly: vengono attivati soltanto i contatori della categoria ServiceModelService.
  • Off: vengono disattivati i contatori delle prestazioni della categoria ServiceModel*. Tale impostazione rappresenta il valore predefinito.

Se si desidera attivare contatori delle prestazioni per tutte le applicazioni WCF, è possibile memorizzare le impostazioni di configurazione nel file Machine.config. Per ulteriori informazioni sulla configurazione di memoria sufficiente per i contatori delle prestazioni nel computer, vedere la sezione Aumento della dimensione della memoria per i contatori delle prestazioni.

È inoltre possibile attivare contatori delle prestazioni nel codice nel modo seguente:

using System.Configuration;
using System.ServiceModel.Configuration;
using System.ServiceModel.Diagnostics;
Configuration config = ConfigurationManager.OpenExeConfiguration(
    ConfigurationUserLevel.None);
ServiceModelSectionGroup sg = ServiceModelSectionGroup.GetSectionGroup(config);
sg.Diagnostic.PerformanceCounters = PerformanceCounterScope.All;
config.Save();

Visualizzazione dei dati relativi alle prestazioni

Per visualizzare i dati acquisiti dai contatori delle prestazioni è possibile utilizzare lo strumento Performance Monitor (Perfmon.exe) di Windows. Per avviare questo strumento fare clic su Start, scegliere Esegui, quindi digitare perfmon.exe nella finestra di dialogo visualizzata.

Nota

Le istanze del contatore delle prestazioni possono essere rilasciate prima che gli ultimi messaggi siano stati elaborati dal Dispatcher dell'endpoint. In questo caso è possibile che i dati relativi alle prestazioni non vengano acquisiti per alcuni messaggi.

Aumento della dimensione della memoria per i contatori delle prestazioni

Per le categorie di contatori delle prestazioni WCF utilizza una memoria condivisa separata.

Per impostazione predefinita, la memoria condivisa separata è impostata su un quarto della dimensione della memoria globale dei contatori delle prestazioni. La dimensione della memoria globale predefinita dei contatori delle prestazioni è di 524.288 byte. Le tre categorie di contatori delle prestazioni di WCF hanno quindi una dimensione predefinita di circa 128 KB ognuna. A seconda delle caratteristiche di runtime delle applicazioni WCF disponibili in un computer, la memoria dei contatori delle prestazioni può esaurirsi. Quando si verifica questa condizione, WCF scrive un errore nel registro eventi dell'applicazione. Il contenuto dell'errore indica che un contatore delle prestazioni non è stato caricato e la voce contiene l'eccezione "System.InvalidOperationException: Memoria insufficiente per la visualizzazione del file dei contatori personalizzati". Se è attivata l'analisi al livello dell'errore, l'errore viene anche analizzato. Quando la memoria dei contatori delle prestazioni è esaurita, l'esecuzione di applicazioni WCF con i contatori delle prestazioni attivati può comportare una riduzione del livello delle prestazioni. In questo caso l'amministratore del computer dovrà configurare il computer per l'allocazione di memoria sufficiente a supportare il numero massimo di contatori delle prestazioni che possono essere presenti in qualsiasi momento. Per ulteriori informazioni, vedere performanceCounters.

È possibile modificare la quantità di memoria del contatore delle prestazioni per le categorie di WCF nel Registro di sistema. A tale scopo, è necessario aggiungere un nuovo valore DWORD denominato FileMappingSize ai tre percorsi specificati di seguito e impostarlo sul valore desiderato espresso in byte. Riavviare il computer per rendere effettive le modifiche.

  • HKLM\System\CurrentControlSet\Services\ServiceModelEndpoint 3.0.0.0\Performance
  • HKLM\System\CurrentControlSet\Services\ServiceModelOperation 3.0.0.0\Performance
  • HKLM\System\CurrentControlSet\Services\ServiceModelService 3.0.0.0\Performance

Quando numerosi oggetti (ad esempio, ServiceHost) vengono eliminati ma rimangono in attesa di essere sottoposti all'operazione di Garbage Collection, il contatore delle prestazioni PrivateBytes registra un valore insolitamente elevato. Per risolvere questo problema è possibile aggiungere contatori specifici dell'applicazione o utilizzare l'attributo performanceCounters per attivare soltanto i contatori a livello di servizio.

Tipi di contatori delle prestazioni

I contatori delle prestazioni vengono applicati a tre livelli differenti: servizio, endpoint e operazione.

Per recuperare il nome di un'istanza di contatore delle prestazioni è possibile utilizzare WMI. Ad esempio:

  • Il nome di un'istanza di contatore delle prestazioni a livello di servizio può essere ottenuto tramite la proprietà "CounterInstanceName" dell'istanza Servizio di WMI.
  • Il nome di un'istanza di contatore delle prestazioni a livello di endpoint può essere ottenuto tramite la proprietà "CounterInstanceName" dell'istanza Endpoint di WMI.
  • Il nome di un'istanza di contatore delle prestazioni a livello di operazione può essere ottenuto tramite il metodo "GetOperationCounterInstanceName" dell'istanza Endpoint di WMI.

Per ulteriori informazioni su WMI, vedere Utilizzo di Strumentazione gestione Windows (WMI) per la diagnostica.

Contatori delle prestazioni a livello di servizio

I contatori delle prestazioni del servizio misurano il comportamento del servizio nel suo insieme e possono essere utilizzati per diagnosticare le prestazioni dell'intero servizio. Sono reperibili nell'oggetto prestazione ServiceModelService 3.0.0.0 in caso di visualizzazione con Performance Monitor. Le istanze vengono denominate utilizzando il modello seguente:

ServiceName@ServiceBaseAddress

Un contatore nell'ambito di un servizio viene aggregato dal contatore in un insieme di endpoint.

I contatori delle prestazioni per la creazione dell'istanza di servizio vengono incrementati alla creazione di un nuovo contesto InstanceContext. Si noti che un nuovo contesto InstanceContext viene creato anche quando si riceve un messaggio di non attivazione (con un servizio esistente) o quando vi è una connessione a un'istanza da una determinata sessione, si termina la sessione e ci si riconnette da un'altra sessione.

Contatori delle prestazioni a livello di endpoint

I contatori delle prestazioni a livello di endpoint consentono di analizzare i dati che riflettono la modalità di accettazione dei messaggi da parte di un endpoint. Sono reperibili nell'oggetto prestazione ServiceModelEndpoint 3.0.0.0 in caso di visualizzazione con Performance Monitor. Le istanze vengono denominate utilizzando il modello seguente:

(ServiceName).(ContractName)@(endpoint listener address)

I dati sono simili a quelli raccolti per le singole operazioni, ma vengono aggregati soltanto nell'endpoint.

Un contatore nell'ambito di un endpoint viene aggregato dai contatori in un insieme di operazioni.

Nota

Se due endpoint hanno nomi e indirizzi di contratto identici, vengono mappati alla stessa istanza di contatore.

Contatori delle prestazioni a livello di operazione

I contatori delle prestazioni a livello di operazione sono reperibili nell'oggetto prestazione ServiceModelOperation 3.0.0.0 in caso di visualizzazione con Performance Monitor. Ogni operazione ha un'istanza singola. Ovvero, se un determinato contratto ha 10 operazioni, ad esso sono associate 10 istanze di contatore per l'operazione. Le istanze di oggetti vengono denominate utilizzando il modello seguente:

(ServiceName).(ContractName).(OperationName)@(first endpoint listener address)

Questo contatore consente di misurare come viene utilizzata la chiamata e le prestazioni dell'operazione.

Quando i contatori sono visibili su più ambiti, i dati raccolti da un ambito di livello superiore vengono aggregati ai dati relativi ad ambiti di livello inferiore. Ad esempio, il contatore Calls in un endpoint rappresenta la somma di tutte le chiamate a operazioni all'interno dell'endpoint; mentre il contatore Calls in un servizio rappresenta la somma di tutte le chiamate a tutti gli endpoint all'interno del servizio.

Nota

Se in un contratto sono presenti nomi di operazione duplicati, per entrambe le operazioni è possibile ottenere soltanto le istanze di un solo contatore.

Programmazione dei contatori delle prestazioni di WCF

Nella cartella di installazione dell'SDK sono presenti diversi file che consentono di accedere ai contatori delle prestazioni di WCF a livello di programmazione. Di seguito è riportato l'elenco di questi file.

  • _ServiceModelEndpointPerfCounters.vrg
  • _ServiceModelOperationPerfCounters.vrg
  • _ServiceModelServicePerfCounters.vrg
  • _SMSvcHostPerfCounters.vrg
  • _TransactionBridgePerfCounters.vrg

Per ulteriori informazioni sull'accesso ai contatori a livello di programmazione, vedere la pagina relativa all'architettura di programmazione dei contatori delle prestazioni.

Vedere anche

Concetti

Amministrazione e diagnostica