Freigeben über

  • Artikel

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.

HinweisHinweis
Dieser Protokolleintrag wird automatisch in das Protokoll geschrieben. Dieser Eintrag kann nicht ausgeschlossen werden.

PackageEnd

Zeigt den Abschluss der Paketausführung an.

HinweisHinweis
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.

HinweisHinweis
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 mit dem 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 zum vom Task durchgeführten Vorgang bereit.

Externe Ressourcen

Integration Services (kleines Symbol) 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 der Integration Services-Seite von MSDN oder TechNet:

Abonnieren Sie die auf der Seite verfügbaren RSS-Newsfeeds, um automatische Benachrichtigungen zu diesen Aktualisierungen zu erhalten.