Messages personnalisés pour la journalisation
Integration Services fournit un ensemble complet d'événements personnalisés permettant d'écrire des entrées de journal pour des packages et bon nombre de tâches. Vous pouvez utiliser ces entrées pour enregistrer des informations détaillées sur l'avancement, les résultats et les problèmes d'exécution en enregistrant des événements prédéfinis ou des messages définis par l'utilisateur en vue d'une analyse ultérieure. Vous pouvez ainsi enregistrer l'heure de début et de fin d'une insertion en bloc pour identifier des problèmes de performances lors de l'exécution du package.
Les entrées de journal personnalisées constituent un ensemble qui se distingue de l'ensemble des événements de journalisation standard, disponibles pour les packages et tous les conteneurs et tâches. Ces entrées sont conçues pour capturer des informations utiles sur une tâche spécifique d'un package. Par exemple, l'une des entrées de journal personnalisées pour la tâche d'exécution de requêtes SQL consigne l'instruction SQL que la tâche exécute dans le journal.
Toutes les entrées de journal contiennent des informations de date et d'heure, y compris les entrées qui sont écrites automatiquement au début et à la fin d'un package. La plupart des événements de journal écrivent plusieurs entrées dans le journal. C'est généralement le cas lorsque l'événement comprend plusieurs phases. Par exemple, l'événement du journal ExecuteSQLExecutingQuery consigne trois entrées : la première après que la tâche acquiert une connexion à la base de données, la seconde après que la tâche commence à préparer l'instruction SQL et la troisième à la fin de l'exécution de l'instruction SQL.
Les objets Integration Services suivants possèdent des entrées de journal personnalisées :
Package
Tâche d'insertion en bloc
Tâche de flux de données
Tâche d'exécution DTS 2000
Tâche d'exécution de processus
Tâche d'exécution de requêtes SQL
Tâche de système de fichiers
Tâche FTP
Tâche MSMQ
Tâche de script
Tache Envoyer un message
Tâche de transfert de bases de données
Tâche de transfert de messages d'erreur
Tâche de transfert de travaux
Tâche de transfert de connexions
Tâche de transfert de procédures stockées de master
Tâche de transfert d'objets SQL Server
Tâche de services Web
Tâche Lecteur de données WMI
Tâche Observateur d'événement WMI
Tâche XML
Entrées du journal
Package
Le tableau suivant répertorie les entrées de journal personnalisées pour les packages.
Entrée du journal |
Description |
|---|---|
PackageStart |
Indique que le package a commencé à s'exécuter. .gif "Remarque") Remarque
Cette entrée de journal est automatiquement écrite au journal. Vous ne pouvez pas l'exclure.
|
PackageEnd |
Indique que le package est terminé. Remarque
Cette entrée de journal est automatiquement écrite au journal. Vous ne pouvez pas l'exclure.
|
Diagnostic |
Fournit des informations sur la configuration système qui affecte l'exécution du package, notamment le nombre d'exécutables pouvant s'exécuter simultanément. L'entrée de journal Diagnostic inclut également des entrées avant et après les appels effectués auprès des fournisseurs de données externes. Pour plus d'informations, consultez Dépannage de l'exécution des packages. |
Tâche d'insertion en bloc
Le tableau suivant répertorie les entrées de journal personnalisées pour la tâche d'insertion en bloc.
Entrée du journal |
Description |
|---|---|
DTSBulkInsertTaskBegin |
Indique que l'insertion en bloc a commencé. |
DTSBulkInsertTaskEnd |
Indique que l'insertion en bloc est terminée. |
DTSBulkInsertTaskInfos |
Donne des informations détaillées relatives à la tâche. |
Tâche de flux de données
Le tableau suivant répertorie les entrées de journal personnalisées pour la tâche de flux de données.
Entrée du journal |
Description |
|---|---|
BufferSizeTuning |
Indique que la tâche de flux de données a modifié la taille du tampon. L'entrée de journal décrit les raisons de cette modification de taille et indique la nouvelle taille temporaire du tampon. |
OnPipelinePostEndOfRowset |
Indique qu'un composant a reçu son signal de fin d'ensemble de lignes, défini par le dernier appel de la méthode ProcessInput. Une entrée est écrite pour chaque composant du flux de données qui traite l'entrée. L'entrée inclut le nom du composant. |
OnPipelinePostPrimeOutput |
Indique que le composant a terminé son dernier appel de la méthode PrimeOutput. Selon le flux de données, plusieurs entrées de journal peuvent être écrites. Si le composant est une source, cela signifie que le composant a terminé le traitement des lignes. |
OnPipelinePreEndOfRowset |
Indique qu'un composant est sur le point de recevoir son signal de fin d'ensemble de lignes, défini par le dernier appel de la méthode ProcessInput. Une entrée est écrite pour chaque composant du flux de données qui traite l'entrée. L'entrée inclut le nom du composant. |
OnPipelinePrePrimeOutput |
Indique que le composant est sur le point de recevoir son appel de la méthode PrimeOutput. Selon le flux de données, plusieurs entrées de journal peuvent être écrites. |
OnPipelineRowsSent |
Indique le nombre de lignes fournies à une entrée de composant par un appel de la méthode ProcessInput. L'entrée du journal inclut le nom du composant. |
PipelineBufferLeak |
Donne des informations sur tout composant qui maintient l'activité des tampons après la fermeture du gestionnaire de tampons. Cela signifie que des ressources des tampons n'ont pas été libérées et qu'elles peuvent provoquer des fuites de mémoire. L'entrée du journal fournit le nom du composant et l'ID du tampon. |
PipelineExecutionPlan |
Indique le plan d'exécution du flux de données. L'entrée du journal donne des informations sur la façon dont les tampons sont envoyés aux composants. Ces informations, conjuguées à l'entrée PipelineExecutionTrees, décrivent ce qui se passe dans la tâche. |
PipelineExecutionTrees |
Indique les arborescences d'exécution de la disposition du flux de données. Le planificateur du moteur du flux de données utilise les arborescences pour construire le plan d'exécution du flux de données. |
PipelineInitialization |
Donne des informations d'initialisation relatives à la tâche. Ces informations incluent les répertoires à utiliser pour le stockage temporaire des données BLOB, la taille du tampon par défaut ainsi que le nombre de lignes contenues dans un tampon. Selon la configuration de la tâche de flux de données, plusieurs entrées de journal peuvent être écrites. |
Tâche d'exécution DTS 2000
Le tableau suivant répertorie les entrées de journal personnalisées pour la tâche d'exécution DTS 2000.
Entrée du journal |
Description |
|---|---|
ExecuteDTS80PackageTaskBegin |
Indique que la tâche a commencé l'exécution d'un package DTS 2000. |
ExecuteDTS80PackageTaskEnd |
Indique que la tâche est terminée. Remarque
Il est possible que le package DTS 2000 continue à s'exécuter à la fin de la tâche.
|
ExecuteDTS80PackageTaskTaskInfo |
Fournit des informations détaillées concernant la tâche. |
ExecuteDTS80PackageTaskTaskResult |
Indique le résultat d'exécution du package DTS 2000 que la tâche a exécuté. |
Tâche d'exécution de processus
Le tableau suivant répertorie les entrées de journal personnalisées pour la tâche d'exécution de processus.
Entrée du journal |
Description |
|---|---|
ExecuteProcessExecutingProcess |
Donne des informations sur le processus d'exécution de l'exécutable dont est chargé la tâche. Deux entrées de journal sont écrites. La première contient des informations sur le nom et l'emplacement de l'exécutable que la tâche exécute, tandis que la seconde enregistre la sortie de l'exécutable. |
ExecuteProcessVariableRouting |
Donne des informations sur les variables qui doivent être routées vers l'entrée et les sorties de l'exécutable. Les entrées du journal sont écrites pour stdin (l'entrée), stdout (la sortie) et stderr (la sortie des erreurs). |
Tâche d'exécution de requêtes SQL
Le tableau suivant décrit les entrées de journal personnalisées pour la tâche d'exécution de requêtes SQL.
Entrée du journal |
Description |
|---|---|
ExecuteSQLExecutingQuery |
Donne des informations sur les phases d'exécution de l'instruction SQL. Des entrées de journal sont écrites lorsque la tâche acquiert la connexion à la base de données, lorsqu'elle commence à préparer l'instruction SQL et à la fin de l'exécution de l'instruction SQL. L'entrée de journal concernant la phase de préparation inclut l'instruction SQL que la tâche utilise. |
Tâche de système de fichiers
Le tableau suivant décrit l'entrée de journal personnalisée pour la tâche de système de fichiers.
Entrée du journal |
Description |
|---|---|
FileSystemOperation |
Indique l'opération que la tâche effectue. L'entrée de journal est écrite au démarrage de l'opération du système de fichiers et elle inclut des informations sur la source et la destination. |
Tâche FTP
Le tableau suivant répertorie les entrées de journal personnalisées pour la tâche FTP.
Entrée du journal |
Description |
|---|---|
FTPConnectingToServer |
Indique que la tâche a initié une connexion au serveur FTP. |
FTPOperation |
Indique le démarrage et le type d'une opération FTP effectuée par la tâche. |
Tâche MSMQ
Le tableau suivant répertorie les entrées de journal personnalisées pour la tâche MSMQ.
Entrée du journal |
Description |
|---|---|
MSMQAfterOpen |
Indique que la tâche a terminé l'ouverture de la file d'attente des messages. |
MSMQBeforeOpen |
Indique que la tâche a commencé l'ouverture de la file d'attente des messages. |
MSMQBeginReceive |
Indique que la tâche a commencé la réception d'un message. |
MSMQBeginSend |
Indique que la tâche a commencé l'envoi d'un message. |
MSMQEndReceive |
Indique que la tâche a terminé la réception d'un message. |
MSMQEndSend |
Indique que la tâche a terminé l'envoi d'un message. |
MSMQTaskInfo |
Fournit des informations détaillées concernant la tâche. |
MSMQTaskTimeOut |
Indique que le délai de la tâche a expiré. |
Tâche de script
Le tableau suivant décrit l'entrée de journal personnalisée pour la tâche de script.
Entrée du journal |
Description |
|---|---|
ScriptTaskLogEntry |
Indique les résultats de l'implémentation de la journalisation dans le script. Une entrée de journal est écrite pour chaque appel de la méthode Log de l'objet Dts. L'entrée est écrite à l'exécution du code. Pour plus d'informations, consultez Journalisation dans la tâche de script. |
Tâche Envoyer un message
Le tableau suivant répertorie les entrées de journal personnalisées pour la tâche Envoyer un message.
Entrée du journal |
Description |
|---|---|
SendMailTaskBegin |
Indique que la tâche a commencé l'envoi d'un message électronique. |
SendMailTaskEnd |
Indique que la tâche a terminé l'envoi d'un message électronique. |
SendMailTaskInfo |
Donne des informations détaillées relatives à la tâche. |
Tâche de transfert de bases de données
Le tableau suivant répertorie les entrées de journal personnalisées pour la tâche de transfert de bases de données.
Entrée du journal |
Description |
|---|---|
SourceDB |
Spécifie la base de données que la tâche a copiée. |
SourceSQLServer |
Spécifie l'ordinateur à partir duquel la base de données a été copiée. |
Tâche de transfert de messages d'erreur
Le tableau suivant répertorie les entrées de journal personnalisées pour la tâche de transfert de messages d'erreur.
Entrée du journal |
Description |
|---|---|
TransferErrorMessagesTaskFinishedTransferringObjects |
Indique que la tâche a terminé le transfert des messages d'erreur. |
TransferErrorMessagesTaskStartTransferringObjects |
Indique que la tâche a commencé le transfert des messages d'erreur. |
Tâche de transfert de travaux
Le tableau suivant répertorie les entrées de journal personnalisées pour la tâche de transfert de travaux.
Entrée du journal |
Description |
|---|---|
TransferJobsTaskFinishedTransferringObjects |
Indique que la tâche a terminé le transfert des travaux de l'Agent SQL Server. |
TransferJobsTaskStartTransferringObjects |
Indique que la tâche a commencé le transfert des travaux de l'Agent SQL Server. |
Tâche de transfert de connexions
Le tableau suivant répertorie les entrées de journal personnalisées pour la tâche de transfert de connexions.
Entrée du journal |
Description |
|---|---|
TransferLoginsTaskFinishedTransferringObjects |
Indique que la tâche a terminé le transfert des connexions. |
TransferLoginsTaskStartTransferringObjects |
Indique que la tâche a commencé le transfert des connexions. |
Tâche de transfert de procédures stockées de master
Le tableau suivant répertorie les entrées de journal personnalisées pour la tâche de transfert de procédures stockées de master.
Entrée du journal |
Description |
|---|---|
TransferStoredProceduresTaskFinishedTransferringObjects |
Indique que la tâche a terminé le transfert des procédures stockées définies par l'utilisateur qui existent dans la base de données master. |
TransferStoredProceduresTaskStartTransferringObjects |
Indique que la tâche a commencé le transfert des procédures stockées définies par l'utilisateur qui existent dans la base de données master. |
Tâche de transfert d'objets SQL Server
Le tableau suivant répertorie les entrées de journal personnalisées pour la tâche de transfert d'objets SQL Server.
Entrée du journal |
Description |
|---|---|
TransferSqlServerObjectsTaskFinishedTransferringObjects |
Indique que la tâche a terminé le transfert des objets de base de données SQL Server. |
TransferSqlServerObjectsTaskStartTransferringObjects |
Indique que la tâche a commencé le transfert des objets de base de données SQL Server. |
Tâche de services Web
Le tableau suivant répertorie les entrées de journal personnalisées pour la tâche de services Web.
Entrée du journal |
Description |
|---|---|
WSTaskBegin |
La tâche a commencé à accéder à un service Web. |
WSTaskEnd |
La tâche a terminé une méthode de service Web. |
WSTaskInfo |
Donne des informations détaillées relatives à la tâche. |
Tâche Lecteur de données WMI
Le tableau suivant répertorie les entrées de journal personnalisées pour la tâche Lecteur de données WMI.
Entrée du journal |
Description |
|---|---|
WMIDataReaderGettingWMIData |
Indique que la tâche a commencé la lecture des données WMI. |
WMIDataReaderOperation |
Indique la requête WQL que la tâche a exécutée. |
Tâche Observateur d'événement WMI
Le tableau suivant répertorie les entrées de journal personnalisées pour la tâche Observateur d'événement WMI.
Entrée du journal |
Description |
|---|---|
WMIEventWatcherEventOccurred |
Indique que l'événement surveillé par la tâche s'est produit. |
WMIEventWatcherTimedout |
Indique que le délai de la tâche a expiré. |
WMIEventWatcherWatchingForWMIEvents |
Indique que la tâche a commencé l'exécution de la requête WQL. L'entrée inclut la requête. |
Tâche XML
Le tableau suivant décrit l'entrée de journal personnalisée pour la tâche XML.
Entrée du journal |
Description |
|---|---|
XMLOperation |
Fournit des informations sur l'opération que la tâche effectue. |
Ressources externes
- Entrée de blog, Logging custom events for Integration Services tasks (en anglais), sur dougbert.com
|
.gif "Icône Integration Services (petite)")
Rester à jour avec Integration ServicesVoir aussi