• 아티클

로깅할 메시지 사용자 지정

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

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

모든 로그 항목에는 패키지가 시작되고 끝날 때 자동으로 기록되는 로그 항목을 비롯하여 날짜 및 시간 정보가 포함됩니다. 로그 이벤트는 대부분 여러 항목을 로그에 기록합니다. 일반적으로 이벤트에 여러 단계가 있을 경우 이러한 기록이 수행됩니다. 예를 들어 ExecuteSQLExecutingQuery 로그 이벤트는 3개의 항목을 기록합니다. 즉, 태스크에서 데이터베이스에 대한 연결을 설정한 후, 태스크에서 SQL 문 준비를 시작한 후, SQL 문 실행이 완료된 후에 각각 하나씩의 항목을 기록합니다.

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

패키지

대량 삽입 태스크

데이터 흐름 태스크

DTS 2000 실행 태스크

프로세스 실행 태스크

SQL 실행 태스크

파일 시스템 태스크

FTP 태스크

메시지 큐 태스크

스크립트 태스크

메일 보내기 태스크

데이터베이스 전송 태스크

오류 메시지 전송 태스크

작업 전송 태스크

로그인 전송 태스크

Master 저장 프로시저 전송 태스크

SQL Server 개체 전송 태스크

웹 서비스 태스크

WMI 데이터 판독기 태스크

WMI 이벤트 감시자 태스크

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

태스크에서 로그인 전송을 시작했음을 나타냅니다.

Master 저장 프로시저 전송 태스크

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

로그 항목

설명

TransferStoredProceduresTaskFinishedTransferringObjects

태스크에서 master 데이터베이스에 저장된 사용자 정의 저장 프로시저 전송을 완료했음을 나타냅니다.

TransferStoredProceduresTaskStartTransferringObjects

태스크에서 master 데이터베이스에 저장된 사용자 정의 저장 프로시저 전송을 시작했음을 나타냅니다.

SQL Server 개체 전송 태스크

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

로그 항목

설명

TransferSqlServerObjectsTaskFinishedTransferringObjects

태스크에서 SQL Server 데이터베이스 개체 전송을 완료했음을 나타냅니다.

TransferSqlServerObjectsTaskStartTransferringObjects

태스크에서 SQL Server 데이터베이스 개체 전송을 시작했음을 나타냅니다.

웹 서비스 태스크

다음 표에서는 웹 서비스 태스크에 사용할 수 있는 사용자 지정 로그 항목을 나열합니다.

로그 항목

설명

WSTaskBegin

태스크에서 웹 서비스 액세스를 시작했습니다.

WSTaskEnd

태스크에서 웹 서비스 메서드를 완료했습니다.

WSTaskInfo

태스크에 대한 설명 정보입니다.

WMI 데이터 판독기 태스크

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

로그 항목

설명

WMIDataReaderGettingWMIData

태스크에서 WMI 데이터 읽기를 시작했음을 나타냅니다.

WMIDataReaderOperation

태스크에서 실행한 WQL 쿼리를 보고합니다.

WMI 이벤트 감시자 태스크

다음 표에서는 WMI 이벤트 감시자 태스크에 대한 사용자 지정 로그 항목을 나열합니다.

로그 항목

설명

WMIEventWatcherEventOccurred

태스크에서 모니터링하고 있는 이벤트가 발생했음을 나타냅니다.

WMIEventWatcherTimedout

태스크 시간이 초과되었음을 나타냅니다.

WMIEventWatcherWatchingForWMIEvents

태스크에서 WQL 쿼리 실행을 시작했음을 나타냅니다. 이 항목은 해당 쿼리를 포함합니다.

XML 태스크

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

로그 항목

설명

XMLOperation

태스크에서 수행한 작업에 대한 정보를 제공합니다.
Integration Services 아이콘(작은 아이콘) Integration Services 관련 최신 정보 얻기

Microsoft의 최신 다운로드, 아티클, 예제 및 비디오와 커뮤니티의 정선된 솔루션을 보려면 MSDN 또는 TechNet의 Integration Services 페이지를 방문하십시오.

이러한 업데이트에 대한 자동 알림을 받으려면 해당 페이지에서 제공하는 RSS 피드를 구독하십시오.