Mensagens personalizadas para log
O Integration Services fornece um rico conjunto de eventos personalizados para gravação de entradas de log para pacotes e diversas tarefas. Você pode usar essas entradas para salvar informações detalhadas sobre progresso de execução, resultados e problemas registrando eventos predefinidos ou mensagens definidas pelo usuário para análise posterior. Por exemplo, você pode registrar quando uma inserção em massa é iniciada ou finalizada para identificar problemas de desempenho na execução do pacote.
As entradas de log personalizadas são um conjunto de entradas diferente do conjunto de eventos de log padrão, disponível para pacotes e todos os contêineres e tarefas. As entradas de log personalizadas são elaboradas para capturar informações úteis sobre uma tarefa específica em um pacote. Por exemplo, uma das entradas de log personalizadas da tarefa Executar SQL registra a instrução SQL executada pela tarefa no log.
Todas as entradas de log incluem informações de data e hora, inclusive as entradas de log que são gravadas automaticamente quando um pacote é iniciado ou finalizado. Diversos tipos de eventos de log gravam várias entradas no log. Isso acontece normalmente quando o evento tem fases diferentes. Por exemplo, o evento de log ExecuteSQLExecutingQuery grava três entradas: uma entrada depois que a tarefa adquire uma conexão com o banco de dados, outra depois que a tarefa começa a preparar a instrução SQL e uma depois que a execução da instrução SQL foi concluída.
Os objetos Integration Services a seguir têm entradas de log personalizadas:
Pacote
Tarefa Inserção em Massa
Tarefa Fluxo de Dados
Tarefa Executar DTS 2000
Tarefa Executar Processo
Tarefa Executar SQL
Tarefa Sistema de Arquivos
Tarefa FTP
Tarefa Fila de Mensagens
Tarefa Script
Tarefa Enviar Email
Tarefa Transferir Banco de Dados
Tarefa Transferir Mensagens de Erro
Tarefa Transferir Trabalhos
Tarefa Transferir Logons
Tarefa Transferir Procedimentos Armazenados Mestres
Tarefa Transferir Objetos do SQL Server
Tarefa Serviços Web
Tarefa Leitor de Dados do WMI
Tarefa Detector de Eventos do WMI
Tarefa XML
Entradas de log
Pacote
A tabela a seguir relaciona as entradas de log personalizadas para pacotes.
Entrada no log |
Descrição |
||
|---|---|---|---|
PackageStart |
Indica que o pacote começou a ser executado.
|
||
PackageEnd |
Indica que o pacote foi concluído.
|
||
Diagnostic |
Fornece informações sobre a configuração de sistema que afeta a execução de pacotes como os executáveis de número que podem ser executados simultaneamente. A entrada de log Diagnostic também inclui entradas anteriores e posteriores a chamadas para provedores de dados externos. Para obter mais informações, consulte Solucionando problemas de conectividade de pacotes de ferramentas. |
.gif "Observação")
ObservaçãoTarefa Inserção em Massa
A tabela a seguir relaciona as entradas de log personalizadas para a tarefa Inserção em Massa.
Entrada no log |
Descrição |
|---|---|
DTSBulkInsertTaskBegin |
Indica que a inserção em massa foi iniciada. |
DTSBulkInsertTaskEnd |
Indica que a inserção em massa foi concluída. |
DTSBulkInsertTaskInfos |
Fornece informações descritivas sobre a tarefa. |
Tarefa Fluxo de Dados
A tabela a seguir relaciona as entradas de log personalizadas para a tarefa de Fluxo de Dados.
Entrada no log |
Descrição |
|---|---|
BufferSizeTuning |
Indica que a tarefa de Fluxo de Dados alterou o tamanho do buffer. A entrada de log descreve os motivos da mudança de tamanho e relaciona o novo tamanho do buffer temporário. |
OnPipelinePostEndOfRowset |
Indica que um componente recebeu o sinal de final do conjunto de linhas, definido pela última chamada do método ProcessInput. Uma entrada é gravada para cada componente no fluxo de dados que processa a entrada. A entrada contém o nome do componente. |
OnPipelinePostPrimeOutput |
Indica que o componente completou sua última chamada para o método PrimeOutput. Dependendo do fluxo de dados, várias entradas de log podem ser gravadas. Se o componente for uma fonte, isto significará que o componente tem linhas de processamento concluídas. |
OnPipelinePreEndOfRowset |
Indica que um componente vai receber seu sinal de final do conjunto de linhas, definido pela última chamada do método ProcessInput. Uma entrada é gravada para cada componente no fluxo de dados que processa a entrada. A entrada contém o nome do componente. |
OnPipelinePrePrimeOutput |
Indica que o componente está prestes a receber sua chamada a partir do método PrimeOutput. Dependendo do fluxo de dados, várias entradas de log podem ser gravadas. |
OnPipelineRowsSent |
Informa o número de linhas fornecido a uma entrada de componente por uma chamada para o método ProcessInput. A entrada de log inclui o nome do componente. |
PipelineBufferLeak |
Fornece informações sobre qualquer componente que manteve buffers ativos depois que o gerenciador de buffers saiu de cena. Isso significa que os recursos de buffers não foram liberados e pode haver vazamentos de memória. A entrada de log fornece o nome do componente e a ID do buffer. |
PipelineExecutionPlan |
Informa o plano de execução do fluxo de dados. Fornece informações sobre como os buffers serão enviados a componentes. Essas informações, em combinação com a entrada de PipelineExecutionTrees, descrevem o que está acontecendo na tarefa. |
PipelineExecutionTrees |
Informa as árvores de execução do layout do fluxo de dados. O agendador do mecanismo de fluxo de dados usa as árvores para criar o plano de execução do fluxo de dados. |
PipelineInitialization |
Fornece informações de inicialização sobre a tarefa. Essas informações incluem os diretórios para armazenamento temporário de dados de BLOB, o tamanho do buffer padrão e o número de linhas em um buffer. Dependendo da configuração da tarefa de Fluxo de Dados, várias entradas de log podem ser gravadas. |
Tarefa Executar DTS 2000
A tabela a seguir relaciona as entradas de log personalizadas para a tarefa Executar DTS 2000.
Entrada no log |
Descrição |
||
|---|---|---|---|
ExecuteDTS80PackageTaskBegin |
Indica que a tarefa começou a ser executada em um pacote DTS 2000. |
||
ExecuteDTS80PackageTaskEnd |
Indica que a tarefa foi concluída.
|
||
ExecuteDTS80PackageTaskTaskInfo |
Fornece informações descritivas sobre a tarefa. |
||
ExecuteDTS80PackageTaskTaskResult |
Informa o resultado de execução do pacote DTS 2000 executado pela tarefa. |
Tarefa Executar Processo
A tabela a seguir relaciona as entradas de log personalizadas para a tarefa Executar Processo.
Entrada no log |
Descrição |
|---|---|
ExecuteProcessExecutingProcess |
Fornece informações sobre o processo do executável que a tarefa está configurada para executar. São gravadas duas entradas de log. Uma contém informações sobre o nome e o local do executável que a tarefa executa e o outro registra a saída do executável. |
ExecuteProcessVariableRouting |
Fornece informações sobre quais variáveis são encaminhadas para a entrada e as saídas do executável. As entradas de log são gravadas em stdin (a entrada), stdout (a saída) e stderr (a saída do erro). |
Tarefa Executar SQL
A tabela a seguir descreve a entrada de log personalizada da tarefa Executar SQL.
Entrada no log |
Descrição |
|---|---|
ExecuteSQLExecutingQuery |
Fornece informações sobre as etapas de execução da instrução SQL. As entradas de log são gravadas quando a tarefa adquire conexão com o banco de dados, quando a tarefa começa a preparar a instrução SQL e depois que a execução da instrução SQL é concluída. A entrada de log da fase de preparação inclui a instrução SQL usada pela tarefa. |
Tarefa Sistema de Arquivos
A tabela a seguir descreve a entrada de log personalizada da tarefa Sistema de Arquivos.
Entrada no log |
Descrição |
|---|---|
FileSystemOperation |
Informa a operação executada pela tarefa. A entrada de log é gravada quando a operação de sistema de arquivos é iniciada e inclui informações sobre a origem e o destino. |
Tarefa FTP
A tabela a seguir relaciona as entradas de log personalizadas da tarefa FTP.
Entrada no log |
Descrição |
|---|---|
FTPConnectingToServer |
Indica que a tarefa iniciou uma conexão com o servidor de FTP. |
FTPOperation |
Informa o início e o tipo de operação de FTP que a tarefa executa. |
Tarefa Fila de Mensagens
A tabela a seguir relaciona as entradas de log personalizadas para a tarefa Fila de Mensagens.
Entrada no log |
Descrição |
|---|---|
MSMQAfterOpen |
Indica que a tarefa terminou de abrir a fila de mensagens. |
MSMQBeforeOpen |
Indica que a tarefa começou a abrir a fila de mensagens. |
MSMQBeginReceive |
Indica que a tarefa começou a receber uma mensagem. |
MSMQBeginSend |
Indica que a tarefa começou a enviar uma mensagem. |
MSMQEndReceive |
Indica que a tarefa terminou de receber uma mensagem. |
MSMQEndSend |
Indica que a tarefa terminou de enviar uma mensagem. |
MSMQTaskInfo |
Fornece informações descritivas sobre a tarefa. |
MSMQTaskTimeOut |
Indica que o tempo limite da tarefa foi esgotado. |
Tarefa Script
A tabela a seguir descreve a entrada de log personalizada da tarefa Script.
Entrada no log |
Descrição |
|---|---|
ScriptTaskLogEntry |
Informa os resultados da implementação de log no script. Uma entrada de log é gravada para cada chamada ao método Log do objeto Dts. A entrada é gravada quando o código é executado. Para obter mais informações, consulte Registrando a tarefa Script. |
Tarefa Enviar Email
A tabela a seguir relaciona as entradas de log personalizadas para a tarefa Enviar Email.
Entrada no log |
Descrição |
|---|---|
SendMailTaskBegin |
Indica que a tarefa começou a enviar uma mensagem de email. |
SendMailTaskEnd |
Indica que a tarefa terminou de enviar uma mensagem de email. |
SendMailTaskInfo |
Fornece informações descritivas sobre a tarefa. |
Tarefa Transferir Banco de Dados
A tabela a seguir relaciona as entradas de log personalizadas para a tarefa Transferir Banco de Dados.
Entrada no log |
Descrição |
|---|---|
SourceDB |
Especifica o banco de dados que a tarefa copiou. |
SourceSQLServer |
Especifica o computador a partir do qual o banco de dados foi copiado. |
Tarefa Transferir Mensagens de Erro
A tabela a seguir relaciona as entradas de log personalizadas para a tarefa Transferir Mensagens de Erro.
Entrada no log |
Descrição |
|---|---|
TransferErrorMessagesTaskFinishedTransferringObjects |
Indica que a tarefa terminou de transferir mensagens de erro. |
TransferErrorMessagesTaskStartTransferringObjects |
Indica que a tarefa começou a transferir as mensagens de erro. |
Tarefa Transferir Trabalhos
A tabela a seguir relaciona as entradas de log personalizadas para a tarefa Transferir Trabalhos.
Entrada no log |
Descrição |
|---|---|
TransferJobsTaskFinishedTransferringObjects |
Indica que a tarefa terminou a transferência dos trabalhos do SQL Server Agent. |
TransferJobsTaskStartTransferringObjects |
Indica que a tarefa começou a transferência dos trabalhos do SQL Server Agent. |
Tarefa Transferir Logons
A tabela a seguir relaciona as entradas de log personalizadas para a tarefa Transferir Logons.
Entrada no log |
Descrição |
|---|---|
TransferLoginsTaskFinishedTransferringObjects |
Indica que a tarefa terminou a transferência dos logons. |
TransferLoginsTaskStartTransferringObjects |
Indica que a tarefa começou a transferência dos logons. |
Tarefa Transferir Procedimentos Armazenados Mestres
A tabela a seguir relaciona as entradas de log personalizadas para a tarefa Transferir Procedimentos Armazenados Mestres.
Entrada no log |
Descrição |
|---|---|
TransferStoredProceduresTaskFinishedTransferringObjects |
Indica que a tarefa terminou de transferir procedimentos armazenados definidos pelo usuário armazenados no banco de dados mestre. |
TransferStoredProceduresTaskStartTransferringObjects |
Indica que a tarefa começou a transferir procedimentos armazenados definidos pelo usuário armazenados no banco de dados mestre. |
Tarefa Transferir Objetos do SQL Server
A tabela a seguir relaciona as entradas de log personalizadas da tarefa Transferir Objetos do SQL Server.
Entrada no log |
Descrição |
|---|---|
TransferSqlServerObjectsTaskFinishedTransferringObjects |
Indica que a tarefa terminou a transferência dos objetos de banco de dados do SQL Server. |
TransferSqlServerObjectsTaskStartTransferringObjects |
Indica que a tarefa começou a transferência dos objetos de banco de dados do SQL Server. |
Tarefa Serviços Web
A tabela a seguir relaciona as entradas de log personalizadas que podem ser habilitadas para a tarefa Serviços Web.
Entrada no log |
Descrição |
|---|---|
WSTaskBegin |
A tarefa começou a acessar um serviço Web. |
WSTaskEnd |
A tarefa completou um método de serviço Web. |
WSTaskInfo |
Informações descritivas sobre a tarefa. |
Tarefa Leitor de Dados do WMI
A tabela a seguir relaciona as entradas de log personalizadas para a tarefa Leitor de Dados do WMI.
Entrada no log |
Descrição |
|---|---|
WMIDataReaderGettingWMIData |
Indica que a tarefa começou a ser ler os dados do WMI. |
WMIDataReaderOperation |
Informa a consulta WQL executada pela tarefa. |
Tarefa Detector de Eventos do WMI
A tabela a seguir relaciona as entradas de log personalizadas da tarefa Detector de Eventos do WMI.
Entrada no log |
Descrição |
|---|---|
WMIEventWatcherEventOccurred |
Mostra que o evento ocorrido era o que a tarefa estava monitorando. |
WMIEventWatcherTimedout |
Indica que o tempo limite da tarefa foi esgotado. |
WMIEventWatcherWatchingForWMIEvents |
Indica que a tarefa começou a executar a consulta WQL. A entrada inclui a consulta. |
Tarefa XML
A tabela a seguir descreve a entrada de log personalizada da tarefa XML.
Entrada no log |
Descrição |
|---|---|
XMLOperation |
Fornece informações sobre a operação executada pela tarefa |
Conteúdo relacionado
Entrada de blog Logging custom events for Integration Services tasks (em inglês), em dougbert.com.
|
.gif "Ícone do Integration Services (pequeno)")
Mantenha-se atualizado com o Integration Services