NSAdministrationHistory (Transact-SQL)

Artikel
12/15/2008

Erstellt den administrativen Verlaufsbericht für eine Instanz von Microsoft SQL Server Notification Services. Der Bericht enthält Informationen zu allen Anwendungen, für die die Instanz als Host fungiert. Dies schließt Ereignisse, Benachrichtigungen und Abonnements ein, die während eines definierten Zeitintervalls verarbeitet wurden.

Syntax

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

Argumente

[ @ApplicationName = ] 'app_name'

Der Name der Notification Services-Anwendung gemäß der Definition in der Instanzkonfigurationsdatei (ICF, Instance Configuration File). app_name ist ein Wert vom Datentyp nvarchar(255) und weist den Standardwert NULL auf. Dieser gibt an, dass der Bericht alle Anwendungen einschließen soll, für die die Instanz als Host fungiert.

[ @ReportingIntervalInMinutes = ] interval

Der Anzahl von Minuten in jedem Berichtsintervall. Der Bericht enthält eine Zeile pro Intervall. interval ist ein Wert vom Datentyp int und weist den Standardwert 60 auf. Dieser gibt eine Dauer von 60 Minuten pro Berichtsintervall an.

[ @StartDateTime = ] 'start_date_time'

Das Datum und die Uhrzeit des Startzeitpunkts für den Bericht, angegeben in UTC (Coordinated Universal Time, Koordinierte Weltzeit oder Greenwich Mean Time). start_date_time ist ein Wert vom Datentyp datetime und weist als Standardwert das Datum auf, das einen Monat vor dem Wert für @EndDateTime liegt.

[ @EndDateTime = ] 'end_date_time'

Das Datum und die Uhrzeit des Beendigungszeitpunkts, angegeben in UTC. end_date_time ist ein Wert vom Datentyp datetime. Der Standardwert ist das Ergebnis der GETUTCDATE-Funktion, die den Zeitpunkt zurückgibt, an dem die gespeicherte Prozedur aufgerufen wurde.

Rückgabecodewerte

Keine

Resultsets

Spaltenname	Datentyp	Beschreibung
ApplicationName	nvarchar(255)	Der Name der Anwendung, die in der Zeile zusammengefasst wird. Für die Zeile, die die Instanz zusammenfasst, weist diese Spalte den Wert NULL auf.
IntervalStartDateTime	datetime	Startdatum und -uhrzeit für das Berichtsintervall, angegeben in UTC.
IntervalEndDateTime	datetime	Enddatum und -uhrzeit für das Berichtsintervall, angegeben in UTC.
EventBatchCollectedCount	int	Anzahl von Ereignisbatches, die während des Berichtsintervalls aufgelistet wurden, wobei diese Zuordnung auf dem EndCollectionTime-Wert des Ereignisbatches basiert.
EventsCollectedCount	int	Anzahl von Ereignissen, die während des Berichtsintervalls aufgelistet wurden, wobei diese Zuordnung auf dem EndCollectionTime-Wert des Ereignisbatches basiert.
EventsCollectedPerSecond	float	Durchschnittliche Anzahl von Ereignissen, die während der Ereignisauflistung im Berichtsintervall pro Sekunde aufgelistet wurden.
EventBatchesAwaitingGeneration	int	Anzahl von Ereignisbatches, die in die Datenbank geschrieben, jedoch nicht vom Generator verarbeitet wurden.
EventBatchesInCollection	int	Anzahl von Ereignisbatches, die sich während des Berichtsintervalls in der Ereignisauflistungsphase befanden.
NotificationBatchGeneratedCount	int	Anzahl von Benachrichtigungsbatches, die während des Berichtsintervalls geschrieben wurden, wobei diese Zuordnung auf dem EndGenerationTime-Wert des Benachrichtigungsbatches basiert.
NotificationsGeneratedCount	int	Anzahl von Benachrichtigungen, die während des Berichtsintervalls generiert wurden, wobei diese Zuordnung auf dem EndGenerationTime-Wert des Benachrichtigungsbatches basiert.
NotificationsGeneratedPerSecond	float	Durchschnittliche Anzahl von Benachrichtigungen, die während des Berichtsintervalls pro Sekunde generiert wurden.
NotificationBatchesInGeneration	int	Anzahl von Benachrichtigungsbatches, die sich während des Berichtsintervalls in der Phase der Erstellung durch den Generator befanden.
NotificationBatchesAwaitingDistribution	int	Anzahl von Benachrichtigungsbatches, die während des Berichtsintervalls darauf warten, vom Verteiler aufgenommen zu werden.
NotificationsSuccessfulDeliveredCount	int	Anzahl von Benachrichtigungen, die während des Berichtsintervalls erfolgreich übermittelt wurden.
NotificationsFailedDeliveryCount	int	Anzahl von Benachrichtigungen, deren Übermittlung während des Berichtsintervalls fehlgeschlagen ist und die daher als abgelaufen markiert wurden.
WorkItemsInProgress	int	Anzahl von Arbeitselementen, die während des Berichtsintervalls verteilt wurden.
SubscriptionsAddedCount	int	Anzahl von Abonnements, die während des Berichtsintervalls der Anwendung hinzugefügt wurden.
ScheduledSubscriptionsAdded	int	Anzahl von geplanten Abonnements, die während des Berichtsintervalls der Anwendung hinzugefügt wurden.
SubscriptionsModified	int	Anzahl von Abonnements, die während des Berichtsintervalls in der Anwendung geändert wurden.
SubscribersAddedCount	int	Anzahl von Abonnenten, die während des Berichtsintervalls der Instanz hinzugefügt wurden.
SubscriberDevicesAddedCount	int	Anzahl von Abonnentengeräten, die während des Berichtsintervalls hinzugefügt wurden. Es wird angenommen, dass das Gerät zu demselben Zeitpunkt wie der Abonnent hinzugefügt wird.
SubscriberDevicesModifiedCount	int	Anzahl von Abonnentengeräten, die während des Berichtsintervalls aktualisiert wurden. Es wird angenommen, dass das Gerät zu demselben Zeitpunkt wie der Abonnent aktualisiert wird.

Hinweise

Notification Services erstellt die gespeicherte Prozedur NSAdministrationHistory in der Instanzdatenbank, wenn Sie die Instanz erstellen. Wenn Sie die Instanz aktualisieren, wird die gespeicherte Prozedur von Notification Services neu kompiliert.

Diese gespeicherte Prozedur befindet sich in dem Instanzschema, das durch das SchemaName-Element der ICF angegeben ist. Wenn kein Schemaname bereitgestellt wird, ist dbo das Standardschema.

Die Menge der durch diesen Bericht gesammelten Daten wird durch die Beibehaltungsdauer des Vacuumprozesses begrenzt, die im VacuumDuration-Element der Anwendungsdefinitionsdatei (ADF, Application Definition File) angegeben ist. Es können nur Daten analysiert werden, die nicht entfernt wurden.

Sie können das aktuelle Datum und die aktuelle Uhrzeit gemäß UTC ermitteln, indem Sie die Transact-SQL-Abfrage SELECT GETUTCDATE() ausführen. Die aktuelle UTC-Zeit wird aus der aktuellen Ortszeit und den Zeitzoneneinstellungen im Betriebssystem des Computers abgeleitet.

Berechtigungen

Standardmäßig verfügen Mitglieder der NSAnalysis-Datenbankrolle, der festen Datenbankrolle db_owner und der festen Serverrolle sysadmin über Ausführungsberechtigungen.

Beispiele

A. Administrativer Verlaufsbericht für "Flight"

Im folgenden Beispiel wird der administrative Verlaufsbericht für die Anwendung Flight erstellt. Die Instanz verwendet die Standard-Datenbankeinstellungen, wodurch alle Instanzobjekte dem dbo-Schema zugeordnet werden.

Das Berichtsintervall ist 120 Minuten lang. Der Bericht beginnt am 22. September 2004 um 11:30 Uhr und endet am selben Tag um 14:30 Uhr.

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

B. Administrativer Verlaufsbericht für alle Anwendungen

Im folgenden Beispiel wird der administrative Verlaufsbericht für alle Anwendungen erstellt, für die die Instanz als Host fungiert. In diesem Beispiel befindet sich die gespeicherte Prozedur im FlightInstance-Schema, wie im SchemaName-Element der ICF angegeben ist.

Der Bericht verwendet Standardwerte. Dies bedeutet, dass alle Daten für den vergangenen Monat mithilfe eines Berichtsintervalls von 60 Minuten angezeigt werden.

EXEC FlightInstance.NSAdministrationHistory;

Siehe auch

Share via