Durch ein Integration Services-Paket protokollierte Ereignisse
Gilt für:
SQL ServerSSIS Integration Runtime in Azure Data Factory
Ein Integration Services -Paket protokolliert verschiedene Ereignismeldungen in das Windows-Anwendungsereignisprotokoll. Ein Paket protokolliert diese Meldungen, wenn das Paket startet, wenn das Paket anhält und wenn bestimmte Probleme auftreten.
Dieses Thema enthält Informationen über die allgemeinen Ereignismeldungen, die von einem Paket im Anwendungsereignisprotokoll protokolliert werden. Standardmäßig protokolliert ein Paket einige dieser Meldungen, auch wenn Sie die Protokollfunktion für das Paket nicht aktiviert haben. Andere Meldungen werden hingegen vom Paket nur protokolliert, wenn Sie die Protokollfunktion für das Paket aktiviert haben. Unabhängig davon, ob das Paket diese Meldungen standardmäßig oder aufgrund der aktivierten Protokollfunktion protokolliert, ist die Ereignisquelle für die Meldungen SQLISPackage.
Allgemeine Informationen zum Ausführen von SSIS-Paketen finden Sie unter Ausführung von Projekten und Paketen.
Informationen zur Behandlung von Problemen bei der Ausführung von Paketen finden Sie unter Behandlung von Problemen mit Paketausführungstools.
Meldungen zum Paketstatus
Wenn Sie ein Integration Services -Paket ausführen, protokolliert das Paket normalerweise verschiedene Meldungen über den Fortschritt und den Status des Pakets. Die entsprechenden Meldungen sind in der folgenden Tabelle aufgeführt.
Hinweis
Das Paket protokolliert die Meldungen in der folgenden Tabelle, auch wenn Sie die Protokollfunktion für das Paket nicht aktiviert haben.
| Ereignis-ID | Symbolischer Name | Text | Notizen |
|---|---|---|---|
| 12288 | DTS_MSG_PACKAGESTART | Das Paket "" wurde gestartet. | Die Ausführung des Pakets wurde begonnen. |
| 12289 | DTS_MSG_PACKAGESUCCESS | Das Paket "" wurde erfolgreich beendet. | Das Paket wurde erfolgreich ausgeführt und wird zurzeit nicht mehr ausgeführt. |
| 12290 | DTS_MSG_PACKAGECANCEL | Paket "%1!s!" wurde abgebrochen. | Das Paket wird nicht mehr ausgeführt, da es abgebrochen wurde. |
| 12291 | DTS_MSG_PACKAGEFAILURE | Fehler beim Paket "". | Das Paket konnte nicht erfolgreich ausgeführt werden und wurde angehalten. |
Bei einer Neuinstallation wird Integration Services standardmäßig so konfiguriert, dass bestimmte Ereignisse im Zusammenhang mit der Ausführung von Paketen im Anwendungsereignisprotokoll nicht protokolliert werden. Mit dieser Einstellung wird verhindert, dass zu viele Ereignisprotokolleinträge erstellt werden, wenn Sie das Datensammler-Feature im aktuellen Release von SQL Server Integration Services verwenden. Zu den nicht protokollierten Ereignissen gehören EventID 12288 "Paket wurde gestartet" und EventID 12289 "Paket wurde erfolgreich beendet". Wenn Sie diese Ereignisse im Anwendungsereignisprotokoll protokollieren möchten, öffnen Sie die Registrierung zum Bearbeiten. Suchen Sie anschließend in der Registrierung den Knoten „HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS“, und ändern Sie den DWORD-Wert der Einstellung LogPackageExecutionToEventLog von 0 auf 1. In einer Upgradeinstallation ist Integration Services jedoch so konfiguriert, dass diese beiden Ereignisse protokolliert werden. Wenn Sie die Protokollierung deaktivieren möchten, ändern Sie den Wert der LogPackageExecutionToEventLog-Einstellung von 1 in 0.
Mit der Paketprotokollierung verknüpfte Meldungen
Wenn Sie die Protokollfunktion für das Paket aktiviert haben, ist das Anwendungsereignisprotokoll eines der Ziele, die von den optionalen Protokollierungsfunktionen in Integration Services -Paketen unterstützt werden. Weitere Informationen finden Sie unter Integration Services-Protokollierung (SSIS).
Wenn Sie die Protokollfunktion für das Paket aktiviert haben und der Protokollspeicherort das Anwendungsereignisprotokoll ist, protokolliert das Paket Einträge, für die folgende Informationen gelten:
Meldungen über die Phase, in der sich das Paket bei seiner Ausführung befindet.
Meldungen über besondere Ereignisse, die auftreten, während das Paket ausgeführt wird.
Meldungen zu den Phasen der Paketausführung
| Ereignis-ID | Symbolischer Name | Text | Notizen |
|---|---|---|---|
| 12544 | DTS_MSG_EVENTLOGENTRY | Ereignisname: %1%r Meldung: %9%r Operator: %2%r Quellenname: %3%r Quellen-ID: %4%r Ausführungs-ID: %5%r Startzeit: %6%r Beendigungszeit: %7%r Datencode: %8 | Dieses generische Format wird von verschiedenen Meldungen verwendet, wenn Sie die Paketprotokollierung für das Anwendungsereignisprotokoll konfigurieren. |
| 12556 | DTS_MSG_EVENTLOGENTRY_PACKAGESTART | Ereignisname: %1%r Meldung: %9%r Operator: %2%r Quellenname: %3%r Quellen-ID: %4%r Ausführungs-ID: %5%r Startzeit: %6%r Beendigungszeit: %7%r Datencode: %8 | Das Paket wurde gestartet. |
| 12547 | DTS_MSG_EVENTLOGENTRY_PREVALIDATE | Ereignisname: %1%r Meldung: %9%r Operator: %2%r Quellenname: %3%r Quellen-ID: %4%r Ausführungs-ID: %5%r Startzeit: %6%r Beendigungszeit: %7%r Datencode: %8 | Die Überprüfung des Objekts beginnt in Kürze. |
| 12548 | DTS_MSG_EVENTLOGENTRY_POSTVALIDATE | Ereignisname: %1%r Meldung: %9%r Operator: %2%r Quellenname: %3%r Quellen-ID: %4%r Ausführungs-ID: %5%r Startzeit: %6%r Beendigungszeit: %7%r Datencode: %8 | Die Überprüfung des Objekts wurde beendet. |
| 12552 | DTS_MSG_EVENTLOGENTRY_PROGRESS | Ereignisname: %1%r Meldung: %9%r Operator: %2%r Quellenname: %3%r Quellen-ID: %4%r Ausführungs-ID: %5%r Startzeit: %6%r Beendigungszeit: %7%r Datencode: %8 | Diese generische Meldung gibt Aufschluss über den Paketfortschritt. |
| 12546 | DTS_MSG_EVENTLOGENTRY_POSTEXECUTE | Ereignisname: %1%r Meldung: %9%r Operator: %2%r Quellenname: %3%r Quellen-ID: %4%r Ausführungs-ID: %5%r Startzeit: %6%r Beendigungszeit: %7%r Datencode: %8 | Das Objekt hat seine Arbeit beendet. |
| 12557 | DTS_MSG_EVENTLOGENTRY_PACKAGEEND | Ereignisname: %1%r Meldung: %9%r Operator: %2%r Quellenname: %3%r Quellen-ID: %4%r Ausführungs-ID: %5%r Startzeit: %6%r Beendigungszeit: %7%r Datencode: %8 | Die Ausführung des Pakets ist abgeschlossen. |
Meldungen über Ereignisse, die auftreten
In der folgenden Tabelle werden nur einige der Meldungen aufgeführt, die aus Ereignissen resultieren. Eine umfangreichere Liste von Fehler-, Warnungs- und Informationsmeldungen, die von Integration Services verwendet werden, finden Sie unter Fehler- und Meldungsreferenz von Integration Services.
| Ereignis-ID | Symbolischer Name | Text | Notizen |
|---|---|---|---|
| 12251 | DTS_MSG_EVENTLOGENTRY_TASKFAILED | Ereignisname: %1%r Meldung: %9%r Operator: %2%r Quellenname: %3%r Quellen-ID: %4%r Ausführungs-ID: %5%r Startzeit: %6%r Beendigungszeit: %7%r Datencode: %8 | Der Task ist fehlgeschlagen. |
| 12250 | DTS_MSG_EVENTLOGENTRY_ERROR | Ereignisname: %1%r Meldung: %9%r Operator: %2%r Quellenname: %3%r Quellen-ID: %4%r Ausführungs-ID: %5%r Startzeit: %6%r Beendigungszeit: %7%r Datencode: %8 | Diese Meldung meldet einen Fehler, der aufgetreten ist. |
| 12249 | DTS_MSG_EVENTLOGENTRY_WARNING | Ereignisname: %1%r Meldung: %9%r Operator: %2%r Quellenname: %3%r Quellen-ID: %4%r Ausführungs-ID: %5%r Startzeit: %6%r Beendigungszeit: %7%r Datencode: %8 | Diese Meldung meldet eine Warnung, die aufgetreten ist. |
| 12258 | DTS_MSG_EVENTLOGENTRY_INFORMATION | Ereignisname: %1%r Meldung: %9%r Operator: %2%r Quellenname: %3%r Quellen-ID: %4%r Ausführungs-ID: %5%r Startzeit: %6%r Beendigungszeit: %7%r Datencode: %8 | Diese Meldung enthält Informationen, die nicht mit einem Fehler oder einer Warnung verbunden sind. |
Anzeigen der Protokolleinträge im Fenster „Protokollereignisse“
In diesem Verfahren wird das Ausführen eines Pakets und das Anzeigen der geschriebenen Protokolleinträge beschrieben. Sie können die Protokolleinträge in Echtzeit anzeigen. Die im Fenster Protokollereignisse geschriebenen Protokolleinträge können auch kopiert und für die spätere Analyse gespeichert werden.
Dabei müssen die Protokolleinträge nicht in ein Protokoll geschrieben werden, um die Einträge in das Fenster Protokollereignisse zu schreiben.
So zeigen Sie Protokolleinträge an
Öffnen Sie in SQL Server Data Tools das Integration Services-Projekt mit dem gewünschten Paket.
Klicken Sie im Menü SSIS auf Protokollereignisse. Sie können das Fenster Protokollereignisse auch anzeigen, indem Sie im Dialogfeld Optionen auf der Seite Tastatur den Befehl View.LogEvents einer beliebigen Tastenkombination zuordnen.
Klicken Sie im Menü Debuggen auf Debuggen starten.
Sobald die Laufzeit feststellt, dass das Protokoll für Ereignisse und benutzerdefinierte Meldungen aktiviert wurde, werden die Protokolleinträge für die Ereignisse und Meldungen in das Fenster Protokollereignisse geschrieben.
Klicken Sie im Menü Debuggen auf Debuggen beenden.
Die Protokolleinträge sind so lange im Fenster Protokollereignisse verfügbar, bis Sie das Paket erneut ausführen, ein anderes Paket ausführen oder SQL Server Data Toolsschließen.
Zeigen Sie die Protokolleinträge im Fenster Protokollereignisse an.
Klicken Sie optional auf die zu kopierenden Protokolleinträge, klicken Sie auf die rechte Maustaste, und klicken dann Sie auf Kopieren.
Doppelklicken Sie optional auf einen Protokolleintrag, und zeigen Sie die Details eines einzelnen Protokolleintrags im Dialogfeld Protokolleintrag an.
Klicken Sie im Dialogfeld Protokolleintrag auf die Nach-Oben- oder Nach-Unten-Taste, um den vorigen oder nächsten Protokolleintrag anzuzeigen, und klicken Sie zum Kopieren des Protokolleintrags auf das Kopiersymbol.
Öffnen Sie einen Texteditor, um den Protokolleintrag in eine Textdatei einzufügen und zu speichern.