Partager via


NSDiagnosticEventProvider (Transact-SQL)

Produit le rapport du fournisseur d'événements pour une application Microsoft SQL Server Notification Services. Ce rapport contient des informations sur les événements collectés via un fournisseur d'événements spécifié.

Syntaxe

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

Arguments

[ @ApplicationName = ] 'app_name'

Nom d'une application, tel qu'il est défini dans le fichier de configuration. L'argument app_name est de type nvarchar(255) et n'a pas de valeur par défaut.

[ @EventProviderName = ] 'event_provider_name'

Nom d'un fournisseur d'événements dans l'application. L'argument event_provider_name est de type nvarchar(255) et n'a pas de valeur par défaut.

[ @ReportingInterval = ] interval

Nombre de quanta de générateur dans chaque intervalle de rapport. Le rapport contient une ligne par intervalle. L'argument interval est de type int, avec 1 comme valeur par défaut pour indiquer un quantum de générateur par intervalle.

La durée du quantum est définie dans le fichier de définition d'application.

[ @StartDateTime = ] 'start_date_time'

Date et heure de début du rapport au format UTC (Coordinated Universal Time) ou GMT (Greenwich Mean Time). L'argument start_date_time est de type datetime. La valeur par défaut est @EndDateTime - (5 * QuantumDuration * @ReportingInterval). Lorsque vous utilisez la valeur par défaut, l'ensemble de résultats contient au maximum cinq lignes représentant chacune un intervalle de rapport.

[ @EndDateTime = ] 'end_date_time'

Date et heure de fin de rapport, en heure UTC. L'argument end_date_time est de type datetime. La valeur par défaut est l'heure à laquelle vous appelez la procédure stockée (format UTC).

Notes

Notification Services crée la procédure stockée NSDiagnosticEventProvider dans la base de données d'instance lors de la création de l'instance. Lors de la mise à jour de l'instance, Notification Services recompile la procédure stockée.

La procédure stockée se trouve dans le schéma d'instance spécifié par l'élément SchemaName du fichier de configuration d'instance. Si aucun nom de schéma n'est fourni, le schéma par défaut est dbo.

Les lots d'événements tombent dans l'intervalle de rapport lorsque la valeur EndCollectionTime est supérieure à IntervalStartDateTime et inférieure ou égale à IntervalEndDateTime.

Pour déterminer la date et l'heure UTC actuelles, exécutez SELECT GETUTCDATE() dans SQL Server Management Studio. L'heure UTC actuelle est obtenue à partir du paramètre d'heure locale actuelle et de fuseau horaire du système d'exploitation de l'ordinateur sur lequel est exécuté SQL Server.

Autorisations

Les autorisations d'exécution sont accordées par défaut aux membres du rôle de base de données NSAnalysis, du rôle de base de données fixe db_owner et du rôle de serveur fixe sysadmin.

Valeurs des codes renvoyés

0 (succès) ou 1 (échec)

Ensembles de résultats

Nom de la colonne Type de données Description

IntervalStartDateTime

datetime

Date et heure de début de l'intervalle de rapport au format UTC.

IntervalEndDateTime

datetime

Date et heure de fin de l'intervalle de rapport au format UTC.

EventBatchesSubmitted

int

Nombre de lots d'événements envoyés par le fournisseur d'événements au cours de l'intervalle de rapport.

EventsSubmitted

int

Nombre d'événements envoyés par le fournisseur d'événements au cours de l'intervalle de rapport.

AvgTimeCollectingEvents

float

Durée moyenne, en secondes, passée par le fournisseur d'événements à collecter des événements au cours de l'intervalle de rapport.

UnfinishedEventBatches

int

Nombre de lots d'événements démarrés, mais non terminés, par le fournisseur d'événements au cours de l'intervalle de rapport.

Exemples

A. Spécification d'un intervalle de rapport et d'une heure de début et de fin

Cet exemple produit le rapport de diagnostic du fournisseur d'événements pour l'application Flight et le fournisseur d'événements FlightEP. L'instance utilise les paramètres de base de données par défaut et place tous les objets d'instance dans le schéma dbo.

Le rapport comprend 50 quanta de générateur dans chaque intervalle de rapport. Le rapport démarre à 17h00 le 23 mai 2004 et se termine à 18h00 le même jour (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. Utilisation des valeurs par défaut et du schéma nommé

Cet exemple produit le rapport de diagnostic du fournisseur d'événements pour l'application Flight et le fournisseur d'événements FlightEP. Dans cet exemple, la procédure stockée (comme tous les autres objets d'instance) se trouve dans le schéma FlightInstance, comme spécifié dans l'élément SchemaName du fichier de configuration d'instance.

Le rapport utilise des valeurs par défaut, spécifiant l'affichage des données des cinq derniers quanta de générateur.

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

Voir aussi

Référence

Procédures stockées de Notification Services (Transact-SQL)

Autres ressources

Rapports de performances de Notification Services
SchemaName Element (ICF)

Aide et Informations

Assistance sur SQL Server 2005