프로그래밍 방식으로 복제 모니터링
적용 대상: SQL Server Azure SQL Managed Instance
복제 모니터는 복제 토폴로지를 모니터링할 수 있는 그래픽 도구입니다. 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을 실행합니다. 1단계의 @session_id에서 Session_id 값을 지정합니다. 이렇게 하면 해당 세션에 대한 세부 모니터링 정보가 표시됩니다.
관심 있는 각 세션에 대해 2단계를 반복합니다.
구독자에서 끌어오기 구독에 대한 병합 에이전트 세션을 모니터링하려면
구독 데이터베이스의 구독자에서 sp_replmonitorhelpmergesession을 실행합니다. 해당 구독에서 @publisher, @publication을 지정하고 @publisher_db에 대한 게시 데이터베이스의 이름을 지정합니다. 이렇게 하면 이 구독의 마지막 다섯 개 병합 에이전트 세션에 대한 모니터링 정보가 반환됩니다. 결과 집합에서 관심 있는 세션의 Session_id 값을 확인합니다.
구독 데이터베이스의 구독자에서 sp_replmonitorhelpmergesessiondetail을 실행합니다. 1단계의 @session_id에서 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를 호출하여 mss로 전달된 MergeSessionSummary 개체의 데이터를 새로 고치거나 RefreshSessionSummary를 호출하여 drRefresh로 전달된 DataRow 개체의 데이터를 새로 고침합니다.
3단계에서 얻은 세션 ID를 사용하여 다음 방법 중 하나를 호출하고 특정 세션의 세부 정보에 대한 정보를 반환합니다.
GetSessionDetails - 마지막 다섯 개까지의 병합 에이전트 세션에 대한 정보가 포함된 MergeSessionDetail 에 대한 T:Microsoft.SqlServer.Replication.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를 반환하는 경우 게시자 이름이 올바르게 정의되지 않았거나 해당 게시가 없는 것입니다.
기존 ReplicationMonitor 개체의 PublisherMonitors 속성을 통해 액세스한 PublisherMonitorCollection 항목에서 가져옵니다.
다음 방법 중 하나 이상을 실행하여 이 게시자에 속한 모든 게시에 대한 복제 정보를 반환합니다.
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를 반환하는 경우 게시 속성이 올바르게 정의되지 않았거나 게시가 없습니다.
기존 PublisherMonitor 개체의 PublicationMonitors 속성을 통해 액세스한 PublicationMonitorCollection 항목에서 가져옵니다.
다음 메서드 중 하나 이상을 실행하여 이 게시에 대한 정보를 반환합니다.
EnumErrorRecords - 지정된 오류에 대한 오류 레코드가 들어 있는 DataSet 개체를 반환합니다.
EnumLogReaderAgent - 게시의 로그 판독기 에이전트에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumMonitorThresholds - 이 게시의 모니터 경고 임계값 집합에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumQueueReaderAgent - 이 게시에서 사용하는 큐 판독기 에이전트에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumSnapshotAgent - 이 게시의 스냅샷 에이전트에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumSubscriptions - 이 게시의 구독에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumSubscriptions2 - 제공된 SubscriptionResultOption을 바탕으로 이 게시의 구독에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
EnumTracerTokenHistory - 지정된 추적 프로그램 토큰에 대한 대기 시간 정보를 포함하는 DataSet 개체를 반환합니다.
EnumTracerTokens - 이 게시에 삽입된 모든 추적 프로그램 토큰에 대한 정보가 들어 있는 DataSet 개체를 반환합니다.
구독자에서 적용 대기 중인 트랜잭션 명령을 모니터링하려면
ServerConnection 클래스를 사용하여 배포자 연결을 만듭니다.
다음 방법 중 하나로 PublicationMonitor 개체를 가져옵니다.
PublicationMonitor 클래스의 인스턴스를 만듭니다. 게시의 DistributionDBName, PublisherName, PublicationDBName및 Name 속성을 설정하고 ConnectionContext 속성을 1단계에서 만든 ServerConnection 으로 설정합니다. LoadProperties 메서드를 호출하여 개체 속성을 가져옵니다. 이 메서드가 false를 반환하는 경우 게시 속성이 올바르게 정의되지 않았거나 게시가 없습니다.
기존 PublisherMonitor 개체의 PublicationMonitors 속성을 통해 액세스한 PublicationMonitorCollection 항목에서 가져옵니다.
PendingCommandInfo 개체를 반환하는 TransPendingCommandInfo 메서드를 실행합니다.
이 PendingCommandInfo 개체의 속성을 사용하여 보류 중인 명령의 예상 개수와 해당 명령의 배달을 완료하는 데 소요될 시간을 확인합니다.
게시의 모니터 경고 임계값을 설정하려면
ServerConnection 클래스를 사용하여 배포자 연결을 만듭니다.
다음 방법 중 하나로 PublicationMonitor 개체를 가져옵니다.
PublicationMonitor 클래스의 인스턴스를 만듭니다. 게시의 DistributionDBName, PublisherName, PublicationDBName및 Name 속성을 설정하고 ConnectionContext 속성을 1단계에서 만든 ServerConnection 으로 설정합니다. LoadProperties 메서드를 호출하여 개체 속성을 가져옵니다. 이 메서드가 false를 반환하는 경우 게시 속성이 올바르게 정의되지 않았거나 게시가 없습니다.
기존 PublisherMonitor 개체의 PublicationMonitors 속성을 통해 액세스한 PublicationMonitorCollection 항목에서 가져옵니다.
EnumMonitorThresholds 메서드를 실행합니다. ArrayList 및 MonitorThreshold 개체의 반환에서 현재 임계값 설정을 확인합니다.
ChangeMonitorThreshold 메서드를 실행합니다. 다음 매개 변수를 전달합니다.
metricID - 다음 테이블에서 모니터링 임계값 메트릭을 나타내는 Int32 값입니다.
값 Description 1 만료 - 트랜잭션 게시에 대한 구독의 만료가 임박했는지 모니터링합니다. 2 대기 시간 - 트랜잭션 게시에 대한 구독의 성능을 모니터링합니다. 4 mergeexpiration - 병합 게시에 대한 구독의 만료가 임박했는지 모니터링합니다. 5 mergeslowrunduration - 저대역폭(전화 접속) 연결을 통한 병합 동기화의 기간을 모니터링합니다. 6 mergefastrunduration - 고대역폭 LAN 연결을 통한 병합 동기화 기간을 모니터링합니다. 7 mergefastrunspeed - 고대역폭(LAN) 연결을 통한 병합 동기화의 동기화 속도를 모니터링합니다. 8 mergeslowrunspeed - 저대역폭(전화 접속) 연결을 통한 병합 동기화의 동기화 속도를 모니터링합니다. enable - Boolean 게시에 대한 메트릭 사용 설정 여부를 나타내는 값입니다.
thresholdValue - 임계값을 설정하는 정수 값입니다.
shouldAlert - 이 임계값에서 경고를 생성할지 여부를 나타내는 정수입니다.