Monitore programaticamente a replicação

Aplica-se a:SQL Server Instância Gerenciada de SQL do Azure

O Replication Monitor é uma ferramenta gráfica que permite monitorar uma topologia de replicação. É possível acessar os mesmos dados de monitoramento programaticamente usando procedimentos armazenados de replicação do Transact-SQL ou objetos de gerenciamento de replicação (RMO). Esses objetos permitem programar as seguintes tarefas:

  • Monitore o estado de Editores, publicações e assinaturas.

  • Monitorar sessões do Agente de Mesclagem em um ou mais Assinantes.

  • Monitorar os comandos transacionais pendentes de aplicação em um ou mais Assinantes.

  • Definir os limites métricos que determinam quando uma publicação requer intervenção.

  • Monitore o status dos tokens de rastreamento.

Transact-SQL

Para monitorar Publicadores, publicações e assinaturas do Distribuidor

  1. No Distribuidor, no banco de dados de distribuição, execute sp_replmonitorhelppublisher. Isso retorna informações de monitoramento para todos os Publicadores que usam este Distribuidor. Para limitar o conjunto de resultados a um único Publicador, especifique @publisher.

  2. No Distribuidor, no banco de dados de distribuição, execute sp_replmonitorhelppublication. Isso retorna informações de monitoramento para todas as publicações que usam este Distribuidor. Para limitar o conjunto de resultados a um único Publicador, publicação ou banco de dados publicado, especifique @publisher, @publicationou @publisher_db, respectivamente.

  3. No Distribuidor, no banco de dados de distribuição, execute sp_replmonitorhelpsubscription. Isso retorna informações de monitoramento para todas as assinaturas que usam este Distribuidor. Para limitar o conjunto de resultados às assinaturas pertencentes a um único Publicador, publicação ou banco de dados publicado, especifique @publisher, @publicationou @publisher_db, respectivamente.

Para monitorar os comandos transacionais que estão aguardando aplicação no Assinante.

  1. No Distribuidor, no banco de dados de distribuição, execute sp_replmonitorsubscriptionpendingcmds. Isso retorna informações de monitoramento sobre todos os comandos pendentes de todas as assinaturas que usam este Distribuidor. Para limitar o conjunto de resultados aos comandos pendentes das assinaturas pertencentes a um único Publicador, publicação ou banco de dados publicado, especifique @publisher, @subscriber, @publicationou @publisher_db, respectivamente.

Para monitorar as alterações de mesclagem que estão à espera de ser enviadas ou baixadas

  1. No Publicador, no banco de dados de publicação, execute sp_showpendingchanges. Isso retorna um conjunto de resultados que mostra informações sobre as alterações que aguardam replicação para os Assinantes. Para limitar o conjunto de resultados às alterações que pertencem a uma única publicação ou artigo, especifique @publication ou @article, respectivamente.

  2. No Assinante, no banco de dados de assinatura, execute sp_showpendingchanges. Isso retorna um conjunto de resultados que mostra informações sobre as alterações que estão aguardando replicação para o Publicador. Para limitar o conjunto de resultados às alterações que pertencem a uma única publicação ou artigo, especifique @publication ou @article, respectivamente.

Para monitorar sessões do Agente de Mesclagem

  1. No Distribuidor, no banco de dados de distribuição, execute sp_replmonitorhelpmergesession. Isso retornará informações de monitoração, inclusive Session_id, em todas as sessões do Agente de Mesclagem de todas as assinaturas que usam esse Distribuidor. Você também pode obter o Session_id consultando a tabela do sistema MSmerge_sessions .

  2. No Distribuidor, no banco de dados de distribuição, execute sp_replmonitorhelpmergesessiondetail. Especifique um valor de Session_id da etapa 1 para @session_id. Isso exibirá informações de monitoramento detalhadas sobre a sessão.

  3. Repita a etapa 2 para cada sessão de interesse.

Para monitorar as sessões do Agente de Mesclagem para assinaturas pull a partir do Assinante

  1. No Assinante, no banco de dados da assinatura, execute sp_replmonitorhelpmergesession. Para uma assinatura determinada, especifique @publisher, @publicatione o nome do banco de dados de publicação para @publisher_db. Isso retornará informações de monitoração das últimas cinco sessões do Agente de Mesclagem para essa assinatura. Anote o valor de Session_id das sessões de interesse no conjunto de resultados.

  2. No Assinante, no banco de dados de assinatura, execute sp_replmonitorhelpmergesessiondetail. Especifique um valor de Session_id da etapa 1 para @session_id. Isso exibirá informações de monitoramento detalhadas sobre a sessão.

  3. Repita a etapa 2 para cada sessão de interesse.

Para exibir e modificar as métricas de limite do monitor para uma publicação

  1. No Distribuidor, no banco de dados de distribuição, execute sp_replmonitorhelppublicationthresholds. Isso retorna os limites de monitoramento definidos para todas as publicações que usam este Distribuidor. Para limitar o conjunto de resultados e monitorar os limites das publicações pertencentes a um único Publicador, a um banco de dados publicado ou a uma única publicação, especifique @publisher, @publisher_dbou @publication, respectivamente. Observe o valor de Metric_id para qualquer limite que deva ser alterado. Para obter mais informações, consulte Definir limites e avisos no Monitor de Replicação.

  2. No Distribuidor, no banco de dados de distribuição, execute sp_replmonitorchangepublicationthreshold. Especifique o seguinte, quando necessário:

    • O valor Metric_id obtido na etapa 1 para @metric_id.

    • Um valor novo para a métrica de limite do monitor para @value.

    • Um valor de 1 para @shouldalert, para que um alerta seja registrado quando esse limite for atingido, ou um valor de 0 se não for necessário emitir um alerta.

    • Um valor 1 para @mode , para habilitar a métrica de limite do monitor, ou um valor 2 para desabilitá-la.

Objetos de Gerenciamento de Replicação (RMO)

Para monitorar uma assinatura para uma publicação de mesclagem no Assinante

  1. Crie uma conexão com o Assinante usando a classe ServerConnection .

  2. Crie uma instância da classe MergeSubscriberMonitor e defina as propriedades Publisher, Publication, PublisherDB, SubscriberDB para a assinatura, e defina a propriedade ConnectionContext como ServerConnection criado na etapa 1.

  3. Chame um dos métodos seguintes para retornar informações sobre as sessões do Agente de Mesclagem para essa assinatura:

    • GetSessionsSummary - retorna uma matriz de objetos MergeSessionSummary com informações até as últimas cinco sessões do Agente de Mesclagem. Observe o valor SessionId para qualquer sessão do seu interesse.

    • GetSessionsSummary - retorna uma matriz de objetos MergeSessionSummary com informações das sessões do Agente de Mesclagem que ocorreram durante o número de horas passadas no parâmetro hours (até as últimas cinco sessões). Observe o valor SessionId para qualquer sessão do seu interesse.

    • GetLastSessionSummary - retorna um objeto MergeSessionSummary com informações sobre a última sessão do Agente de Mesclagem. Observe o valor de SessionId para esta sessão.

    • GetSessionsSummaryDataSet - retorna um objeto DataSet com informações sobre até as últimas cinco sessões do Agente de Mesclagem, uma em cada linha. Observe o valor da coluna Session_id para qualquer sessão do seu interesse.

    • GetLastSessionSummaryDataRow - retorna um objeto DataRow com informações sobre a última sessão do Agente de Mesclagem. Observe o valor da coluna Session_id para essa sessão.

  4. (Opcional) Chame o RefreshSessionSummary para atualizar os dados para o objeto MergeSessionSummary passado como mss, ou chame RefreshSessionSummary para atualizar os dados no objeto DataRow passado como drRefresh.

  5. Usando a id de sessão obtida na etapa 3, chame um dos métodos seguintes para retornar informações sobre os detalhes de uma sessão em particular:

Para monitorar as propriedades de replicação de todas as publicações em um Distribuidor

  1. Crie uma conexão com o Distribuidor usando a classe ServerConnection .

  2. Criar uma instância da classe ReplicationMonitor.

  3. Defina a propriedade ConnectionContext como ServerConnection criada na etapa 1.

  4. Chame o método LoadProperties para obter as propriedades do objeto.

  5. Execute um ou mais dos métodos seguintes para retornar informações de replicação para todos os Publicador que usam esse Distribuidor.

Para monitorar as propriedades da publicação de um Publicador específico no Distribuidor

  1. Crie uma conexão com o Distribuidor usando a classe ServerConnection .

  2. Consiga um objeto PublisherMonitor em um desses modos.

  3. Execute um ou mais dos métodos a seguir para retornar informações de replicação para todas as publicações que pertençam a esse Publicador.

Para monitorar as propriedades de uma publicação específica no Distribuidor

  1. Crie uma conexão com o Distribuidor usando a classe ServerConnection .

  2. Consiga um objeto PublicationMonitor em um desses modos.

  3. Execute um ou mais dos métodos seguintes para retornar informações sobre essa publicação.

Para monitorar os comandos transacionais que estão aguardando ser aplicados no Assinante.

  1. Crie uma conexão com o Distribuidor usando a classe ServerConnection .

  2. Consiga um objeto PublicationMonitor em um desses modos.

  3. Execute o método TransPendingCommandInfo que retorna um objeto PendingCommandInfo .

  4. Use as propriedades desse objeto PendingCommandInfo para determinar o número estimado de comandos pendentes e o tempo que levará para completar a entrega desses comandos.

Para definir os limites de aviso de monitoração para uma publicação

  1. Crie uma conexão com o Distribuidor usando a classe ServerConnection .

  2. Consiga um objeto PublicationMonitor em um desses modos.

  3. Execute o método EnumMonitorThresholds . Observe as configurações de limite atuais no ArrayList retornado dos objetos MonitorThreshold.

  4. Execute o método ChangeMonitorThreshold . Passe os seguintes parâmetros:

    • metricID - um valor Int32 que representa a métrica de limite de monitoração da tabela a seguir:

      Valor Descrição
      1 expiration - monitora a expiração iminente de assinaturas para publicações transacionais.
      2 latency - monitora o desempenho de assinaturas para publicações transacionais.
      4 mergeexpiration - monitora a expiração iminente de assinaturas para publicações de mesclagem.
      5 mergeslowrunduration - monitora a duração das sincronizações de mesclagem em conexões de baixa largura de banda (discadas).
      6 mergefastrunduration - monitora a duração de sincronizações de mesclagem em conexões LAN de alta largura de banda.
      7 mergefastrunspeed - monitora a taxa de sincronização das sincronizações de mesclagem em conexões (LAN) de alta largura de banda.
      8 mergeslowrunspeed - monitora a taxa de sincronização das sincronizações de mesclagem em conexões discadas de baixa largura de banda.

    • enable - Boolean valor que indica se a métrica está habilitada para publicação.

    • thresholdValue - valor inteiro que define o limite.

    • shouldAlert - inteiro que indica se esse limite deve gerar um alerta.

  • Last updated on