프로그래밍 방식으로 복제 모니터링
복제 모니터는 복제 토폴로지를 모니터링하는 데 사용할 수 있는 그래픽 도구입니다. Transact-SQL 복제 저장 프로시저 또는 RMO(복제 관리 개체)를 사용하여 프로그래밍 방식으로 동일한 모니터링 데이터에 액세스할 수 있습니다. 이러한 개체를 사용하면 다음 태스크를 프로그래밍할 수 있습니다.
게시자, 게시 및 구독의 상태 모니터링
하나 이상의 구독자에서 병합 에이전트 세션 모니터링
하나 이상의 구독자에서 적용 대기 중인 트랜잭션 명령 모니터링
게시에 개입이 필요한 시기를 결정하는 임계값 메트릭 정의
추적 프로그램 토큰의 상태 모니터링.
항목 내용
Transact-SQL
배포자에서 게시자, 게시 및 구독을 모니터링하려면
배포 데이터베이스의 배포자에서 sp_replmonitorhelppublisher를 실행합니다. 이렇게 하면 이 배포자를 사용하는 모든 게시자에 대한 모니터링 정보가 반환됩니다. 결과 집합을 단일 게시자로 제한하려면 @publisher 지정합니다.
배포 데이터베이스의 배포자에서 sp_replmonitorhelppublication을 실행합니다. 이렇게 하면 이 배포자를 사용하는 모든 게시에 대한 모니터링 정보가 반환됩니다. 결과 집합을 단일 게시자, 게시 또는 게시된 데이터베이스로 제한하려면 각각 @publisher, @publication 또는 @publisher_db 지정합니다.
배포 데이터베이스의 배포자에서 sp_replmonitorhelpsubscription을 실행합니다. 이렇게 하면 이 배포자를 사용하는 모든 구독에 대한 모니터링 정보가 반환됩니다. 결과 집합을 단일 게시자, 게시 또는 게시된 데이터베이스에 속하는 구독으로 제한하려면 각각 @publisher, @publication 또는 @publisher_db 지정합니다.
구독자에서 적용 대기 중인 트랜잭션 명령을 모니터링하려면
- 배포 데이터베이스의 배포자에서 sp_replmonitorsubscriptionpendingcmds를 실행합니다. 이렇게 하면 이 배포자를 사용하는 모든 구독에 대해 보류 중인 모든 명령의 모니터링 정보가 반환됩니다. 결과 집합을 단일 게시자, 구독자, 게시 또는 게시된 데이터베이스에 속하는 구독에 대해 보류 중인 명령으로 제한하려면 각각 @publisher, @subscriber, @publication 또는 @publisher_db 지정합니다.
업로드 또는 다운로드 대기 중인 병합 변경 내용을 모니터링하려면
게시 데이터베이스의 게시자에서 sp_showpendingchanges를 실행합니다. 이렇게 하면 구독자에 대해 복제 대기 중인 변경 내용에 대한 정보를 보여 주는 결과 집합이 반환됩니다. 결과 집합을 단일 게시 또는 아티클에 속하는 변경 내용으로 제한하려면 각각 @publication 또는 @article 지정합니다.
구독 데이터베이스의 구독자에서 sp_showpendingchanges를 실행합니다. 이렇게 하면 게시자에 대해 복제 대기 중인 변경 내용에 대한 정보를 보여 주는 결과 집합이 반환됩니다. 결과 집합을 단일 게시 또는 아티클에 속하는 변경 내용으로 제한하려면 각각 @publication 또는 @article 지정합니다.
병합 에이전트 세션을 모니터링하려면
배포 데이터베이스의 배포자에서 sp_replmonitorhelpmergesession을 실행합니다. 이렇게 하면 이 배포자를 사용하는 모든 구독의 모든 병합 에이전트 세션에 대해 Session_id를 포함한 모니터링 정보가 반환됩니다. MSmerge_sessions 시스템 테이블을 쿼리하여 Session_id 를 얻을 수도 있습니다.
배포 데이터베이스의 배포자에서 sp_replmonitorhelpmergesessiondetail을 실행합니다. @session_id 대해 1단계의 Session_id 값을 지정합니다. 이렇게 하면 해당 세션에 대한 세부 모니터링 정보가 표시됩니다.
각 관심 세션에 대해 2단계를 반복합니다.
구독자에서 끌어오기 구독에 대한 병합 에이전트 세션을 모니터링하려면
구독 데이터베이스의 구독자에서 sp_replmonitorhelpmergesession을 실행합니다. 지정된 구독의 경우 @publisher, @publication 및 @publisher_db 게시 데이터베이스의 이름을 지정합니다. 이렇게 하면 이 구독의 마지막 다섯 개 병합 에이전트 세션에 대한 모니터링 정보가 반환됩니다. 결과 집합에 있는 관심 세션의 Session_id 값을 확인합니다.
구독 데이터베이스의 구독자에서 sp_replmonitorhelpmergesessiondetail을 실행합니다. @session_id 대해 1단계의 Session_id 값을 지정합니다. 이렇게 하면 해당 세션에 대한 세부 모니터링 정보가 표시됩니다.
각 관심 세션에 대해 2단계를 반복합니다.
게시에 대한 모니터 임계값 메트릭을 보거나 수정하려면
배포 데이터베이스의 배포자에서 sp_replmonitorhelppublicationthresholds를 실행합니다. 이렇게 하면 이 배포자를 사용하는 모든 게시의 모니터링 임계값 집합이 반환됩니다. 단일 게시자 또는 게시된 데이터베이스 또는 단일 게시에 속하는 게시에 대한 임계값을 모니터링하도록 결과 집합을 제한하려면 각각 @publisher, @publisher_db 또는 @publication 지정합니다. 변경해야 하는 임계값에 대한 Metric_id 값을 확인합니다. 자세한 내용은 Set Thresholds and Warnings in Replication Monitor를 참조하세요.
배포 데이터베이스의 배포자에서 sp_replmonitorchangepublicationthreshold를 실행합니다. 다음을 필요한 대로 지정합니다.
@metric_id 대해 1단계에서 가져온 Metric_id 값입니다.
@value 모니터 임계값 메트릭의 새 값입니다.
이 임계값에 도달할 때 경고가 기록될 @shouldalert 값은 1이고, 경고가 필요하지 않은 경우 값은 0입니다.
모니터 임계값 메트릭을 사용하도록 설정하는 @mode 값 1 또는 사용하지 않도록 설정하는 값 2입니다.
RMO(복제 관리 개체)
구독자에서 병합 게시에 대한 구독을 모니터링하려면
ServerConnection 클래스를 사용하여 구독자 연결을 만듭니다.
MergeSubscriberMonitor 클래스의 인스턴스를 만들고, 구독에 대해 Publisher, Publication, PublisherDB, SubscriberDB 속성을 설정한 다음 ConnectionContext 속성을 1단계에서 만든 ServerConnection 으로 설정합니다.
다음 메서드 중 하나를 호출하여 이 구독의 병합 에이전트 세션에 대한 정보가 반환되도록 합니다.
GetSessionsSummary - 마지막 다섯 개까지의 병합 에이전트 세션에 대한 정보가 포함된 MergeSessionSummary 개체의 배열을 반환합니다. 관심 세션의 SessionId 값을 확인합니다.
GetSessionsSummary - 마지막 다섯 개까지의 병합 에이전트 세션에 대한 정보가 포함된 MergeSessionSummary 매개 변수로 전달한 시간 동안 발생한 병합 에이전트 세션(최대 마지막 다섯 개)에 대한 정보가 포함된 T:Microsoft.SqlServer.Replication.MergeSessionSummary 개체의 배열을 반환합니다. 관심 세션의 SessionId 값을 확인합니다.
GetLastSessionSummary - 마지막 병합 에이전트 세션에 대한 정보가 포함된 MergeSessionSummary 개체를 반환합니다. 이 세션의 SessionId 값을 확인합니다.
GetSessionsSummaryDataSet - 최대 마지막 다섯 개의 병합 에이전트 세션에 대한 정보가 각 행에 하나씩 포함된 DataSet 개체를 반환합니다. 관심 세션의 Session_id 열 값을 확인합니다.
GetLastSessionSummaryDataRow - 마지막 병합 에이전트 세션에 대한 정보가 포함된 DataRow 개체를 반환합니다. 이 세션의 Session_id 열 값을 확인합니다.
(옵션) RefreshSessionSummary 를 호출하여 MergeSessionSummary 로 전달된 T:Microsoft.SqlServer.Replication.MergeSessionSummary 개체의 데이터를 새로 고치거나, RefreshSessionSummary 를 호출하여 DataRow 로 전달된 T:System.Data.DataRow를 실행합니다.
3단계에서 가져온 세션 ID를 사용하여 다음 메서드 중 하나를 호출합니다. 그러면 특정 세션에 대한 세부 정보가 반환됩니다.
GetSessionDetails- 제공된 sessionID에 대한 개체 배열 MergeSessionDetail 을 반환합니다.
GetSessionDetailsDataSet- 지정된 sessionID에 대한 정보가 포함된 개체를 반환 DataSet 합니다.
배포자에서 모든 게시에 대한 복제 속성을 모니터링하려면
ServerConnection 클래스를 사용하여 배포자 연결을 만듭니다.
ReplicationMonitor 클래스의 인스턴스를 만듭니다.
ConnectionContext 속성을 1단계에서 만든 ServerConnection 으로 설정합니다.
LoadProperties 메서드를 호출하여 개체 속성을 가져옵니다.
다음 메서드 중 하나 이상을 실행하여 이 배포자를 사용하는 모든 게시자에 대한 복제 정보가 반환되도록 합니다.
EnumDistributionAgents - 이 배포자의 모든 배포 에이전트에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumErrorRecords - 배포자에 저장된 오류에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumLogReaderAgents - 배포자의 모든 로그 판독기 에이전트에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumMergeAgents - 배포자의 모든 병합 에이전트에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumMiscellaneousAgents - 배포자의 다른 모든 복제 에이전트에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumPublishers - 이 배포자의 모든 게시자에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumPublishers2 - 이 배포자를 사용하는 게시자를 반환하는 DataSet 개체를 반환합니다.
EnumQueueReaderAgents - 배포자의 모든 큐 판독기 에이전트에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumQueueReaderAgentSessionDetails - 지정된 큐 판독기 에이전트 및 세션에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumQueueReaderAgentSessions - 지정된 큐 판독기 에이전트에 대한 세션 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumSnapshotAgents - 배포자의 모든 스냅샷 에이전트에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
배포자에서 특정 게시자의 게시 속성을 모니터링하려면
ServerConnection 클래스를 사용하여 배포자 연결을 만듭니다.
다음 방법 중 하나로 PublisherMonitor 개체를 가져옵니다.
PublisherMonitor 클래스의 인스턴스를 만듭니다. 게시자의 Name 속성을 설정하고 ConnectionContext 속성을 1단계에서 만든 ServerConnection 으로 설정합니다. LoadProperties 메서드를 호출하여 개체 속성을 가져옵니다. 이 메서드가
false
를 반환하는 경우 게시자 이름이 올바르게 정의되지 않았거나 해당 게시가 없는 것입니다.기존 PublisherMonitorCollection 개체의 PublisherMonitors 속성을 통해 액세스한 ReplicationMonitor 에서 가져옵니다.
다음 메서드 중 하나 이상을 실행하여 이 배포자에 속해 있는 모든 게시에 대한 복제 정보가 반환되도록 합니다.
EnumDistributionAgentSessionDetails - 지정된 배포 에이전트 및 세션에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumDistributionAgentSessions - 지정된 배포 에이전트에 대한 세션 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumErrorRecords - 지정된 오류에 대한 오류 레코드 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumLogReaderAgentSessionDetails - 지정된 로그 판독기 에이전트 및 세션에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumLogReaderAgentSessions - 지정된 로그 판독기 에이전트에 대한 세션 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumMergeAgentSessionDetails - 지정된 병합 에이전트 및 세션에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumMergeAgentSessionDetails2 - 지정된 병합 에이전트 및 세션에 대한 추가 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumMergeAgentSessions - 지정된 병합 에이전트에 대한 세션 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumMergeAgentSessions2 - 지정된 병합 에이전트에 대한 추가 세션 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumPublications - 이 배포자의 모든 게시에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumPublications2 - 이 배포자의 모든 게시에 대한 추가 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumSnapshotAgentSessionDetails - 지정된 스냅샷 에이전트 및 세션에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumSnapshotAgentSessions - 지정된 스냅샷 에이전트에 대한 세션 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumSubscriptions - 이 배포자의 게시에 대한 모든 구독과 관련된 정보가 들어 있는 DataSet 개체를 반환합니다.
배포자에서 특정 게시의 속성을 모니터링하려면
ServerConnection 클래스를 사용하여 배포자 연결을 만듭니다.
다음 방법 중 하나로 PublicationMonitor 개체를 가져옵니다.
PublicationMonitor 클래스의 인스턴스를 만듭니다. 게시의 DistributionDBName, PublisherName, PublicationDBName및 Name 속성을 설정하고 ConnectionContext 속성을 1단계에서 만든 ServerConnection 으로 설정합니다. LoadProperties 메서드를 호출하여 개체 속성을 가져옵니다. 이 메서드가
false
를 반환하는 경우 게시 속성이 올바르게 정의되지 않았거나 해당 게시가 없는 것입니다.기존 PublicationMonitorCollection 개체의 PublicationMonitors 속성을 통해 액세스한 PublisherMonitor 에서 가져옵니다.
다음 메서드 중 하나 이상을 실행하여 이 게시에 대한 정보가 반환되도록 합니다.
EnumErrorRecords - 지정된 오류에 대한 오류 레코드가 들어 있는 DataSet 개체를 반환합니다.
EnumLogReaderAgent - 이 게시의 로그 판독기 에이전트에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumMonitorThresholds - 이 게시의 모니터 경고 임계값 집합에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumQueueReaderAgent - 이 게시에 사용되는 큐 판독기 에이전트에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumSnapshotAgent - 이 게시의 스냅샷 에이전트에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumSubscriptions - 이 게시에 대한 구독과 관련된 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumSubscriptions2 - 지정된 DataSet 에 따라 이 게시에 대한 구독과 관련된 추가 정보가 들어 있는 SubscriptionResultOption개체를 반환합니다.
EnumTracerTokenHistory - 지정된 추적 프로그램 토큰에 대한 대기 시간 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumTracerTokens - 이 게시에 삽입된 모든 추적 프로그램 토큰에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
구독자에서 적용 대기 중인 트랜잭션 명령을 모니터링하려면
ServerConnection 클래스를 사용하여 배포자 연결을 만듭니다.
다음 방법 중 하나로 PublicationMonitor 개체를 가져옵니다.
PublicationMonitor 클래스의 인스턴스를 만듭니다. 게시의 DistributionDBName, PublisherName, PublicationDBName및 Name 속성을 설정하고 ConnectionContext 속성을 1단계에서 만든 ServerConnection 으로 설정합니다. LoadProperties 메서드를 호출하여 개체 속성을 가져옵니다. 이 메서드가
false
를 반환하는 경우 게시 속성이 올바르게 정의되지 않았거나 해당 게시가 없는 것입니다.기존 PublicationMonitorCollection 개체의 PublicationMonitors 속성을 통해 액세스한 PublisherMonitor 에서 가져옵니다.
TransPendingCommandInfo 개체를 반환하는 PendingCommandInfo 메서드를 실행합니다.
이 PendingCommandInfo 개체의 속성을 사용하여 보류 중인 명령의 예상 개수와 해당 명령의 배달을 완료하는 데 소요될 시간을 확인합니다.
게시의 모니터 경고 임계값을 설정하려면
ServerConnection 클래스를 사용하여 배포자 연결을 만듭니다.
다음 방법 중 하나로 PublicationMonitor 개체를 가져옵니다.
PublicationMonitor 클래스의 인스턴스를 만듭니다. 게시의 DistributionDBName, PublisherName, PublicationDBName및 Name 속성을 설정하고 ConnectionContext 속성을 1단계에서 만든 ServerConnection 으로 설정합니다. LoadProperties 메서드를 호출하여 개체 속성을 가져옵니다. 이 메서드가
false
를 반환하는 경우 게시 속성이 올바르게 정의되지 않았거나 해당 게시가 없는 것입니다.기존 PublicationMonitorCollection 개체의 PublicationMonitors 속성을 통해 액세스한 PublisherMonitor 에서 가져옵니다.
EnumMonitorThresholds 메서드를 실행합니다. ArrayList 개체의 반환된 MonitorThreshold 에서 현재 임계값 설정을 확인합니다.
ChangeMonitorThreshold 메서드를 실행합니다. 다음 매개 변수를 전달합니다.
metricID - 다음 테이블에서 모니터링 임계값 메트릭을 나타내는 Int32 값입니다.
값 Description 1 expiration
- 트랜잭션 게시에 대한 구독의 만료가 임박했는지 모니터링합니다.2 latency
- 트랜잭션 게시에 대한 구독의 성능을 모니터링합니다.4 mergeexpiration
- 병합 게시에 대한 구독의 만료가 임박했는지 모니터링합니다.5 mergeslowrunduration
- 저대역폭(전화 접속) 연결을 통한 병합 동기화의 기간을 모니터링합니다.6 mergefastrunduration
- 고대역폭(LAN) 연결을 통한 병합 동기화의 기간을 모니터링합니다.7 mergefastrunspeed
- 고대역폭(LAN) 연결을 통한 병합 동기화의 동기화 속도를 모니터링합니다.8 mergeslowrunspeed
- 저대역폭(전화 접속) 연결을 통한 병합 동기화의 동기화 속도를 모니터링합니다.enable - Boolean 값입니다.
thresholdValue - 임계값을 설정하는 정수 값입니다.
shouldAlert - 이 임계값에서 경고를 생성할지 여부를 나타내는 정수입니다.