Configure usando a OpenTelemetry Collector Contribution para Microsoft SQL Server

Pré-requisitos

• OpenTelemetry Collector Contrib (otelcol-contrib) instalado e configurado no seu sistema. É possível fazer o download da versão mais recente na página de releases do OpenTelemetry Collector.

Habilite as métricas da interface

É possível enriquecer a experiência na plataforma New Relic adicionando e ativando as várias métricas no arquivo de configuração otelcol-contrib. Usando a configuração fornecida nesta seção, é possível preencher dados para as seguintes páginas na plataforma New Relic:

• Overview

• Query performance

• Wait events

• Sessions

• Clients

  Ativar métricas da página Overview

  A página Overview exibe uma visão de alto nível da instância do Microsoft SQL Server, incluindo métricas principais, como contagem de banco de dados, I/O, latência, operações, espaço tempdb, taxa de deadlock e muito mais.

  Para preencher os dados da página Overview na plataforma New Relic, adicione a seguinte configuração ao arquivo de configuração otelcol-contrib:

  receivers:
      sqlserver:
  
          # Enable comprehensive database metrics
        metrics:
          sqlserver.database.count:
            enabled: true
          sqlserver.database.io:
            enabled: true
          sqlserver.database.latency:
            enabled: true
          sqlserver.database.operations:
            enabled: true
          sqlserver.database.tempdb.space:
            enabled: true
          sqlserver.database.tempdb.version_store.size:
            enabled: true
          sqlserver.deadlock.rate:
            enabled: true
          sqlserver.os.wait.duration:
            enabled: true
          sqlserver.processes.blocked:
            enabled: true
          sqlserver.memory.grants.pending.count:
            enabled: true
          sqlserver.memory.area:
            enabled: true

  Copiar

  Ativar Métricas de Desempenho de Consulta, Sessão, Espera e Cliente

  É possível preencher dados para as seguintes páginas na plataforma New Relic:

  • Query performance: exibe informações detalhadas sobre as consultas em execução na instância do Microsoft SQL Server nas seguintes guias:

    • Normalized queries: exibe os gráficos de execução e tempo médio de CPU.
    • Query samples: exibe execuções individuais de consulta, incluindo horário de início, duração, tipo de espera, tempo de espera, banco de dados, usuário do BD e host do cliente.

  • Wait events: exibe informações sobre os eventos de espera que ocorrem na instância do Microsoft SQL Server. A visualização de amostras de consulta mostra as consultas em espera no momento, juntamente com seu tipo e tempo de espera.

  • Sessions: Exibe informações sobre as sessões conectadas à sua instância do Microsoft SQL Server, incluindo contagens de sessões, estados das sessões, duração média das sessões ativas, sessões bloqueadas e detalhes individuais das sessões.

  • Clients: exibe informações sobre os clientes conectados à instância do Microsoft SQL Server, incluindo sessões ativas, sessões bloqueadas, usuários de BD conectados e detalhes do host do cliente.

    Para preencher os dados nessas páginas, adicione a seguinte configuração ao seu arquivo de configuração otelcol-contrib:

    receivers:
        sqlserver:
    
            events:
                db.server.query_sample:
                    enabled: true
                db.server.top_query:
                    enabled: true
    
            top_query_collection:
                lookback_time: 45s
                max_query_sample_count: 100
                top_query_count: 30
                collection_interval: 30s
    
            query_sample_collection:
                max_rows_per_query: 100

    Copiar

  Habilitar todas as esperas na guia de evento Wait

  A visualização All waits mostra o tempo de espera no nível da instância detalhado por categoria de espera e tipo de espera individual.

  Para habilitar All waits na guia Wait event da plataforma New Relic, adicione a seguinte configuração ao arquivo de configuração otelcol-contrib:

  receivers:
      sqlserver:
  
          metrics:
              sqlserver.os.wait.duration:
                  enabled: true

  Copiar

Reinicie o OpenTelemetry Collector

Reinicie o OpenTelemetry Collector para aplicar as alterações de configuração. É possível fazer isso executando o seguinte comando:

$
Restart-Service -Name "otelcol-contrib"