다음을 통해 공유


로깅을 위한 사용자 지정 메시지

Integration Services는 패키지 및 많은 작업에 대한 로그 항목을 작성하기 위한 다양한 사용자 지정 이벤트 집합을 제공합니다. 이러한 항목을 사용하여 나중에 분석할 수 있도록 미리 정의된 이벤트 또는 사용자 정의 메시지를 기록하여 실행 진행률, 결과 및 문제에 대한 자세한 정보를 저장할 수 있습니다. 예를 들어 대량 삽입이 시작되고 끝나는 시기를 기록하여 패키지가 실행되면 성능 문제를 식별할 수 있습니다.

사용자 지정 로그 항목은 패키지 및 모든 컨테이너 및 작업에 사용할 수 있는 표준 로깅 이벤트 집합과는 다른 항목 집합입니다. 사용자 지정 로그 항목은 패키지의 특정 작업에 대한 유용한 정보를 캡처하도록 조정됩니다. 예를 들어 SQL 실행 태스크에 대한 사용자 지정 로그 항목 중 하나는 태스크가 로그에서 실행하는 SQL 문을 기록합니다.

모든 로그 항목에는 패키지가 시작되고 완료되면 자동으로 기록되는 로그 항목을 포함하여 날짜 및 시간 정보가 포함됩니다. 대부분의 로그 이벤트는 로그에 여러 항목을 씁니다. 이는 일반적으로 이벤트에 다른 단계가 있을 때 발생합니다. 예를 들어 ExecuteSQLExecutingQuery 로그 이벤트는 세 개의 항목을 씁니다. 한 항목은 태스크가 데이터베이스에 대한 연결을 획득한 후, 다른 항목은 태스크가 SQL 문을 준비하기 시작한 후, SQL 문 실행이 완료된 후에는 하나 더 씁니다.

다음 Integration Services 개체에는 사용자 지정 로그 항목이 있습니다.

패키지

대량 삽입 작업

데이터 흐름 태스크

DTS 2000 작업 실행

프로세스 실행 태스크

SQL 실행 태스크

파일 시스템 태스크

FTP 작업

메시지 큐 태스크

스크립트 태스크

메일 보내기 태스크

데이터베이스 전송 태스크

오류 메시지 전송 태스크

작업 전송 태스크

로그인 전송 태스크

마스터 저장 프로시저 전송 태스크

SQL Server 개체 전송 태스크

웹 서비스 태스크

WMI 데이터 판독기 태스크

WMI Event Watcher 작업

XML 작업

로그 항목

패키지

다음 표에서는 패키지에 대한 사용자 지정 로그 항목을 나열합니다.

로그 항목 설명
PackageStart 패키지가 실행되기 시작했음을 나타냅니다.

참고: 이 로그 항목은 로그에 자동으로 기록됩니다. 제외할 수 없습니다.
PackageEnd 패키지가 완료되었음을 나타냅니다.

참고: 이 로그 항목은 로그에 자동으로 기록됩니다. 제외할 수 없습니다.
Diagnostic 동시에 실행할 수 있는 실행 파일 수와 같이 패키지 실행에 영향을 주는 시스템 구성에 대한 정보를 제공합니다.

로그 항목에는 Diagnostic 외부 데이터 공급자에 대한 호출에 대한 이전 및 이후 항목도 포함됩니다. 자세한 내용은 문제 해결 도구 패키지 연결을 참조하세요.

대량 삽입 작업

다음 표에서는 대량 삽입 태스크에 대한 사용자 지정 로그 항목을 나열합니다.

로그 항목 설명
DTSBulkInsertTaskBegin 대량 삽입이 시작되었음을 나타냅니다.
DTSBulkInsertTaskEnd 대량 삽입이 완료되었음을 나타냅니다.
DTSBulkInsertTaskInfos 태스크에 대한 설명 정보를 제공합니다.

데이터 흐름 태스크

다음 표에서는 데이터 흐름 태스크에 대한 사용자 지정 로그 항목을 나열합니다.

로그 항목 설명
BufferSizeTuning 데이터 흐름 태스크가 버퍼의 크기를 변경했음을 나타냅니다. 로그 항목은 크기 변경 이유를 설명하고 임시 새 버퍼 크기를 나열합니다.
OnPipelinePostEndOfRowset 구성 요소에 메서드의 마지막 호출 ProcessInput 에 의해 설정된 행 집합 끝 신호가 제공되었음을 나타냅니다. 입력을 처리하는 데이터 흐름의 각 구성 요소에 대해 항목이 작성됩니다. 항목에는 구성 요소의 이름이 포함됩니다.
OnPipelinePostPrimeOutput 구성 요소가 메서드에 대한 마지막 호출을 완료했음을 PrimeOutput 나타냅니다. 데이터 흐름에 따라 여러 로그 항목을 작성할 수 있습니다. 구성 요소가 원본인 경우 이는 구성 요소가 행 처리를 완료했음을 의미합니다.
OnPipelinePreEndOfRowset 구성 요소가 메서드의 마지막 호출에 의해 설정된 행 집합 끝 신호를 수신하려고 했음을 ProcessInput 나타냅니다. 입력을 처리하는 데이터 흐름의 각 구성 요소에 대해 항목이 작성됩니다. 항목에는 구성 요소의 이름이 포함됩니다.
OnPipelinePrePrimeOutput 구성 요소가 메서드에서 해당 호출을 수신하려고 했음을 PrimeOutput 나타냅니다. 데이터 흐름에 따라 여러 로그 항목을 작성할 수 있습니다.
OnPipelineRowsSent 메서드를 호출하여 구성 요소 입력에 제공된 행 수를 보고합니다 ProcessInput . 로그 항목에는 구성 요소 이름이 포함됩니다.
PipelineBufferLeak 버퍼 관리자가 사라지면 버퍼를 활성 상태로 유지하는 모든 구성 요소에 대한 정보를 제공합니다. 즉, 버퍼 리소스가 해제되지 않았으며 메모리 누수의 원인이 될 수 있습니다. 로그 항목은 구성 요소의 이름과 버퍼의 ID를 제공합니다.
PipelineExecutionPlan 데이터 흐름의 실행 계획을 보고합니다. 버퍼를 구성 요소로 보내는 방법에 대한 정보를 제공합니다. 이 정보는 PipelineExecutionTrees 항목과 함께 작업에서 발생하는 작업을 설명합니다.
PipelineExecutionTrees 데이터 흐름에서 레이아웃의 실행 트리를 보고합니다. 데이터 흐름 엔진의 스케줄러는 트리를 사용하여 데이터 흐름의 실행 계획을 작성합니다.
PipelineInitialization 작업에 대한 초기화 정보를 제공합니다. 이 정보에는 BLOB 데이터의 임시 스토리지에 사용할 디렉터리, 기본 버퍼 크기 및 버퍼의 행 수가 포함됩니다. 데이터 흐름 태스크의 구성에 따라 여러 로그 항목을 작성할 수 있습니다.

DTS 2000 작업 실행

다음 표에서는 DTS 2000 실행 태스크에 대한 사용자 지정 로그 항목을 나열합니다.

로그 항목 설명
ExecuteDTS80PackageTaskBegin 태스크가 DTS 2000 패키지를 실행하기 시작했음을 나타냅니다.
ExecuteDTS80PackageTaskEnd 작업이 완료되었음을 나타냅니다.

참고: DTS 2000 패키지는 작업이 종료된 후에도 계속 실행됩니다.
ExecuteDTS80PackageTaskTaskInfo 태스크에 대한 설명 정보를 제공합니다.
ExecuteDTS80PackageTaskTaskResult 태스크가 실행된 DTS 2000 패키지의 실행 결과를 보고합니다.

프로세스 실행 작업

다음 표에서는 프로세스 실행 태스크에 대한 사용자 지정 로그 항목을 나열합니다.

로그 항목 설명
ExecuteProcessExecutingProcess 태스크가 실행되도록 구성된 실행 파일을 실행하는 프로세스에 대한 정보를 제공합니다.

두 개의 로그 항목이 기록됩니다. 하나는 태스크가 실행되는 실행 파일의 이름과 위치에 대한 정보를 포함하고 다른 하나는 실행 파일에서 종료를 기록합니다.
ExecuteProcessVariableRouting 실행 파일의 입력 및 출력으로 라우팅되는 변수에 대한 정보를 제공합니다. 로그 항목은 stdin(입력), stdout(출력) 및 stderr(오류 출력)에 대해 작성됩니다.

SQL 작업 실행

다음 표에서는 SQL 실행 태스크에 대한 사용자 지정 로그 항목에 대해 설명합니다.

로그 항목 설명
ExecuteSQLExecutingQuery SQL 문의 실행 단계에 대한 정보를 제공합니다. 로그 항목은 태스크가 데이터베이스에 대한 연결을 획득할 때, 태스크가 SQL 문을 준비하기 시작할 때 및 SQL 문의 실행이 완료된 후에 기록됩니다. 준비 단계에 대한 로그 항목에는 태스크에서 사용하는 SQL 문이 포함됩니다.

파일 시스템 태스크

다음 표에서는 파일 시스템 태스크에 대한 사용자 지정 로그 항목에 대해 설명합니다.

로그 항목 설명
FileSystemOperation 태스크가 수행하는 작업을 보고합니다. 로그 항목은 파일 시스템 작업이 시작될 때 작성되며 원본 및 대상에 대한 정보를 포함합니다.

FTP 작업

다음 표에서는 FTP 태스크에 대한 사용자 지정 로그 항목을 나열합니다.

로그 항목 설명
FTPConnectingToServer 태스크가 FTP 서버에 대한 연결을 시작했음을 나타냅니다.
FTPOperation 태스크에서 수행하는 FTP 작업의 시작 부분과 유형을 보고합니다.

메시지 큐 작업

다음 표에서는 메시지 큐 태스크에 대한 사용자 지정 로그 항목을 나열합니다.

로그 항목 설명
MSMQAfterOpen 태스크가 메시지 큐 열기를 완료했음을 나타냅니다.
MSMQBeforeOpen 태스크가 메시지 큐를 열기 시작했음을 나타냅니다.
MSMQBeginReceive 태스크가 메시지를 받기 시작했음을 나타냅니다.
MSMQBeginSend 태스크가 메시지를 보내기 시작했음을 나타냅니다.
MSMQEndReceive 태스크가 메시지 수신을 완료했음을 나타냅니다.
MSMQEndSend 태스크에서 메시지 보내기를 완료했음을 나타냅니다.
MSMQTaskInfo 태스크에 대한 설명 정보를 제공합니다.
MSMQTaskTimeOut 작업 시간이 초과되었음을 나타냅니다.

스크립트 작업

다음 표에서는 스크립트 태스크에 대한 사용자 지정 로그 항목에 대해 설명합니다.

로그 항목 설명
ScriptTaskLogEntry 스크립트에서 로깅을 구현한 결과를 보고합니다. Dts 객체의 Log 메서드에 대한 각 호출마다 로그 항목이 작성됩니다. 코드가 실행되면 항목이 작성됩니다. 자세한 내용은 스크립트 태스크의 로깅을 참조하세요.

메일 보내기 태스크

다음 표에서는 메일 보내기 작업에 대한 사용자 지정 로그 항목을 나열합니다.

로그 항목 설명
SendMailTaskBegin 태스크가 전자 메일 메시지를 보내기 시작했음을 나타냅니다.
SendMailTaskEnd 작업이 전자 메일 메시지 보내기를 완료했음을 나타냅니다.
SendMailTaskInfo 태스크에 대한 설명 정보를 제공합니다.

데이터베이스 전송 태스크

다음 표에서는 데이터베이스 전송 태스크에 대한 사용자 지정 로그 항목을 나열합니다.

로그 항목 설명
SourceDB 태스크가 복사한 데이터베이스를 지정합니다.
SourceSQLServer 데이터베이스가 복사된 컴퓨터를 지정합니다.

오류 메시지 전송 태스크

다음 표에서는 오류 메시지 전송 태스크에 대한 사용자 지정 로그 항목을 나열합니다.

로그 항목 설명
TransferErrorMessagesTaskFinishedTransferringObjects 태스크에서 오류 메시지 전송을 완료했음을 나타냅니다.
TransferErrorMessagesTaskStartTransferringObjects 태스크가 오류 메시지를 전송하기 시작했음을 나타냅니다.

작업 전송 태스크

다음 표에서는 작업 전송 태스크에 대한 사용자 지정 로그 항목을 나열합니다.

로그 항목 설명
TransferJobsTaskFinishedTransferringObjects 태스크가 SQL Server 에이전트 작업 전송을 완료했음을 나타냅니다.
TransferJobsTaskStartTransferringObjects 태스크가 SQL Server 에이전트 작업을 전송하기 시작했음을 나타냅니다.

로그인 전송 태스크

다음 표에서는 로그인 전송 태스크에 대한 사용자 지정 로그 항목을 나열합니다.

로그 항목 설명
TransferLoginsTaskFinishedTransferringObjects 태스크가 로그인 전송을 완료했음을 나타냅니다.
TransferLoginsTaskStartTransferringObjects 태스크가 로그인을 전송하기 시작했음을 나타냅니다.

마스터 저장 프로시저 전송 작업

다음 표에서는 마스터 저장 프로시저 전송 태스크에 대한 사용자 지정 로그 항목을 나열합니다.

로그 항목 설명
TransferStoredProceduresTaskFinishedTransferringObjects 작업이 master 데이터베이스에 저장된 사용자 정의 저장 프로시저 전송을 완료했음을 나타냅니다.
TransferStoredProceduresTaskStartTransferringObjects 작업이 master 데이터베이스에 저장된 사용자 정의 저장 프로시저를 전송하기 시작했음을 나타냅니다.

SQL Server 개체 전송 태스크

다음 표에서는 SQL Server 개체 전송 태스크에 대한 사용자 지정 로그 항목을 나열합니다.

로그 항목 설명
TransferSqlServerObjectsTaskFinishedTransferringObjects 태스크가 SQL Server 데이터베이스 개체 전송을 완료했음을 나타냅니다.
TransferSqlServerObjectsTaskStartTransferringObjects 태스크가 SQL Server 데이터베이스 개체를 전송하기 시작했음을 나타냅니다.

웹 서비스 태스크

다음 표에서는 Web Services 작업에 사용할 수 있는 사용자 지정 로그 항목을 나열합니다.

로그 항목 설명
WSTaskBegin 작업이 웹 서비스에 액세스하기 시작했습니다.
WSTaskEnd 웹 서비스 메서드를 수행하는 작업이 완료되었습니다.
WSTaskInfo 작업에 대한 설명 정보입니다.

WMI 데이터 판독기 태스크

다음 표에서는 WMI 데이터 판독기 태스크에 대한 사용자 지정 로그 항목을 나열합니다.

로그 항목 설명
WMIDataReaderGettingWMIData 작업이 WMI 데이터를 읽기 시작했음을 나타냅니다.
WMIDataReaderOperation 태스크가 실행된 WQL 쿼리를 보고합니다.

WMI Event Watcher 작업

다음 표에서는 WMI Event Watcher 작업에 대한 사용자 지정 로그 항목을 나열합니다.

로그 항목 설명
WMIEventWatcherEventOccurred 태스크가 모니터링 중이던 이벤트가 발생했음을 나타냅니다.
WMIEventWatcherTimedout 작업 시간이 초과되었음을 나타냅니다.
WMIEventWatcherWatchingForWMIEvents 태스크가 WQL 쿼리를 실행하기 시작했음을 나타냅니다. 항목에는 쿼리가 포함됩니다.

XML 작업

다음 표에서는 XML 태스크에 대한 사용자 지정 로그 항목에 대해 설명합니다.

로그 항목 설명
XMLOperation 태스크가 수행하는 작업에 대한 정보를 제공합니다.

또한 참조하십시오

Integration Services(SSIS) 로그 기록