Monitoramento do Linux RDS MSSQL com NRDOT

Pré-requisitos

• Conta do New Relic com uma chave de licençaválida

• Endpoint OTLP da New Relic para sua região

• Requisitos do AWS RDS SQL Server:

  • AWS RDS SQL Server 2017 ou posterior
  • Nome de usuário e senha mestre do RDS
  • Grupo de segurança permitindo conexões de entrada na porta 1433 ou porta personalizada

• Requisitos do sistema Linux:

  • sqlcmd utilitário instalado no seu sistema Linux
  • Conectividade de rede para o endpoint OTLP da New Relic

Inscreva-se para visualizar

Esta integração está disponível como parte do programa de visualização pública da New Relic. Entre em contato com o gerente da sua organização para aceitar na página Previews & Trials.

Instalar o NRDOT Collector

Baixe e instale o pacote NRDOT para sua distribuição Linux. Substitua <NRDOT_VERSION> pela tag de versão mais recente da página nrdot-collector-releases.

Criar usuário de monitoramento

Execute este script como usuário root para criar o usuário de monitoramento newrelic e conceder as permissões necessárias para coletar métricas do RDS SQL Server.

1. Crie um arquivo chamado nr-grant-permission-rds.sql.

2. Cole o seguinte script SQL para criar o usuário de monitoramento newrelic e substitua <YOUR_PASSWORD> pela senha desejada:

   USE [master];
   GO
   CREATE LOGIN [newrelic] WITH PASSWORD = '<YOUR_PASSWORD>';
   GO
   -- Instance-level permissions
   GRANT VIEW SERVER STATE TO [newrelic];
   GRANT VIEW ANY DEFINITION TO [newrelic];
   GRANT VIEW ANY DATABASE TO [newrelic];
   GO
   -- Grant read access privileges to all user databases
   DECLARE @name SYSNAME;
   DECLARE db_cursor CURSOR READ_ONLY FORWARD_ONLY FOR
   SELECT [name]
   FROM [master].[sys].[databases]
   WHERE [name] NOT IN ('master', 'msdb', 'model', 'rdsadmin', 'distribution')
   AND [state] = 0; -- Only online databases
   OPEN db_cursor;
   FETCH NEXT FROM db_cursor INTO @name;
   WHILE @@FETCH_STATUS = 0
   BEGIN
     BEGIN TRY
       EXEC('USE [' + @name + '];
         IF NOT EXISTS (SELECT 1 FROM sys.database_principals WHERE name = ''newrelic'')
         BEGIN
           CREATE USER [newrelic] FOR LOGIN [newrelic];
         END;
         GRANT VIEW DATABASE STATE TO [newrelic];');
     END TRY
     BEGIN CATCH
       PRINT 'Error on ' + @name + ': ' + ERROR_MESSAGE();
     END CATCH
     FETCH NEXT FROM db_cursor INTO @name;
   END
   CLOSE db_cursor;
   DEALLOCATE db_cursor;
   GO

   Copiar

3. Execute o script usando sqlcmd. Substitua <YOUR-RDS-ENDPOINT> pelo seu endpoint do RDS e <YOUR_MASTER_PASSWORD> pela sua senha mestra:

   bash

   Copiar

   $
   sqlcmd -S <YOUR-RDS-ENDPOINT> -U <YOUR_MASTER_USER> -P '<YOUR_MASTER_PASSWORD>' -C -i nr-grant-permission-rds.sql

4. (Opcional) Verifique se o usuário foi criado com sucesso com as permissões corretas:

   bash

   Copiar

   $
   sqlcmd -S <YOUR-RDS-ENDPOINT> -U <YOUR_MASTER_USER> -P '<YOUR_MASTER_PASSWORD>' -C -Q "SELECT sp.name AS [User], p.permission_name AS [Permission_Granted] FROM sys.server_permissions p JOIN sys.server_principals sp ON p.grantee_principal_id = sp.principal_id WHERE sp.name = 'newrelic';"

   Dica

   Use seu nome de usuário e senha mestre do RDS para executar estes comandos. O script exclui automaticamente o banco de dados rdsadmin, que é reservado pela AWS. Para gerenciar informações confidenciais com segurança, como credenciais de banco de dados, armazene-as em ferramentas de gerenciamento de segredos.

Configurar o NRDOT Collector

Escolha sua opção de configuração com base nos seus requisitos de monitoramento:

1. Crie um arquivo de configuração chamado mssql-config.yaml:

   bash

   Copiar

   $
   sudo nano /etc/nrdot-collector/mssql-config.yaml

2. Adicione a seguinte configuração ao arquivo mssql-config.yaml criado na etapa anterior:

   configuração completa

   Esta configuração se concentra no monitoramento essencial de banco de dados para o seu ambiente RDS. Para habilitar o monitoramento abrangente com todas as métricas disponíveis, consulte a referência de configuração.

   Nome de usuário do banco de dados

   Insira seu nome de usuário do banco de dados para autenticação (normalmente newrelic)

   Senha do banco de dados

   Insira a senha que você definiu para o usuário newrelic

   Endpoint RDS

   Insira o endpoint do seu RDS SQL Server

   Porta do SQL Server

   Insira o número da porta do SQL Server. O valor padrão é 1433.

   Endpoint New Relic OTLP

   Insira seu endpoint OTLP da New Relic. Para obter mais informações, consulte https://docs.newrelic.com/docs/opentelemetry/best-practices/opentelemetry-otlp/

   Chave de licença da New Relic

   Insira sua chave de licença do New Relic

   mssql-config.yaml

   DownloadCopiar

   1
   receivers:
   2
   nrsqlserver:
   3
      collection_interval: 15s
   4
      # Connection details - Use your RDS endpoint
   5
      username: newrelic
   6
      password: YOUR_PASSWORD
   7
      server: mydb-instance.xxxxxxxxxxxx.us-east-1.rds.amazonaws.com
   8
      port: 1433
   9
   
   10
      # Enable comprehensive database metrics
   11
      metrics:
   12
        sqlserver.database.count:
   13
          enabled: true
   14
        sqlserver.database.io:
   15
          enabled: true
   16
        sqlserver.database.latency:
   17
          enabled: true
   18
        sqlserver.database.operations:
   19
          enabled: true
   20
        sqlserver.database.tempdb.space:
   21
          enabled: true
   22
        sqlserver.database.tempdb.version_store.size:
   23
          enabled: true
   24
        sqlserver.deadlock.rate:
   25
          enabled: true
   26
        sqlserver.os.wait.duration:
   27
          enabled: true
   28
        sqlserver.processes.blocked:
   29
          enabled: true
   30
        sqlserver.memory.grants.pending.count:
   31
          enabled: true
   32
        sqlserver.database.file.size:
   33
          enabled: true
   34
        sqlserver.memory.area:
   35
          enabled: true
   36
   
   37
      # Enable top query and query sample log collection
   38
      events:
   39
        db.server.query_sample:
   40
          enabled: true
   41
        db.server.top_query:
   42
          enabled: true
   43
   
   44
      # Top query collection configuration
   45
      top_query_collection:
   46
        lookback_time: 60s
   47
        max_query_sample_count: 1000
   48
        top_query_count: 250
   49
        collection_interval: 60s
   50
   
   51
      collect_full_query_text: true
   52
      allowed_comment_keys:
   53
        - nr_service_guid
   54
   
   55
      # Query sample collection configuration
   56
      query_sample_collection:
   57
        max_rows_per_query: 100
   58
   
   59
   processors:
   60
   memory_limiter:
   61
      check_interval: ${env:NR_MEM_LIMITER_CHECK_INTERVAL:-1s}
   62
      limit_mib:       ${env:NR_MEM_LIMITER_LIMIT_MIB:-200}
   63
      spike_limit_mib: ${env:NR_MEM_LIMITER_SPIKE_MIB:-50}
   64
   
   65
   batch:
   66
   
   67
   exporters:
   68
   otlp:
   69
      endpoint: https://otlp.nr-data.net:4318
   70
      headers:
   71
        api-key: YOUR_LICENSE_KEY
   72
      tls:
   73
        insecure: false
   74
      compression: gzip
   75
   
   76
   service:
   77
   telemetry:
   78
      metrics:
   79
        level: none
   80
   
   81
   pipelines:
   82
      metrics:
   83
        receivers: [nrsqlserver]
   84
        processors: [memory_limiter, batch]
   85
        exporters: [otlp]
   86
   
   87
      logs:
   88
        receivers: [nrsqlserver]
   89
        processors: [memory_limiter, batch]
   90
        exporters: [otlp]

Atualize a configuração do NRDOT Collector

Após configurar seu arquivo YAML com as entradas interativas acima, conclua a configuração do NRDOT Collector:

1. Edite o arquivo de configuração do serviço usando o seguinte comando:

   bash

   Copiar

   $
   sudo nano /etc/nrdot-collector/nrdot-collector.conf

2. Atualize o caminho da configuração para apontar para o novo arquivo mssql-config.yaml:

   bash

   Copiar

   $
   OTELCOL_CONFIG="/etc/nrdot-collector/mssql-config.yaml"

3. (Opcional) Valide a configuração do Collector NRDOT:

   bash

   Copiar

   $
   sudo /usr/bin/nrdot-collector validate --config=/etc/nrdot-collector/mssql-config.yaml

   Dica

   Para correlacionar o desempenho do aplicativo com as operações de banco de dados, é possível configurar a identificação de serviço de banco de dados. Para mais informações, consulte o guia de configuração de identificação de serviço de banco de dados.

Reiniciar o NRDOT Collector

Após atualizar sua configuração, reinicie o serviço NRDOT Collector:

$
sudo systemctl restart nrdot-collector

Encontre e use seus dados

Assim que seus dados estiverem sendo coletados, você poderá acessar o monitoramento abrangente do banco de dados SQL Server por meio da interface do New Relic.

Para encontrar sua entidade de banco de dados SQL Server no New Relic:

1. Vá para one.newrelic.com > All capabilities > Databases.

2. Na dropdown Entity type, selecione MSSQL instance e clique em Apply.

3. Selecione seu banco de dados SQL Server na lista de entidades.

   Após configurar o monitoramento do SQL Server com o NRDOT, você pode:

   • Crie dashboards personalizados para visualizar suas métricas de banco de dados
   • Configure alertas para limites críticos de desempenho do banco de dados
   • Explore seus dados usando os recursos de consulta do New Relic