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 Paketausführung (Problembehandlung). |
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. |
|
Siehe auch