Destinazioni degli eventi estesi di SQL Server

Destinazione bucket dell'evento

La destinazione bucket dell'evento raggruppa le occorrenze di un tipo di evento specifico in base ai dati relativi all'evento. Per "bucket" si intende un raggruppamento di eventi conteggiati in base a una colonna di evento oppure a un'azione specificata. È possibile utilizzare la destinazione bucket dell'evento per risolvere i problemi relativi alle prestazioni. Grazie all'identificazione degli eventi che si verificano più di frequente, è infatti possibile individuare elementi specifici che indicano la causa potenziale di un problema relativo alle prestazioni.

Nella tabella seguente vengono descritte le opzioni che consentono di configurare la destinazione bucket dell'evento.

SELECT p.name, se.event_name
FROM sys.dm_xe_session_events se
JOIN sys.dm_xe_packages p
ON se_event_package_guid = p.guid
ORDER BY p.name, se.event_name

SELECT name FROM sys.dm_xe_object_columns
WHERE object_name = '<eventname>'
AND column_type != 'readonly'

Nell'esempio seguente viene illustrato, a un livello elevato, il modo in cui i dati vengono raccolti nella destinazione bucket dell'evento. Nell'esempio la destinazione bucket dell'evento viene utilizzata per contare il numero di volte in cui si verifica ogni tipo di attesa. A questo scopo, è necessario specificare le opzioni seguenti quando si definisce la destinazione del bucket dell'evento:

• filtering_event_name = 'wait_info'

• source = 'wait_type'

• source_type = 0 (poiché wait_type è una colonna di evento)

Nello scenario di esempio per l'origine wait_type vengono registrati i dati seguenti:

I valori relativi al tipo di attesa verranno inseriti in tre bucket, cui sono associati i valori e i conteggi di slot seguenti:

Per ulteriori informazioni sulla sintassi della destinazione bucket dell'evento, vedere Procedura: Monitoraggio dell'attività del sistema mediante gli eventi estesi.

Nella destinazione bucket vengono mantenuti solo i dati degli eventi per l'origine specificata. Nel caso in cui le dimensioni dei dati degli eventi siano troppo elevate per mantenere completamente i dati, questi ultimi vengono troncati. Quando i dati degli eventi sono troncati, il numero di byte è registrato e visualizzato come output XML.

La destinazione bucket serializza i dati su un programma che esegue la chiamata o una procedura in formato XML.

Nell'esempio seguente è illustrato il formato di output della destinazione bucket.

<Slots truncated = "0" buckets=[count]>
    <Slot count=[count] trunc=[truncated bytes]>
        <value>
        </value>
    </Slot>
</Slots>

Destinazione abbinamento dell'evento

La destinazione abbinamento dell'evento mette in corrispondenza due eventi utilizzando una o più colonne di dati presenti in ciascun evento. Molti eventi entrano nelle coppie, ad esempio, le acquisizioni e i rilasci del blocco. Dopo che una sequenza dell'evento viene abbinata, entrambi gli eventi sono ignorati. Il fatto di ignorare i set corrispondenti consente un facile rilevamento di acquisizioni del blocco che non sono state rilasciate.

Utilizzando filtri a livello di evento, la destinazione abbinamento può essere utilizzata solamente per acquisire eventi che non corrispondono a criteri preimpostati.

Quando si utilizza la destinazione abbinamento dell'evento, è possibile scegliere due eventi corrispondenti, insieme a una sequenza di colonne su cui eseguire la corrispondenza. Tutte le colonne nella sequenza devono essere dello stesso tipo.

Nella tabella seguente vengono descritte le opzioni disponibili per configurare l'abbinamento dell'evento.

Tutti i dati associati a un evento sono acquisiti e archiviati per un abbinamento futuro. Inoltre, vengono raccolti anche i dati aggiunti dalle azioni. I dati degli eventi raccolti sono archiviati in memoria e, come tali, hanno un limite finito. Questo limite è basato sulla capacità e l'attività del sistema. Invece di prendere la quantità massima di memoria da utilizzare come parametro, la quantità di memoria utilizzata sarà basata sulle risorse di sistema disponibili. Quando queste non sono disponibili, gli eventi non abbinati che sono stati mantenuti saranno eliminati. Se un evento non è stato abbinato ed è stato eliminato, l'evento corrispondente comparirà come un evento non abbinato.

La destinazione abbinamento serializza gli eventi non abbinati a un formato XML. Questo formato non è conforme ad alcun schema. Il formato contiene solo due tipi di elementi. L'<elemento non abbinato> è la radice, seguita da un elemento <evento> per ogni evento non abbinato che viene attualmente monitorato. L'elemento <evento> contiene un attributo che contiene il nome dell'evento non abbinato.

Nell'esempio seguente viene illustrato il formato di output della destinazione abbinamento.

<unpaired truncated = "0" matchedCount = "[matched count]" memoryPressureDroppedCount = " [lost count]">
    <event name  = "[event name]" package = "[package]" id= "[event ID value]" version = "[event version]">
    <data name = "[column name]"> 
    <type name = "[column type]" package = "[type package]" /> 
    <value>[column value]</value>
    <text value>[text value]</text>>
        </data>
    </event>
</unpaired>

Destinazione Analisi eventi per Windows

Prima di utilizzare Analisi eventi per Windows (ETW) come destinazione, è consigliabile acquisire familiarità con tale funzionalità. L'analisi ETW è utilizzata in abbinamento agli eventi estesi o come un consumer di eventi estesi. I collegamenti esterni seguenti rappresentano un punto iniziale per ottenere informazioni di base su ETW:

• Windows Events

• Migliora il debug e la regolazione delle prestazioni con ETW

Gli eventi estesi supportano le versioni Windows XP e Windows Server 2003 di ETW. Sebbene possa essere aggiunta a numerose sessioni, la destinazione ETW è una destinazione singleton. Se un evento viene generato in più sessioni, verrà propagato alla destinazione ETW solo una volta per ogni occorrenza. Il motore degli eventi estesi è limitato a un'unica istanza per processo.

Importante
Affinché la destinazione ETW funzioni, l'account di avvio del servizio SQL Server deve essere membro del gruppo Performance Log Users.

La configurazione degli eventi presente in una sessione ETW è controllata dal processo che ospita il motore degli eventi estesi. Il motore controlla gli eventi da generare e le condizioni che devono essere soddisfatte per la generazione di un evento.

Dopo avere eseguito un'associazione a una sessione degli eventi estesi, il che allega per la prima volta la destinazione ETW per la durata di un processo, la destinazione ETW apre una sola sessione ETW sul provider SQL Server. Se una sessione ETW esiste già, la destinazione ETW ottiene un riferimento alla sessione esistente. Questa sessione ETW è condivisa in tutte le istanze SQL Server su un dato computer. Questa sessione ETW riceve tutti gli eventi da sessioni che possiedono la destinazione ETW.

Poiché ETW ha bisogno che i provider siano abilitati per utilizzare gli eventi e trasmetterli verso il basso a ETW, tutti i pacchetti degli eventi estesi sono attivati nella sessione. Quando un evento è generato, la destinazione ETW invia l'evento alla sessione sulla quale è abilitato il provider per l'evento.

La destinazione ETW supporta la pubblicazione sincrona di eventi sul thread che genera l'evento. Tale destinazione tuttavia non supporta la pubblicazione asincrona di eventi.

La destinazione ETW non supporta il controllo da controller ETW esterni, ad esempio logman.exe. Per produrre tracce di ETW, una sessione dell'evento deve essere creata con la destinazione ETW. Per ulteriori informazioni, vedere CREATE EVENT SESSION (Transact-SQL).

Nella tabella seguente vengono descritte le opzioni disponibili per la configurazione della destinazione ETW.

La configurazione delle impostazioni precedenti è facoltativa. La destinazione ETW utilizza valori predefiniti per queste impostazioni.

La destinazione ETW è responsabile per:

• Creazione della sessione ETW predefinita.

• Registrazione di tutti i pacchetti degli eventi estesi con ETW. Ciò assicura che gli eventi non siano eliminati da ETW.

• Gestione dell'invio del flusso di eventi a ETW. La destinazione ETW crea un evento ETW con i dati degli eventi estesi e lo invia alla sessione ETW appropriata. Se l'evento è più grande della dimensione del buffer o se i dati non possono adattarsi a un evento ETW, ETW suddivide l'evento in frammenti.

• Conservazione dei pacchetti degli eventi estesi sempre abilitata.

I seguenti percorsi predefiniti dei file sono utilizzati da ETW:

• Il percorso del file di output per ETW è %TEMP%\XEEtw.etl.

  Importante
  Impossibile modificare il percorso del file dopo l'inizio della prima sessione.

• I file Managed Object Format (MOF) si trovano in <percorso di installazione>\Microsoft SQL Server\Shared. Per ulteriori informazioni, vedere Managed Object Format in MSDN.

Destinazione file di eventi

La destinazione file di eventi è una destinazione asincrona che prevede la scrittura di buffer completi sul disco e la creazione di due tipi di file, ovvero il file di log e quello dei metadati. Nel file dei metadati viene descritto il contenuto degli eventi presente nel file di log di output di destinazione. In questo modo l'analisi di tutti gli eventi presenti nel file di log e quella dei dati dell'azione associati a un evento vengono eseguite in modo corretto.

Per utilizzare questa destinazione, è necessario specificare il percorso del file di log e del file dei metadati. Altre opzioni di configurazione, ad esempio le caratteristiche sulle dimensioni del file e sul relativo aumento, sono facoltative.

Nella tabella seguente vengono descritte le opzioni disponibili per configurare un file di eventi utilizzato come destinazione.

La prima volta che viene creata una destinazione del file, il nome del file specificato viene aggiunto con 0 e un valore long integer. Il valore integer viene calcolato come il numero di millisecondi compresi tra l'1 gennaio 1600 e la data e l'ora di creazione del file. Questo formato viene utilizzato anche da file di rollover successivi. L'analisi del valore long integer consente di determinare il file più recente. Nell'esempio seguente viene illustrato come denominare i file in uno scenario in cui l'opzione relativa al nome di file viene specificata come C:\OutputFiles\MyOutput.xel:

• primo file creato - C:\OutputFiles\MyOutput_0_128500310259380000.xel

• primo file di rollover - C:\OutputFiles\MyOutput_0_128505831770890000.xel

• secondo file di rollover - C:\OutputFiles\MyOutput_0_132410772966237000.xel

Destinazione contatore degli eventi sincroni

La destinazione contatore degli eventi sincroni conta tutti gli eventi generati durante una sessione di eventi estesi. Utilizzando la destinazione contatore è possibile ottenere informazioni sulle caratteristiche del carico di lavoro senza aggiungere l'overhead di un'intera raccolta di eventi. Questa destinazione non dispone di parametri personalizzabili.

Nell'esempio seguente viene illustrato l'output della destinazione contatore degli eventi.

<CounterTarget truncated = "0">
  <Packages>
    <Package name = "[package name]">
      <Event name = "[event name]" count = "[number]" />
    </Package>
  </Packages>
</CounterTarget>

Destinazione buffer circolare

Il buffer circolare mantiene brevemente in memoria i dati relativi agli eventi. Questa destinazione può gestire gli eventi in due modalità diverse.

• La prima è una modalità di tipo puramente FIFO, in base alla quale l'evento meno recente viene eliminato quando tutta la memoria allocata alla destinazione è stata utilizzata. In questa modalità, che rappresenta quella predefinita, il valore dell'opzione occurrence_number è impostato su 0.

• La seconda è una modalità FIFO basata sul tipo di evento, che prevede di mantenere in memoria un numero specificato di eventi di ciascun tipo. In base a tale modalità, gli eventi meno recenti di ciascun tipo vengono eliminati quando tutta la memoria allocata alla destinazione è stata utilizzata. È possibile configurare occurrence_number per specificare il numero di eventi di ciascun tipo da mantenere.

Nella tabella seguente vengono descritte le opzioni disponibili per configurare una destinazione buffer circolare.

Nell'esempio seguente viene illustrato l'output di un buffer circolare utilizzato come destinazione.

<RingBufferTarget eventsPerSec="" processingTime="" totalEventsProcessed="" eventCount="" droppedCount="" memoryUsed="">
 <event name="" package="" id="" version="" timestamp="">
    <data name="">
      <type name="" package="" />
      <value></value>
      <text></text>
    </data>
    <action name="" package="">
      <type name="" package="" />
      <value></value>
      <text></text>
    </action>
  </event>
</RingBufferTarget>

Vedere anche

Concetti