NSAdministrationHistory (Transact-SQL)

Artículo
12/15/2008

Genera el informe de historial administrativo para una instancia de Microsoft SQL Server Notification Services. El informe contiene información sobre todas las aplicaciones que aloja la instancia, incluidos los eventos, las notificaciones y las suscripciones procesadas durante un intervalo de tiempo definido.

Sintaxis

[ schema_name . ] NSAdministrationHistory 
    [  [ @ApplicationName = ] 'app_name' ],
    [, [ @ReportingIntervalInMinutes = ] interval ] 
    [, [ @StartDateTime = ] 'start_date_time' ] 
    [, [ @EndDateTime = ] 'end_date_time' ]

Argumentos

[ @ApplicationName = ] 'app_name'

Es el nombre de la aplicación de Notification Services, tal como se define en el archivo de configuración de la instancia (ICF). app_name es de tipo nvarchar(255) y su valor predeterminado es NULL, que indica que se incluyan en el informe todas las aplicaciones alojadas en la instancia.

[ @ReportingIntervalInMinutes = ] interval

Es el número de minutos en cada intervalo de informe. El informe contiene una fila por intervalo. interval es de tipo int y su valor predeterminado es 60, que indica 60 minutos por intervalo de informe.

[ @StartDateTime = ] 'start_date_time'

Es la fecha y hora de inicio del informe, expresadas en UTC (hora universal coordinada u hora del meridiano de Greenwich). start_date_time es de tipo datetime y, de forma predeterminada, es un mes anterior al valor de @EndDateTime.

[ @EndDateTime = ] 'end_date_time'

Es la fecha y hora de finalización del informe en UTC. El valor de end_date_time es del tipo de datos datetime. El valor predeterminado es el resultado de la función GETUTCDATE, que devuelve el momento en que se invocó el procedimiento almacenado.

Conjuntos de resultados

Nombre de columna	Tipo de datos	Descripción
ApplicationName	nvarchar(255)	Nombre de la aplicación que resume la fila. Este valor es NULL para la fila que resume la instancia.
IntervalStartDateTime	datetime	Fecha y hora de inicio del intervalo de informe con formato UTC.
IntervalEndDateTime	datetime	Fecha y hora de finalización del intervalo de informe con formato UTC.
EventBatchCollectedCount	int	Número de lotes de eventos recopilados durante el intervalo de informe, sobre la base del valor EndCollectionTime del lote de eventos.
EventsCollectedCount	int	Número de eventos recopilados durante el intervalo de informe, sobre la base del valor EndCollectionTime del lote de eventos.
EventsCollectedPerSecond	float	En la recopilación de eventos, número promedio de eventos recopilados por segundo para el intervalo de informe.
EventBatchesAwaitingGeneration	int	Número de lotes de eventos escritos en la base de datos pero no procesados por el generador.
EventBatchesInCollection	int	Número de lotes de eventos que están en la fase de recopilación de eventos durante el intervalo de informe.
NotificationBatchGeneratedCount	int	Número de lotes de eventos escritos durante el intervalo de informe, sobre la base del valor EndGenerationTime del lote de notificaciones.
NotificationsGeneratedCount	int	Número de notificaciones generadas durante el intervalo de informe, sobre la base del valor EndGenerationTime del lote de notificaciones.
NotificationsGeneratedPerSecond	float	Número promedio de notificaciones generadas por segundo durante el intervalo de informe.
NotificationBatchesInGeneration	int	Número de lotes de notificaciones que están en proceso de ser creados por el generador durante el intervalo de informe.
NotificationBatchesAwaitingDistribution	int	Número de lotes de notificaciones en espera de ser recogidos por el distribuidor durante el intervalo de informe.
NotificationsSuccessfulDeliveredCount	int	Número de notificaciones entregadas correctamente durante el intervalo de informe.
NotificationsFailedDeliveryCount	int	Número de notificaciones con errores de entrega y marcadas como caducadas durante el intervalo de informe.
WorkItemsInProgress	int	Número de elementos de trabajo que se distribuyen durante el intervalo de informe.
SubscriptionsAddedCount	int	Número de suscripciones agregadas a la aplicación durante el intervalo de informe.
ScheduledSubscriptionsAdded	int	Número de suscripciones programadas agregadas a la aplicación durante el intervalo de informe.
SubscriptionsModified	int	Número de suscripciones modificadas en la aplicación durante el intervalo de informe.
SubscribersAddedCount	int	Número de suscriptores agregados a la instancia durante el intervalo de informe.
SubscriberDevicesAddedCount	int	Número de dispositivos de suscriptor agregados durante el intervalo de informe. Se da por supuesto que el dispositivo se agrega al mismo tiempo que el suscriptor.
SubscriberDevicesModifiedCount	int	Número de dispositivos de suscriptor actualizados durante el intervalo de informe. Se da por supuesto que el dispositivo se actualiza al mismo tiempo que el suscriptor.

Notas

Notification Services crea el procedimiento almacenado NSAdministrationHistory en la base de datos de instancias al crear la instancia. Al actualizar la instancia, Notification Services vuelve a compilar el procedimiento almacenado.

Este procedimiento almacenado se encuentra en el esquema de la instancia, que se especifica mediante el elemento SchemaName del archivo de configuración de la instancia (ICF). Si no se proporciona ningún nombre de esquema, el esquema predeterminado es dbo.

La cantidad de datos que recopila este informe está limitada por el período de retención del proceso de supresión de datos (Vacuumer) especificado en el elemento VacuumDuration del archivo de definición de aplicación (ADF). Sólo se pueden analizar los datos que no se han quitado.

Para determinar la fecha y hora UTC actuales, ejecute la consulta Transact-SQL SELECT GETUTCDATE(). La hora UTC actual se deriva de la hora local actual y la configuración de zona horaria del sistema operativo del equipo.

Permisos

De forma predeterminada, los permisos de ejecución corresponden a los miembros de la función de base de datos NSAnalysis, la función fija de base de datos db_owner y la función fija de servidor sysadmin.

Valores de código de retorno

Ninguno

Ejemplos

A. Historial administrativo de Flight

En el ejemplo siguiente se genera el informe de historial administrativo de la aplicación Flight. La instancia utiliza la configuración predeterminada de la base de datos, que coloca todos los objetos de la instancia en el esquema dbo.

El intervalo de informe es de 120 minutos. El informe abarca desde las 11:30 a.m. hasta las 2:30 p.m. del día 22 de septiembre de 2004.

EXEC dbo.NSAdministrationHistory 
    @ApplicationName = N'Flight', 
    @ReportingIntervalInMinutes = 120, 
    @StartDateTime = '2004-09-22 11:30:00', 
    @EndDateTime = '2004-09-22 14:30:00';

B. Historial administrativo de todas las aplicaciones

En el ejemplo siguiente se genera el informe de historial administrativo para todas las aplicaciones alojadas en la instancia. En este ejemplo, el procedimiento almacenado se encuentra en el esquema FlightInstance, según se especifica en el elemento SchemaName del ICF.

El informe utiliza los valores predeterminados para mostrar los datos del mes pasado utilizando un intervalo de informe de 60 minutos.

EXEC FlightInstance.NSAdministrationHistory;

Vea también

Share via