프로그래밍 방식으로 복제 모니터링

적용 대상:SQL ServerAzure SQL Managed Instance

복제 모니터는 복제본(replica) 토폴로지 모니터링할 수 있는 그래픽 도구입니다. Transact-SQL 복제본(replica)tion 저장 프로시저 또는 RMO(복제본(replica)tion 관리 개체)를 사용하여 프로그래밍 방식으로 동일한 모니터링 데이터에 액세스할 수 있습니다. 이러한 개체를 사용하면 다음 작업을 프로그래밍할 수 있습니다.

  • 게시자, 게시 및 구독의 상태를 모니터링합니다.

  • 하나 이상의 구독자에서 병합 에이전트 세션을 모니터링합니다.

  • 하나 이상의 구독자에서 적용 대기 중인 트랜잭션 명령 모니터링

  • 게시에 개입이 필요한 시기를 결정하는 임계값 메트릭 정의

  • 추적 프로그램 토큰의 상태 모니터링.

항목 내용

Transact-SQL

RMO(복제 관리 개체)

Transact-SQL

배포자에서 게시자, 게시 및 구독을 모니터링하려면

  1. 배포 데이터베이스의 배포자에서 sp_replmonitorhelppublisher를 실행합니다. 이 배포자를 사용하는 모든 게시자에 대한 모니터링 정보를 반환합니다. 결과 집합을 단일 게시자로 제한하려면 @publisher 지정합니다.

  2. 배포 데이터베이스의 배포자에서 sp_replmonitorhelppublication을 실행합니다. 이 배포자를 사용하여 모든 게시에 대한 모니터링 정보를 반환합니다. 결과 집합을 단일 게시자, 게시 또는 게시된 데이터베이스로 제한하려면 각각 @publisher, @publication 또는 @publisher_db 지정합니다.

  3. 배포 데이터베이스의 배포자에서 sp_replmonitorhelpsubscription 실행합니다. 이 배포자를 사용하여 모든 구독에 대한 모니터링 정보를 반환합니다. 결과 집합을 단일 게시자, 게시 또는 게시된 데이터베이스에 속한 구독으로 제한하려면 각각 @publisher, @publication 또는 @publisher_db 지정합니다.

구독자에서 적용되기를 기다리는 트랜잭션 명령을 모니터링하려면

  1. 배포 데이터베이스의 배포자에서 sp_replmonitorsubscriptionpendingcmds 실행합니다. 이 배포자를 사용하여 모든 구독에 대해 보류 중인 모든 명령에 대한 모니터링 정보를 반환합니다. 결과 집합을 단일 게시자, 구독자, 게시 또는 게시된 데이터베이스에 속하는 구독에 대해 보류 중인 명령으로 제한하려면 각각 @publisher, @subscriber, @publication 또는 @publisher_db 지정합니다.

업로드 또는 다운로드 대기 중인 병합 변경 내용을 모니터링하려면

  1. 게시 데이터베이스의 게시자에서 sp_showpendingchanges를 실행합니다. 구독자에게 복제본(replica) 대기 중인 변경 내용에 대한 정보를 보여 주는 결과 집합을 반환합니다. 결과 집합을 단일 게시 또는 아티클에 속하는 변경 내용으로 제한하려면 각각 @publication 또는 @article 지정합니다.

  2. 구독 데이터베이스의 구독자에서 sp_showpendingchanges 실행합니다. 그러면 게시자에 복제본(replica) 대기 중인 변경 내용에 대한 정보를 보여 주는 결과 집합이 반환됩니다. 결과 집합을 단일 게시 또는 아티클에 속하는 변경 내용으로 제한하려면 각각 @publication 또는 @article 지정합니다.

병합 에이전트 세션을 모니터링하려면

  1. 배포 데이터베이스의 배포자에서 sp_replmonitorhelpmergesession 실행합니다. 이렇게 하면 이 배포자를 사용하는 모든 구독의 모든 병합 에이전트 세션에 대해 Session_id를 포함한 모니터링 정보가 반환됩니다. MSmerge_sessions 시스템 테이블을 쿼리하여 Session_id 가져올 수도 있습니다.

  2. 배포 데이터베이스의 배포자에서 sp_replmonitorhelpmergesessiondetail 실행합니다. @session_id 1단계의 Session_id 값을 지정합니다. 이렇게 하면 해당 세션에 대한 세부 모니터링 정보가 표시됩니다.

  3. 관심 있는 각 세션에 대해 2단계를 반복합니다.

구독자에서 끌어오기 구독에 대한 병합 에이전트 세션을 모니터링하려면

  1. 구독 데이터베이스의 구독자에서 sp_replmonitorhelpmergesession 실행합니다. 지정된 구독의 경우 @publisher, @publication 및 @publisher_db 게시 데이터베이스의 이름을 지정합니다. 이렇게 하면 이 구독의 마지막 다섯 개 병합 에이전트 세션에 대한 모니터링 정보가 반환됩니다. 결과 집합에 관심 있는 세션의 Session_id 값을 확인합니다.

  2. 구독 데이터베이스의 구독자에서 sp_replmonitorhelpmergesessiondetail 실행합니다. @session_id 1단계의 Session_id 값을 지정합니다. 세션에 대한 자세한 모니터링 정보가 표시됩니다.

  3. 관심 있는 각 세션에 대해 2단계를 반복합니다.

게시에 대한 모니터 임계값 메트릭을 보고 수정하려면

  1. 배포 데이터베이스의 배포자에서 sp_replmonitorhelppublicationthresholds 실행합니다. 이렇게 하면 이 배포자를 사용하는 모든 게시의 모니터링 임계값 집합이 반환됩니다. 결과 집합을 단일 게시자 또는 게시된 데이터베이스에 속하는 게시에 대한 모니터 임계값으로 제한하거나 단일 게시로 제한하려면 각각 @publisher, @publisher_db또는 @publication을 지정합니다. 변경해야 하는 임계값에 대한 Metric_id 값을 확인합니다. 자세한 내용은 Set Thresholds and Warnings in Replication Monitor를 참조하세요.

  2. 배포 데이터베이스의 배포자에서 sp_replmonitorchangepublicationthreshold 실행합니다. 필요에 따라 다음을 지정합니다.

    • @metric_id 에 1단계에서 얻은 Metric_id값을 지정합니다.

    • @value 모니터 임계값 메트릭의 새 값입니다.

    • 이 임계값에 도달할 때 경고가 기록될 @shouldalert 값은 1이고, 경고가 필요하지 않은 경우 값은 0입니다.

    • 모니터 임계값 메트릭을 사용하도록 설정하려면 @mode 값이 1이거나, 사용하지 않도록 설정하려면 2입니다.

RMO(복제 관리 개체)

구독자에서 병합 게시에 대한 구독을 모니터링하려면

  1. 클래스를 사용하여 구독자에 대한 연결을 만듭니다 ServerConnection .

  2. MergeSubscriberMonitor 클래스의 인스턴스를 만들고, 구독에 대해 Publisher, Publication, PublisherDB, SubscriberDB 속성을 설정한 다음 ConnectionContext 속성을 1단계에서 만든 ServerConnection 으로 설정합니다.

  3. 다음 방법 중 하나를 호출하여 이 구독에 대한 병합 에이전트 세션에 대한 정보를 반환합니다.

    • GetSessionsSummary - 마지막 다섯 개까지의 병합 에이전트 세션에 대한 정보가 포함된 MergeSessionSummary 개체의 배열을 반환합니다. 관심 세션의 SessionId 값을 확인합니다.

    • GetSessionsSummary - 마지막 다섯 개까지의 병합 에이전트 세션에 대한 정보가 포함된 MergeSessionSummary 매개 변수로 전달한 시간 동안 발생한 병합 에이전트 세션(최대 마지막 다섯 개)에 대한 정보가 포함된 T:Microsoft.SqlServer.Replication.MergeSessionSummary 개체의 배열을 반환합니다. 관심 세션의 SessionId 값을 확인합니다.

    • GetLastSessionSummary - 마지막 병합 에이전트 세션에 대한 정보가 포함된 MergeSessionSummary 개체를 반환합니다. 이 세션의 SessionId 값을 확인합니다.

    • GetSessionsSummaryDataSet- 최대 5개의 병합 에이전트 세션에 대한 정보가 있는 개체를 각 행에 하나씩 반환 DataSet 합니다. 관심 있는 세션에 대한 Session_id 열의 값을 확인합니다.

    • GetLastSessionSummaryDataRow - 마지막 병합 에이전트 세션에 대한 정보가 포함된 DataRow 개체를 반환합니다. 이 세션의 Session_id 열 값을 확인합니다.

  4. (선택 사항) mss로 전달된 개체의 MergeSessionSummary 데이터를 새로 고치거나 drRefresh전달된 개체의 DataRow 데이터를 새로 고치도록 호출 RefreshSessionSummaryRefreshSessionSummary 합니다.

  5. 3단계에서 얻은 세션 ID를 사용하여 다음 방법 중 하나를 호출하여 특정 세션의 세부 정보에 대한 정보를 반환합니다.

배포자에서 모든 게시에 대한 복제본(replica)tion 속성을 모니터링하려면

  1. ServerConnection 클래스를 사용하여 배포자 연결을 만듭니다.

  2. ReplicationMonitor 클래스의 인스턴스를 만듭니다.

  3. ConnectionContext 속성을 1단계에서 만든 속성으로 ServerConnection 설정합니다.

  4. LoadProperties 메서드를 호출하여 개체 속성을 가져옵니다.

  5. 다음 방법 중 하나 이상을 실행하여 이 배포자를 사용하는 모든 게시자에 대한 복제본(replica) 정보를 반환합니다.

배포자에서 특정 게시자에 대한 게시 속성을 모니터링하려면

  1. ServerConnection 클래스를 사용하여 배포자 연결을 만듭니다.

  2. 다음 방법 중 하나로 PublisherMonitor 개체를 가져옵니다.

  3. 다음 방법 중 하나 이상을 실행하여 이 게시자에 속한 모든 게시에 대한 복제본(replica)tion 정보를 반환합니다.

배포자에서 특정 게시의 속성을 모니터링하려면

  1. ServerConnection 클래스를 사용하여 배포자 연결을 만듭니다.

  2. 다음 방법 중 하나로 PublicationMonitor 개체를 가져옵니다.

  3. 다음 메서드 중 하나 이상을 실행하여 이 게시에 대한 정보를 반환합니다.

구독자에서 적용 대기 중인 트랜잭션 명령을 모니터링하려면

  1. ServerConnection 클래스를 사용하여 배포자 연결을 만듭니다.

  2. 다음 방법 중 하나로 PublicationMonitor 개체를 가져옵니다.

  3. 개체를 TransPendingCommandInfo 반환하는 메서드를 실행합니다 PendingCommandInfo .

  4. PendingCommandInfo 개체의 속성을 사용하여 보류 중인 명령의 예상 개수와 해당 명령의 배달을 완료하는 데 소요될 시간을 확인합니다.

게시의 모니터 경고 임계값을 설정하려면

  1. ServerConnection 클래스를 사용하여 배포자 연결을 만듭니다.

  2. 다음 방법 중 하나로 PublicationMonitor 개체를 가져옵니다.

  3. 메서드를 실행합니다 EnumMonitorThresholds . 개체의 반환 ArrayListMonitorThreshold 에서 현재 임계값 설정을 확인합니다.

  4. 메서드를 실행합니다 ChangeMonitorThreshold . 다음 매개 변수를 전달합니다.

    • metricID - Int32 다음 표의 모니터링 임계값 메트릭을 나타내는 값입니다.

      Description
      1 만료 - 트랜잭션 게시에 대한 구독의 만료가 임박한지 모니터링합니다.
      2 대기 시간 - 트랜잭션 게시에 대한 구독의 성능을 모니터링합니다.
      4 mergeexpiration - 병합 게시에 대한 구독 만료가 임박했는지 모니터링합니다.
      5 mergeslowrunduration - 낮은 대역폭(전화 접속) 연결을 통해 병합 동기화 기간을 모니터링합니다.
      6 mergefastrunduration - LAN(고대역폭) 연결을 통해 병합 동기화 기간을 모니터링합니다.
      7 mergefastrunspeed - 고대역폭(LAN) 연결을 통한 병합 동기화의 동기화 속도를 모니터링합니다.
      8 mergeslowrunspeed - 낮은 대역폭(전화 접속) 연결을 통해 병합 동기화의 동기화 속도를 모니터링합니다.
    • 게시에 대해 메트릭을 사용할 수 있는지 여부를 나타내는 값을 사용하도록 설정합니다 - Boolean .

    • thresholdValue - 임계값을 설정하는 정수 값입니다.

    • shouldAlert - 이 임계값에서 경고를 생성할지 여부를 나타내는 정수입니다.