Messages personnalisés pour la journalisation

  • Article

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.

[!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 Outils de dépannage de la connectivité 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.

Contenu connexe

Entrée de blog, Logging custom events for Integration Services tasks (en anglais), sur dougbert.com.

Icône Integration Services (petite) Rester à jour avec Integration Services

Pour obtenir les derniers téléchargements, articles, exemples et vidéos de Microsoft, ainsi que des solutions sélectionnées par la communauté, visitez la page Integration Services sur MSDN :


Pour recevoir une notification automatique de ces mises à jour, abonnez-vous aux flux RSS disponibles sur la page.

Voir aussi

Concepts

Journalisation d'Integration Services (SSIS)