Benutzerdefinierte Meldungen für die Protokollierung

Integration Services stellt einen umfangreichen Satz an benutzerdefinierten Ereignissen zum Schreiben von Protokolleinträgen für Pakete und für mehrere Tasks bereit. Sie können diese Einträge verwenden, um detaillierte Informationen zum Fortschritt sowie über die Ergebnisse und Probleme der Ausführung zu speichern, indem Sie vordefinierte Ereignisse bzw. benutzerdefinierte Meldungen für die spätere Analyse erfassen. Sie können beispielsweise Beginn und Ende eines Masseneinfügungsvorgangs erfassen, um Leistungsprobleme beim Ausführen des Pakets zu identifizieren.

Die benutzerdefinierten Protokolleinträge unterscheiden sich von den für Pakete und alle Container und Tasks verfügbaren Standardprotokollierungsereignissen. Die benutzerdefinierten Protokolleinträge dienen zum Erfassen nützlicher Informationen zu einem bestimmten Task eines Pakets. Beispielsweise zeichnet einer der benutzerdefinierten Protokolleinträge für den Task SQL ausführen die von dem Task ausgeführte SQL-Anweisung im Protokoll auf.

In allen Protokolleinträgen sind jeweils das Datum und die Uhrzeit enthalten, einschließlich der beim Beginnen und Beenden eines Pakets automatisch geschriebenen Protokolleinträge. Bei vielen Protokollereignissen werden mehrere Einträge in das Protokoll geschrieben. In der Regel tritt dies dann auf, wenn ein Ereignis verschiedene Phasen aufweist. Beispielsweise schreibt das ExecuteSQLExecutingQuery-Protokollereignis drei Einträge: einen Eintrag, nachdem der Task eine Verbindung mit der Datenbank erhalten hat; einen weiteren, nachdem der Task begonnen hat, die SQL-Anweisung vorzubereiten; und noch einen, nachdem die Ausführung der SQL-Anweisung abgeschlossen wurde.

Die folgenden Integration Services-Objekte verfügen über benutzerdefinierte Protokolleinträge:

Paket

Masseneinfügung (Task)

Datenfluss (Task)

DTS 2000 ausführen (Task)

Prozess ausführen (Task)

SQL ausführen (Task)

Dateisystem (Task)

FTP (Task)

Nachrichtenwarteschlange (Task)

Skript (Task)

Mail senden (Task)

Datenbanken übertragen (Task)

Fehlermeldungen übertragen (Task)

Aufträge übertragen (Task)

Anmeldungen übertragen (Task)

In master gespeicherte Prozeduren übertragen (Task)

SQL Server-Objekte kopieren (Task)

Webdienste (Task)

WMI-Datenleser (Task)

WMI-Ereignisüberwachung (Task)

XML (Task)

Protokolleinträge

Paket

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für Pakete aufgelistet.

Protokolleintrag	Beschreibung
PackageStart	Zeigt den Beginn der Paketausführung an. Hinweis Dieser Protokolleintrag wird automatisch in das Protokoll geschrieben. Dieser Eintrag kann nicht ausgeschlossen werden.
PackageEnd	Zeigt den Abschluss der Paketausführung an. Hinweis Dieser Protokolleintrag wird automatisch in das Protokoll geschrieben. Dieser Eintrag kann nicht ausgeschlossen werden.
Diagnostic	Enthält Informationen zur Systemkonfiguration, die sich auf die Paketausführung auswirken, wie z. B. die Anzahl ausführbarer Dateien, die gleichzeitig ausgeführt werden können. Der Protokolleintrag Diagnostic enthält auch vorherige und nachfolgende Einträge für Aufrufe von externen Datenanbietern. Weitere Informationen finden Sie unter Tools zur Behandlung von Problemen mit Paketverbindungen.

Masseneinfügung (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Masseneinfügungstask aufgelistet.

Protokolleintrag	Beschreibung
DTSBulkInsertTaskBegin	Zeigt den Beginn der Masseneinfügung an.
DTSBulkInsertTaskEnd	Zeigt die Fertigstellung der Masseneinfügung an.
DTSBulkInsertTaskInfos	Enthält beschreibende Informationen zum Task.

Datenfluss (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Datenflusstask aufgelistet.

Protokolleintrag	Beschreibung
BufferSizeTuning	Zeigt an, dass die Puffergröße durch den Datenflusstask geändert wurde. Der Protokolleintrag beschreibt die Gründe für die Größenänderung und listet die temporäre neue Puffergröße auf.
OnPipelinePostEndOfRowset	Gibt an, dass eine Komponente das Signal für das Ende des Rowsets erhalten hat. Dieses Signal wird durch den letzten Aufruf der ProcessInput-Methode festgelegt. Für jede Komponente im Datenfluss, die eine Eingabe verarbeitet, wird ein Eintrag geschrieben. Der Eintrag schließt den Namen der Komponente ein.
OnPipelinePostPrimeOutput	Zeigt an, dass die Komponente ihren letzten Aufruf der PrimeOutput-Methode abgeschlossen hat. Je nach Datenfluss können mehrere Protokolleinträge geschrieben werden. Wenn es sich bei der Komponente um eine Quelle handelt, bedeutet das, dass die von der Komponente durchgeführte Zeilenverarbeitung fertig gestellt wurde.
OnPipelinePreEndOfRowset	Zeigt an, dass eine Komponente das Signal für das Ende des Rowsets, das beim letzten Aufruf der ProcessInput-Methode festgelegt wird, empfangen wird. Für jede Komponente im Datenfluss, die eine Eingabe verarbeitet, wird ein Eintrag geschrieben. Der Eintrag schließt den Namen der Komponente ein.
OnPipelinePrePrimeOutput	Zeigt an, dass die Komponente einen Aufruf aus der PrimeOutput-Methode erhalten soll. Je nach Datenfluss können mehrere Protokolleinträge geschrieben werden.
OnPipelineRowsSent	Berichtet die Anzahl von Zeilen, die einer Komponenteneingabe durch einen Aufruf der ProcessInput-Methode bereitgestellt wurden. Der Protokolleintrag enthält den Komponentennamen.
PipelineBufferLeak	Enthält Informationen zu einer beliebigen Komponente, in der Puffer beibehalten wurden, nachdem der Puffer-Manager ausgeblieben ist. Das bedeutet, dass Pufferressourcen nicht freigegeben wurden, was zu Speicherverlusten führen kann. Der Protokolleintrag stellt den Namen der Komponente und die ID des Puffers bereit.
PipelineExecutionPlan	Berichtet den Ausführungsplan des Datenflusses. Es werden Informationen darüber bereitgestellt, wie Puffer an Komponenten gesendet werden. Diese Informationen in Verbindung mit dem PipelineExecutionTrees-Eintrag beschreiben, was in dem Task geschieht.
PipelineExecutionTrees	Berichtet die Ausführungsstruktur des Layouts im Datenfluss. Der Planer des Datenflussmoduls verwendet die Strukturen zum Erstellen des Datenflussplans.
PipelineInitialization	Enthält Initialisierungsinformationen über den Task. Zu diesen Informationen gehören die Verzeichnisse für die temporäre Speicherung von BLOB-Daten, die Standardpuffergröße und die Zeilenanzahl in einem Puffer. Je nach Konfiguration des Datenflusstasks können mehrere Protokolleinträge geschrieben werden.

DTS 2000 ausführen (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task DTS 2000 ausführen aufgelistet.

Protokolleintrag	Beschreibung
ExecuteDTS80PackageTaskBegin	Zeigt an, dass die Ausführung eines DTS 2000-Pakets über den Task gestartet wurde.
ExecuteDTS80PackageTaskEnd	Zeigt an, dass die Ausführung über den Task beendet wurde. Hinweis Das DTS 2000-Paket kann nach Beendigung des Tasks mit der Ausführung fortfahren.
ExecuteDTS80PackageTaskTaskInfo	Enthält beschreibende Informationen zum Task.
ExecuteDTS80PackageTaskTaskResult	Berichtet das Ausführungsergebnis des durch den Task ausgeführten DTS 2000-Pakets.

Prozess ausführen (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task Prozess ausführen aufgelistet.

Protokolleintrag	Beschreibung
ExecuteProcessExecutingProcess	Enthält Informationen zum Ausführprozess der zur Ausführung konfigurierten ausführbaren Datei. Es werden zwei Protokolleinträge geschrieben. Der eine Protokolleintrag enthält Informationen über den Namen und Speicherort der vom Task ausgeführten ausführbaren Datei, im anderen Eintrag wird das Beenden der ausführbaren Datei erfasst.
ExecuteProcessVariableRouting	Enthält Informationen darüber, welche Variablen an die Eingabe und an die Ausgaben der ausführbaren Datei geleitet werden. Es werden Protokolleinträge für stdin (für die Eingabe), für stdout (für die Ausgabe) und für stderr (für die Fehlerausgabe) geschrieben.

SQL ausführen (Task)

In der folgenden Tabelle wird der benutzerdefinierte Protokolleintrag für den Task SQL ausführen beschrieben.

Protokolleintrag	Beschreibung
ExecuteSQLExecutingQuery	Enthält Informationen zu den Ausführungsphasen der SQL-Anweisung. Protokolleinträge werden geschrieben, wenn der Task eine Verbindung mit der Datenbank erhält, wenn der Task beginnt, die SQL-Anweisung vorzubereiten, und nachdem die Ausführung der SQL-Anweisung abgeschlossen wurde. Der Protokolleintrag für die Vorbereitungsphase schließt die vom Task verwendete SQL-Anweisung ein.

Dateisystem (Task)

In der folgenden Tabelle wird der benutzerdefinierte Protokolleintrag für den Task Dateisystem beschrieben.

Protokolleintrag	Beschreibung
FileSystemOperation	Berichtet den vom Task durchgeführten Vorgang. Der Protokolleintrag wird geschrieben, wenn der Dateisystemvorgang gestartet wird, und enthält Informationen zur Quelle und zum Ziel.

FTP (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den FTP-Task aufgelistet.

Protokolleintrag	Beschreibung
FTPConnectingToServer	Zeigt an, dass mit dem Task eine Verbindung zum FTP-Server initiiert wurde.
FTPOperation	Berichtet den Beginn und Typ des vom Task ausgeführten FTP-Vorgangs.

Nachrichtenwarteschlange (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task Nachrichtenwarteschlange aufgelistet.

Protokolleintrag	Beschreibung
MSMQAfterOpen	Zeigt an, dass das Öffnen der Warteschlange beendet wurde.
MSMQBeforeOpen	Zeigt an, dass das Öffnen der Warteschlange begonnen wurde.
MSMQBeginReceive	Zeigt an, dass das Empfangen einer Meldung begonnen wurde.
MSMQBeginSend	Zeigt an, dass das Senden einer Meldung begonnen wurde.
MSMQEndReceive	Zeigt an, dass das Empfangen einer Meldung beendet wurde.
MSMQEndSend	Zeigt an, dass das Senden einer Meldung beendet wurde.
MSMQTaskInfo	Enthält beschreibende Informationen zum Task.
MSMQTaskTimeOut	Zeigt an, dass beim Task ein Timeout eingetreten ist.

Skript (Task)

In der folgenden Tabelle wird der benutzerdefinierte Protokolleintrag für den Skripttask beschrieben.

Protokolleintrag	Beschreibung
ScriptTaskLogEntry	Berichtet die Ergebnisse der Implementierung der Protokollierung im Skript. Für jeden Aufruf der Log-Methode des Dts-Objekts wird jeweils ein Protokolleintrag geschrieben. Der Eintrag wird beim Ausführen des Codes geschrieben. Weitere Informationen finden Sie unter Protokollieren im Skripttask.

Mail senden (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task Mail senden aufgelistet.

Protokolleintrag	Beschreibung
SendMailTaskBegin	Zeigt an, dass das Senden einer E-Mail-Nachricht begonnen wurde.
SendMailTaskEnd	Zeigt an, dass das Senden einer E-Mail-Nachricht beendet wurde.
SendMailTaskInfo	Enthält beschreibende Informationen zum Task.

Datenbanken übertragen (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task Datenbanken übertragen aufgelistet.

Protokolleintrag	Beschreibung
SourceDB	Gibt die vom Task kopierte Datenbank an.
SourceSQLServer	Gibt den Computer an, von dem die Datenbank kopiert wurde.

Fehlermeldungen übertragen (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task Fehlermeldungen übertragen aufgelistet.

Protokolleintrag	Beschreibung
TransferErrorMessagesTaskFinishedTransferringObjects	Zeigt an, dass das Übertragen von Fehlermeldungen beendet wurde.
TransferErrorMessagesTaskStartTransferringObjects	Zeigt an, dass das Übertragen von Fehlermeldungen gestartet wurde.

Aufträge übertragen (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task Aufträge übertragen aufgelistet.

Protokolleintrag	Beschreibung
TransferJobsTaskFinishedTransferringObjects	Zeigt an, dass das Übertragen von SQL Server-Agent-Aufträgen beendet wurde.
TransferJobsTaskStartTransferringObjects	Zeigt an, dass das Übertragen von SQL Server-Agent-Aufträgen gestartet wurde.

Anmeldungen übertragen (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task Anmeldungen übertragen aufgelistet.

Protokolleintrag	Beschreibung
TransferLoginsTaskFinishedTransferringObjects	Zeigt an, dass das Übertragen von Anmeldungen beendet wurde.
TransferLoginsTaskStartTransferringObjects	Zeigt an, dass das Übertragen von Anmeldungen gestartet wurde.

In master gespeicherte Prozeduren übertragen (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task In master gespeicherte Prozeduren übertragen aufgelistet.

Protokolleintrag	Beschreibung
TransferStoredProceduresTaskFinishedTransferringObjects	Zeigt an, dass das Übertragen von benutzerdefinierten gespeicherten Prozeduren, die in der master-Datenbank gespeichert sind, beendet wurde.
TransferStoredProceduresTaskStartTransferringObjects	Zeigt an, dass das Übertragen von benutzerdefinierten gespeicherten Prozeduren, die in der master-Datenbank gespeichert sind, gestartet wurde.

SQL Server-Objekte kopieren (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task SQL Server-Objekte kopieren aufgelistet.

Protokolleintrag	Beschreibung
TransferSqlServerObjectsTaskFinishedTransferringObjects	Zeigt an, dass das Übertragen von SQL Server-Datenbankobjekten beendet wurde.
TransferSqlServerObjectsTaskStartTransferringObjects	Zeigt an, dass das Übertragen von SQL Server-Datenbankobjekten gestartet wurde.

Webdienste (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge aufgelistet, die für den Task Webdienste aktiviert werden können.

Protokolleintrag	Beschreibung
WSTaskBegin	Der Zugriff auf einen Webdienst wurde begonnen.
WSTaskEnd	Eine Webdienstmethode wurde beendet.
WSTaskInfo	Beschreibende Informationen zum Task.

WMI-Datenleser (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task WMI-Datenleser aufgelistet.

Protokolleintrag	Beschreibung
WMIDataReaderGettingWMIData	Zeigt an, dass das Lesen der WMI-Daten begonnen wurde.
WMIDataReaderOperation	Berichtet die vom Task ausgeführte WQL-Abfrage.

WMI-Ereignisüberwachung (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task WMI-Ereignisüberwachung aufgelistet.

Protokolleintrag	Beschreibung
WMIEventWatcherEventOccurred	Zeigt an, dass das vom Task überwachte Ereignis aufgetreten ist.
WMIEventWatcherTimedout	Zeigt an, dass beim Task ein Timeout eingetreten ist.
WMIEventWatcherWatchingForWMIEvents	Zeigt an, dass die Ausführung der WQL-Abfrage begonnen wurde. Der Eintrag schließt die Abfrage ein.

XML (Task)

In der folgenden Tabelle wird der benutzerdefinierte Protokolleintrag für den XML-Task beschrieben.

Protokolleintrag	Beschreibung
XMLOperation	Stellt Informationen über den vom Task durchgeführten Vorgang bereit.

Verwandte Inhalte

Blog-Artikel, Logging custom events for Integration Services tasks (Protokollieren von benutzerdefinierten Ereignissen für Integration Services-Tasks), auf dougbert.com

Bleiben Sie mit Integration Services auf dem neuesten Stand Die neuesten Downloads, Artikel, Beispiele und Videos von Microsoft sowie ausgewählte Lösungen aus der Community finden Sie auf MSDN auf der Integration Services-Seite: Besuchen Sie die Integration Services-Seite auf MSDN Abonnieren Sie die auf der Seite verfügbaren RSS-Feeds, um automatische Benachrichtigungen zu diesen Updates zu erhalten.

Siehe auch

Konzepte

Integration Services-Protokollierung (SSIS)