NSDiagnosticEventProvider (Transact-SQL)

Articolo
12/15/2008

Genera il report del provider di eventi per una applicazione di Microsoft SQL Server Notification Services. Il report contiene informazioni sugli eventi raccolti tramite un provider di eventi specificato.

Sintassi

[ schema_name . ] NSDiagnosticEventProvider 
    [ @ApplicationName = ] 'app_name' ,
    [ @EventProviderName = ] 'event_provider_name' 
    [, [ @ReportingInterval = ] interval ] 
    [, [ @StartDateTime = ] 'start_date_time' ] 
    [, [ @EndDateTime = ] 'end_date_time' ]

Argomenti

[ @ApplicationName = ] 'app_name'

Nome di un'applicazione, come definito nel file di configurazione. app_name è di tipo nvarchar(255) e non prevede alcun valore predefinito.

[ @EventProviderName = ] 'event_provider_name'

Nome del provider di eventi all'interno dell'applicazione. event_provider_name è di tipo nvarchar(255) e non prevede alcun valore predefinito.

[ @ReportingInterval = ] interval

Numero di quantum del generatore per ogni intervallo di report. Il report contiene una riga per intervallo. interval è di tipo int e il valore predefinito è 1, che indica un quantum del generatore per intervallo.

La durata del quantum viene definita nel file di definizione dell'applicazione (ADF).

[ @StartDateTime = ] 'start_date_time'

Data e ora UTC (Coordinated Universal Time o ora di Greenwich) di inizio del report. start_date_time è di tipo datetime. Il valore predefinito è @EndDateTime - (5 * QuantumDuration * @ReportingInterval). Utilizzando il valore predefinito, il set dei risultati contiene al massimo cinque righe, ognuna delle quali rappresenta un intervallo di report.

[ @EndDateTime = ] 'end_date_time'

Data e ora UTC di fine del report. end_date_time è di tipo datetime. Il valore predefinito è l'ora UTC in cui viene richiamata la stored procedure.

Set di risultati

Nome colonna	Tipo di dati	Descrizione
IntervalStartDateTime	datetime	Data e ora UTC (Coordinated Universal Time o ora di Greenwich) di inizio per l'intervallo di report.
IntervalEndDateTime	datetime	Data e ora UTC (Coordinated Universal Time o ora di Greenwich) di fine per l'intervallo di report.
EventBatchesSubmitted	int	Numero di batch di eventi inoltrati dal provider di eventi durante l'intervallo di report.
EventsSubmitted	int	Numero di batch di eventi inoltrati dal provider di eventi durante l'intervallo di report.
AvgTimeCollectingEvents	float	Tempo medio, espresso in secondi, impiegato dal provider per la raccolta degli eventi durante l'intervallo di report.
UnfinishedEventBatches	int	Numero di batch di eventi avviati, ma non completati, dal provider di eventi durante l'intervallo di report.

Osservazioni

Quando si crea l'istanza, Notification Services crea la stored procedure NSDiagnosticEventProvider nel database dell'istanza. Quando si aggiorna l'istanza, Notification Services ricompila la stored procedure.

Questa stored procedure è disponibile nello schema dell'istanza, specificato dall'elemento SchemaName del file di configurazione dell'istanza (ICF). Se non si specifica un nome di schema, viene utilizzato lo schema predefinito dbo.

I batch di eventi sono compresi nell'intervallo di report quando il valore EndCollectionTime è maggiore di IntervalStartDateTime e minore o uguale a IntervalEndDateTime.

Per stabilire la data e l'ora UTC correnti, eseguire SELECT GETUTCDATE() in SQL Server Management Studio. L'ora UTC corrente è basata sull'ora locale corrente e sull'impostazione del fuso orario del sistema operativo del computer in cui è in esecuzione SQL Server.

Autorizzazioni

Le autorizzazioni di esecuzione vengono assegnate per impostazione predefinita ai membri del ruolo di database NSAnalysis, del ruolo predefinito del database db_owner e del ruolo predefinito del server sysadmin.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Esempi

A. Specifica dell'intervallo di report, dell'ora di avvio e dell'ora di inizio

In questo esempio viene generato il report di diagnostica per l'applicazione Flight e per il provider di eventi FlightEP. L'istanza utilizza le impostazioni predefinite del database, che prevedono l'inserimento di tutti gli oggetti dell'istanza nello schema dbo.

Il report include 50 quantum del generatore per ogni intervallo di report. Il report viene avviato alle 17.00 del 23 maggio 2004 e termina alle 18.00 dello stesso giorno (ora UTC).

EXEC dbo.NSDiagnosticEventProvider 
    @ApplicationName = N'Flight', 
    @EventProviderName = N'FlightEP', 
    @ReportingInterval = 50, 
    @StartDateTime = '2004-05-23 17:00', 
    @EndDateTime = '2004-05-23 18:00';

B. Utilizzo dei valori predefiniti, schema denominato

In questo esempio viene generato il report di diagnostica per l'applicazione Flight e per il provider di eventi FlightEP. In questo esempio, la stored procedure (come tutti gli altri oggetti dell'istanza) è inclusa nello schema FlightInstance, come specificato nell'elemento SchemaName del file di configurazione dell'istanza (ICF).

Il report utilizza i valori predefiniti, che specificano di visualizzare i dati relativi agli ultimi cinque quantum del generatore.

EXEC FlightInstance.NSDiagnosticEventProvider 
    @ApplicationName = N'Flight', 
    @EventProviderName = N'FlightEP';

Vedere anche

Share via