Mensagens personalizadas para log

  • Artigo

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.

ObservaçãoObservação

Esta entrada de log é gravada no log automaticamente. Não é possível excluí-la.

PackageEnd

Indica que o pacote foi concluído.

ObservaçãoObservação

Esta entrada de log é gravada no log automaticamente. Não é possível excluí-la.

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.

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

ObservaçãoObservação

O pacote DTS 2000 pode continuar sendo executado após a conclusão da tarefa.

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.

Ícone do Integration Services (pequeno) Mantenha-se atualizado com o Integration Services

Para obter os downloads, artigos, exemplos e vídeos da Microsoft mais recentes, bem como soluções selecionadas da comunidade, visite a página do Integration Services no MSDN:


Para receber uma notificação automática dessas atualizações, assine os RSS feeds disponíveis na página.

Consulte também

Conceitos

Log do SSIS (Integration Services)