Reporting Services 구독 모니터링
사용자 인터페이스, Windows PowerShell 또는 로그 파일을 통해 Reporting Services 구독을 모니터링할 수 있습니다. 모니터링에 사용할 수 있는 옵션은 실행 중인 보고서 서버의 모드에 따라 달라집니다.
적용 대상:
Reporting Services 기본 모드
Reporting Services SharePoint 모드
문서 내용:
기본 모드 사용자 인터페이스
개별 Reporting Services 사용자는 웹 포털의 내 구독 페이지 또는 구독 탭을 사용하여 구독 상태를 모니터링할 수 있습니다. 구독 페이지에는 구독이 마지막으로 실행된 시간과 구독 상태를 나타내는 열이 있습니다. 구독을 처리하도록 예약하면 상태 메시지가 업데이트됩니다. 트리거가 발생하지 않는 경우(예: 보고서 실행 스냅샷이 새로 고쳐지지 않거나 일정이 실행되지 않음) 상태 메시지는 업데이트되지 않습니다.
다음 표에서는 상태 속성의 가능한 값을 설명합니다.
| Status | 설명 |
|---|---|
| 새 구독 | 구독을 처음 만들 때 나타납니다. |
| 비활성 | 구독을 처리할 수 없을 때 나타납니다. 자세한 내용은 이 문서의 뒷부분에 있는 "비활성 구독 관리"를 참조하세요. |
| 완료: 총 <number>개 중 <number>개가 처리되었고 <number>개 오류가 발생했습니다. | 데이터 기반 구독 실행의 상태를 표시합니다. 이 메시지는 예약 및 배달 프로세서에서 가져옵니다. |
| <number>개가 처리됨 | 일정 예약 및 배달 프로세서가 성공적으로 배달되었거나 더 이상 배달을 시도하지 않는 알림 수. 데이터 기반 배달이 완료되면 처리된 알림 수가 생성된 알림의 총 수와 같아야 합니다. |
| <총 number>개 | 구독의 마지막 배달에 대해 생성된 총 알림 수. |
| <number>개의 오류 | 일정 예약 및 배달 프로세서가 배달할 수 없거나 더 이상 배달을 시도하지 않는 알림 수. |
| 메일 전송 실패: 전송이 서버에 연결되지 않았습니다. | 보고서 서버가 메일 서버에 연결되지 않았음을 나타냅니다. 이 메시지는 이메일 배달 확장 프로그램에서 가져옵니다. |
| <filename> 파일을 <path>에 썼습니다. | 파일 공유 위치로의 배달이 성공했음을 나타냅니다. 이 메시지는 파일 공유 배달 확장 프로그램에서 가져옵니다. |
| 파일을 작성할 때 알 수 없는 오류가 발생했습니다. | 파일 공유 위치로의 배달이 성공하지 못했음을 나타냅니다. 이 메시지는 파일 공유 배달 확장 프로그램에서 가져옵니다. |
| 대상 폴더 <path>에 연결하지 못했습니다. 목적지 폴더 또는 파일 공유가 있는지 확인합니다. | 지정한 폴더를 찾을 수 없음을 나타냅니다. 이 메시지는 파일 공유 배달 확장 프로그램에서 가져옵니다. |
| <filename> 파일을 <path>에 쓸 수 없습니다. 다시 시도합니다. | 파일을 최신 버전으로 업데이트할 수 없음을 나타냅니다. 이 메시지는 파일 공유 배달 확장 프로그램에서 가져옵니다. |
| <filename> 파일에 쓰지 못했습니다. <message> | 파일 공유 위치로의 배달이 성공하지 못했음을 나타냅니다. 이 메시지는 파일 공유 배달 확장 프로그램에서 가져옵니다. |
| <custom status messages> | 배달 확장 프로그램에서 제공하는 배달 성공 및 실패에 대한 상태 메시지입니다. 타사 또는 사용자 지정 배달 확장 프로그램을 사용할 경우 추가 상태 메시지가 제공될 수 있습니다. |
또한, 보고서 서버 관리자는 현재 처리 중인 표준 구독을 모니터링할 수 있습니다. 데이터 기반 구독은 모니터링할 수 없습니다. 자세한 내용은 실행 중인 프로세스 관리를 참조하세요.
구독을 배달할 수 없는 경우(예: 메일 서버를 사용할 수 없는 경우) 배달 확장 프로그램이 배달을 재시도합니다. 구성 설정에 따라 시도할 횟수가 지정됩니다. 기본값은 재시도를 하지 않는 것입니다. 경우에 따라 데이터를 사용하지 않고 보고서를 처리할 수 있으며(예: 데이터 원본이 오프라인인 경우), 이 경우 해당 효과에 대한 텍스트가 메시지 본문에 제공됩니다.
기본 모드 로그 파일
배달 중에 오류가 발생하면 보고서 서버 추적 로그에 항목이 만들어집니다.
보고서 서버 관리자는 ReportServerService_*.log 파일을 검토하여 구독 배달 상태를 확인할 수 있습니다. 전자 메일 배달의 경우 보고서 서버 로그 파일에 처리 및 특정 전자 메일 계정으로 배달 레코드가 포함됩니다. 다음 경로는 로그 파일의 기본 위치입니다.
C:\Program Files\Microsoft SQL Server Reporting Services\SSRS\LogFiles
로그 파일 이름의 예는 다음과 같습니다.
ReportServerService__05_21_2019_00_05_07.log
다음 예는 구독과 관련된 추적 로그 파일 오류 메시지입니다.
- library!WindowsService_7!b60!05/20/2019-22:34:36 i INFO: Initializing EnableExecutionLogging to 'True' as specified in Server system properties.emailextension!WindowsService_7!b60!05/20/2019-22:34:41 오류: 메일을 보내는 중 오류가 발생했습니다. 예외: System.Net.Mail.SmtpException: SMTP 서버에 보안 연결이 필요하거나 클라이언트가 인증되지 않았습니다. 서버 응답: 5.7.1 클라이언트가 System.Net.Mail.MailCommand.CheckResponse(SmtpStatusCode statusCode, 문자열 응답)에서 인증되지 않음
로그 파일에는 보고서가 열렸는지 여부 또는 배달 성공 여부에 대한 정보가 포함되지 않습니다. 배달에 성공하면 일정 예약 및 배달 프로세서에서 생성된 오류가 없고 보고서 서버가 메일 서버에 연결되었음을 의미합니다. 이메일로 인해 사용자 사서함에서 배달할 수 없는 메시지 오류가 발생한 경우 해당 정보는 로그 파일에 포함되지 않습니다. 로그 파일에 대한 자세한 내용은 Reporting Services 로그 파일 및 소스를 참조하세요.
SharePoint 모드
SharePoint 모드에서 구독을 모니터링하려면 구독 관리 페이지에서 구독 상태를 모니터링할 수 있습니다.
보고서가 들어 있는 문서 라이브러리로 이동합니다.
보고서의 컨텍스트 메뉴(...)를 엽니다.
확장된 메뉴 옵션(...)을 선택합니다.
구독 관리를 선택합니다.
SharePoint ULS 로그 파일
구독 관련 정보는 SharePoint ULS 로그에 기록됩니다. ULS 로그에 대한 Reporting Services 이벤트를 구성하는 방법에 대한 자세한 내용은 SharePoint 추적 로그에 대한 Reporting Services 이벤트 설정(ULS)을 참조하세요. 다음은 Reporting Services 구독과 관련된 ULS 로그 항목을 보여주는 예입니다.
| 날짜 | Process | 영역 | Category | Level | Correlation | 메시지 |
|---|---|---|---|---|---|---|
| 2019/5/21 14:34:06:15 | 앱 풀: a0ba039332294f40bc4a81544afde01d | SQL Server Reporting Services | 보고서 서버 전자 메일 확장 프로그램 | 예기치 않은 | (비어 있음) | 메일을 보내는 중 오류가 발생했습니다. 예외: System.Net.Mail.SmtpException: 사서함을 사용할 수 없습니다. 서버 응답: 5.7.1 클라이언트에는 Microsoft.ReportingServices.EmailDeliveryProvider.EmailProvider.Deliver(Notification 알림)의 System.Net.Mail.SmtpClient.Send(MailMessage 메시지)에 있는 System.Net.Mail.DataStopCommand.Send(SmtpConnection conn)의 System.Net.Mail.DataStopCommand.CheckResponse(SmtpStatusCode statusCode, 문자열 serverResponse)에서 이 보낸 사람으로 보낼 수 있는 권한이 없습니다. |
PowerShell을 사용한 구독 모니터링
예를 들어 기본 모드 또는 SharePoint 모드 구독의 상태를 확인하는 데 사용할 수 있는 PowerShell 스크립트는 구독 소유자 관리 및 구독 실행 - PowerShell을 참조하세요.
비활성 구독 관리
구독이 비활성 상태가 되면 구독이 처리되지 못하게 하는 기본 조건을 해결하여 구독을 다시 활성화하거나 해당 구독을 삭제해야 합니다. 처리할 수 없는 조건이 발생하면 구독이 비활성 상태가 될 수 있습니다. 이러한 조건은 다음과 같습니다.
구독에 지정된 배달 확장 프로그램을 제거하는 경우.
자격 증명 설정을 저장 값에서 통합 값이나 프롬프트 입력 값으로 변경한 경우.
보고서 정의에서 매개 변수 이름이나 데이터 형식이 변경되고 보고서가 다시 게시된 경우. 구독에 더 이상 유효하지 않은 매개 변수가 포함되어 있으면 해당 구독이 비활성화됩니다.
보고서의 실행 모드가 변경됩니다(예: 보고서 실행 스냅샷으로 실행되도록 요청 시 실행 보고서 수정). 자세한 내용은 보고서 처리 속성 설정을 참조하세요.
구독 자체의 메시지는 비활성 구독을 나타냅니다. 이 메시지에는 해당 원인과 구독을 다시 활성화하는 단계에 대한 정보가 포함되어 있습니다.
조건으로 인해 구독이 비활성 상태가 되면 보고서 서버에서 구독을 실행할 때 구독에서 이 사실을 반영합니다. 예를 들어 매주 금요일 오전 2시에 구독 배달이 예약되고 여기서 사용하는 배달 확장 프로그램이 월요일 오전 9시에 제거되었습니다. 이 경우 구독은 금요일 오전 2시까지 비활성 상태를 반영하지 않습니다.