Reporting Services 추적 로그
추적 로그에는 보고서 서버 작업에 대한 세부 정보가 들어 있습니다. 즉, 다른 로그 파일에 기록되는 중복된 정보와 다른 방법으로는 사용할 수 없는 추가 정보가 포함되어 있습니다. 추적 로그는 보고서 서버가 포함된 응용 프로그램을 디버깅하거나 이벤트 로그 또는 실행 로그에 기록된 특정 문제를 조사하는 경우에 유용합니다.
추적 로그는 매일 생성되며 현지 시간으로 자정 후에 발생하는 첫 번째 항목으로 시작합니다. 추적 로그 파일의 이름은 컴퓨터의 현지 시간에서 파생됩니다. 기본적으로 추적 로그는 32MB로 제한되며 14일 후 삭제됩니다.
추적 로그 찾기
SQL Server Reporting Services에서는 4개의 추적 로그 파일을 제공하며 이러한 추적 로그 파일은 \Microsoft SQL Server\<SQL Server Instance>\Reporting Services\LogFiles에 있습니다. 다음 표에서는 추적 로그 파일을 설명합니다.
로그 파일 이름 | 설명 |
---|---|
ReportServerService_<timestamp>.log |
보고서 서버 Windows 서비스 작업자 스레드에 대한 추적 로그 |
ReportServerService_main_<timestamp>.log |
보고서 서버 Windows 서비스 관리 스레드에 대한 추적 로그 |
ReportServerWebApp_<timestamp>.log |
보고서 관리자에 대한 추적 로그 |
ReportServer_<timestamp>.log |
보고서 서버 웹 서비스에 대한 추적 로그 |
로그 정보 보기
추적 로그는 텍스트 파일입니다. 텍스트 편집기를 사용하여 로그를 볼 수 있습니다. 다음 정보를 추적 로그에서 확인할 수 있습니다.
- 운영 체제, 버전, 프로세서 수 및 메모리를 포함한 시스템 정보
- Reporting Services 구성 요소 및 버전 정보
- 응용 프로그램 로그에 기록된 이벤트
- 보고서 서버에서 생성한 예외
- 보고서 서버에서 기록한 리소스 부족 경고
- 인바운드 SOAP Envelope 및 요약된 아웃바운드 SOAP Envelope
- HTTP 헤더, 스택 추적 및 디버그 추적 정보
추적 로그를 검토하여 보고서가 배달되었는지 여부, 보고서를 받은 사람 및 배달 시도 횟수를 확인할 수 있습니다. 또한 추적 로그는 보고서 실행 작업 및 보고서 처리 중에 적용되는 환경 변수를 기록합니다. 오류와 예외도 추적 로그에 입력됩니다. 예를 들어 ThreadAbortExceptions 항목으로 표시되는 보고서 시간 초과 오류를 찾을 수 있습니다.
추적 수준 설정
추적 수준은 DefaultTraceSwitch 및 RSTrace 설정을 통해 지정됩니다. 각 구성 요소는 서로 다른 구성 파일에 추적 수준 설정을 저장합니다. 각 로그 파일에 기록되는 정보의 양을 제어하려면 해당 구성 파일에서 설정을 수정해야 합니다.
구성 요소 로그 파일 이름 | 추적 설정을 포함하는 구성 파일 |
---|---|
ReportServerService_<timestamp>.log 및 ReportServerService_main_<timestamp>.log |
ReportingServicesService.config 파일 자세한 내용은 ReportingServicesService 구성 파일을 참조하십시오. Windows 서비스를 다시 시작한 후 구성 파일의 변경 내용이 적용됩니다. |
ReportServerWebApp_<timestamp>.log |
보고서 관리자의 Web.config 파일(Program Files\SQL Server\MSSQL.n\Reporting Services\ReportManager 폴더) 구성 파일의 변경 내용이 즉시 적용됩니다. |
ReportServer_<timestamp>.log |
보고서 서버 웹 서비스의 Web.config 파일(Program Files\SQL Server\MSSQL.n\Reporting Services\ReportServer 폴더) 구성 파일의 변경 내용이 즉시 적용됩니다. |
RStrace 설정
다음 예에서는 RStrace 설정의 XML 구조를 보여 줍니다. DefaultTraceSwitch 값에 따라 로그에 추가되는 정보의 종류가 결정됩니다. Components 특성을 제외하고 RStrace 값은 구성 파일 전반에서 모두 동일합니다. Components 특성의 경우 보고서 서버 Web.config 파일에 대해 유효한 값 집합이 다릅니다. 이 섹션의 표에서는 이 특성에 대해 유효한 값을 설명합니다.
<system.diagnostics>
<switches>
<add name="DefaultTraceSwitch" value="3" />
</switches>
</system.diagnostics>
<RStrace>
<add name="FileName" value="ReportServerService_" />
<add name="FileSizeLimitMb" value="32" />
<add name="KeepFilesForDays" value="14" />
<add name="Prefix" value="tid, time" />
<add name="TraceListeners" value="debugwindow, file" />
<add name="TraceFileMode" value="unique" />
<add name="Components" value="all" />
</RStrace>
다음 표에서는 각 설정에 대한 정보를 제공합니다.
설정 | 설명 |
---|---|
RStrace |
오류 및 추적에 사용되는 네임스페이스를 지정합니다. |
DefaultTraceSwitch |
ReportServerService 추적 로그에 보고되는 정보의 수준을 지정합니다. 각 수준에는 낮은 번호가 매겨진 모든 수준별로 보고된 정보가 들어 있습니다. 추적을 설정하는 것이 좋습니다. 다음 값을 사용할 수 있습니다. 0=추적 해제 1=예외 및 다시 시작 2=예외, 다시 시작, 경고 3=예외, 다시 시작, 경고, 상태 메시지(기본값) 4=세부 정보 표시 모드 |
FileName |
로그 파일 이름의 첫 번째 부분을 지정합니다. Prefix에 지정된 값으로 이름의 나머지 부분을 완성합니다. |
FileSizeLimitMb |
추적 로그 크기에 대한 상한값을 지정합니다. 파일은 메가바이트(MB) 단위로 측정됩니다. 유효한 값은 0에서 최대 정수 사이입니다. 기본값은 32입니다. 0이나 음수를 지정하면 보고서 서버에서 해당 값을 1로 처리합니다. |
KeepFilesForDays |
추적 로그 파일을 몇 일 후에 삭제할지 지정합니다. 유효한 값은 0에서 최대 정수 사이입니다. 기본값은 14입니다. 0이나 음수를 지정하면 보고서 서버에서 해당 값을 1로 처리합니다. |
Prefix |
로그 인스턴스를 구분하는 생성 값을 지정합니다. 기본적으로 타임스탬프 값이 추적 로그 파일 이름에 추가됩니다. 이 값은 " tid, time"으로 설정됩니다. 이 설정을 수정하지 마십시오. |
TraceListeners |
추적 로그 내용을 출력할 대상을 지정합니다. 대상이 여러 개일 경우 쉼표로 구분하여 지정할 수 있습니다. 다음 값을 사용할 수 있습니다. DebugWindow(기본값) File(기본값) StdOut |
TraceFileMode |
추적 로그에 24시간 동안의 데이터를 포함할지 여부를 지정합니다. 일별로 각 구성 요소마다 고유한 추적 로그가 하나씩 있어야 합니다. 이 값은 "Unique(기본값)"로 설정됩니다. 이 값은 수정하지 마십시오. |
Components |
추적 로그 정보를 생성할 구성 요소와 해당 추적 수준을 지정합니다. 구성 파일 전반에서 사용할 수 있는 값은 다양합니다. ReportServerService.exe.config 및 보고서 관리자의 Web.config 파일: 기본값은 all입니다. 이 설정에 대한 기타 유효한 값에는 내부 구성 요소의 이름이 포함됩니다. 해당 구성 파일에서 이 값을 수정하지 마십시오. 보고서 서버의 Web.config 파일: 기본값은 "all,RunningJobs:3,SemanticQueryEngine:2,SemanticModelGenerator:2"입니다. 이 Web.config 파일에서 Components에 대한 유효한 값에는 구성 요소와 해당 추적 수준이 함께 쉼표로 구분되어 나열됩니다. 여기서 0은 추적 해제, 1은 예외 및 다시 시작, 2는 예외, 다시 시작, 경고, 3은 예외, 다시 시작, 경고, 상태 메시지(기본값), 4는 세부 정보 표시를 나타냅니다.
구성 요소를 모두 또는 일부 지정할 수 있습니다(all, RunningJobs, SemanticQueryEngine, SemanticModelGenerator). 특정 구성 요소에 대해 정보를 생성하지 않으려면 "SemanticModelGenerator:0"과 같이 해당 구성 요소에 대해 추적을 해제합니다. all에 대한 추적은 해제하지 마십시오. 구성 요소에 추적 수준을 추가하지 않으면 DefaultTraceSwitch에 지정된 값이 사용됩니다. 예를 들어 "all,RunningJobs,SemanticQueryEngine,SemanticModelGenerator"를 지정하면 모든 구성 요소에서 기본 추적 수준을 사용합니다. 각 의미 체계 쿼리에 대해 생성되는 Transact-SQL 문을 보려면 "SemanticQueryEngine:4"를 설정합니다. Transact-SQL 문은 추적 로그에 기록됩니다. 다음 예에서는 로그에 Transact-SQL 문을 추가하는 구성 설정을 보여 줍니다. <add name="Components" value="all,SemanticQueryEngine:4" /> |
덤프 파일 위치 지정을 위한 사용자 지정 구성 설정 추가
Windows용 Dr. Watson 도구에서 덤프 파일 저장에 사용하는 위치를 설정하기 위해 사용자 지정 설정을 추가할 수 있습니다. 사용자 지정 설정은 Directory입니다. 다음 예에서는 RStrace 섹션에 이 구성 설정을 지정하는 방법을 보여 줍니다.
<add name="Directory" value="U:\logs\" />
자세한 내용은 Microsoft 웹 사이트의 기술 자료 문서 913046을 참조하십시오.
참고 항목
개념
관련 자료
Reporting Services 오류 및 이벤트
Reporting Services 문제 해결