Monitoramento do Linux RDS MSSQL com NRDOT

Visualização

Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse!

Atualmente, esse recurso é fornecido como parte de uma prévia, de acordo com nossas políticas de pré-lançamento.

Configure o monitoramento do Microsoft SQL Server usando o coletor NRDOT em ambientes Linux para monitorar instâncias do AWS RDS para SQL Server.

Pré-requisitos

Certifique-se de que seu ambiente atenda à nossa compatibilidade e pré-requisitos.

Configurar o NRDOT Collector

Instale o NRDOT Collector na sua instância de EC2 Linux ou máquina Linux local que possa se conectar à sua instância do RDS SQL Server.

Importante

Instale o NRDOT Collector em uma instância de EC2 ou máquina local que tenha conectividade de rede com a sua instância do RDS SQL Server. Certifique-se de que seu grupo de segurança permita conexões de entrada na porta 1433 (ou na sua porta personalizada).

Debian/Ubuntu
Para a arquitetura AMD64 (x86_64):
bash
```
$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_amd64.deb" --output nrdot-collector.deb && sudo dpkg -i nrdot-collector.deb
```
Para a arquitetura ARM64:
bash
```
$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_arm64.deb" --output nrdot-collector.deb && sudo dpkg -i nrdot-collector.deb
```

RHEL/CentOS

Para a arquitetura AMD64 (x86_64):

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_x86_64.rpm" --output nrdot-collector.rpm && sudo rpm -ivh nrdot-collector.rpm

Para a arquitetura ARM64:

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_arm64.rpm" --output nrdot-collector.rpm && sudo rpm -ivh nrdot-collector.rpm

Configurar usuário do banco de dados

Conecte-se à sua instância do RDS SQL Server e crie o usuário de monitoramento newrelic com as permissões apropriadas.

Crie um arquivo chamado nr-grant-permission-rds.sql na sua instância Linux com o seguinte conteúdo:
```
USE [master];
GO
CREATE LOGIN [newrelic] WITH PASSWORD = '<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'')
                CREATE USER [newrelic] FOR LOGIN [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
```
Execute o script usando suas credenciais de usuário mestre do RDS. Substitua <YOUR-RDS-ENDPOINT> pelo seu endpoint real do RDS e <Your_Master_Password> pela sua senha mestre:
bash
```
$sqlcmd -S <YOUR-RDS-ENDPOINT> -U <YOUR_MASTER_USER> -P '<Your_Master_Password>' -C -i nr-grant-permission-rds.sql
```
(Opcional) Verifique se o usuário foi criado com sucesso:
bash
```
$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
Para RDS: use seu nome de usuário e senha mestre do RDS para executar esses comandos. O script exclui automaticamente o banco de dados rdsadmin, que é reservado pela AWS.

Configurar o NRDOT Collector

Selecione o seu tipo de configuração com base nas suas necessidades de monitoramento:

Esta configuração foca no monitoramento essencial de banco de dados com métricas principais.

Crie o arquivo de configuração. O nome do arquivo deve ser mssql-config.yaml:
bash
```
$sudo nano /etc/nrdot-collector/mssql-config.yaml
```

Adicione o conteúdo de configuração abaixo ao arquivo mssql-config.yaml que você criou na etapa anterior.

receivers:
  nrsqlserver:
    collection_interval: 15s
    # Connection details - Use your RDS endpoint
    username: <YOUR_USERNAME>
    password: <YOUR_NEWRELIC_PASSWORD>
    server: <YOUR-RDS-ENDPOINT>
    port: 1433

    # 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.database.file.size:
        enabled: true
      sqlserver.memory.area:
        enabled: true

    # Enable top query and query sample log collection
    events:
      db.server.query_sample:
        enabled: true
      db.server.top_query:
        enabled: true

    # Top query collection configuration
    top_query_collection:
      lookback_time: 60s
      max_query_sample_count: 1000
      top_query_count: 250
      collection_interval: 60s

    collect_full_query_text: true
    allowed_comment_keys:
      - nr_service_guid

    # Query sample collection configuration
    query_sample_collection:
      max_rows_per_query: 100

processors:
  memory_limiter:
    check_interval: ${env:NR_MEM_LIMITER_CHECK_INTERVAL:-1s}
    limit_mib:       ${env:NR_MEM_LIMITER_LIMIT_MIB:-200}
    spike_limit_mib: ${env:NR_MEM_LIMITER_SPIKE_MIB:-50}

  batch:

exporters:
  otlphttp:
    endpoint: <YOUR_OTLP_ENDPOINT>
    headers:
      api-key: <YOUR_LICENSE_KEY>
    tls:
      insecure: false
    compression: gzip

service:
  telemetry:
    metrics:
      level: none

  pipelines:
    metrics:
      receivers: [nrsqlserver]
      processors: [memory_limiter, batch]
      exporters: [otlphttp]

    logs:
      receivers: [nrsqlserver]
      processors: [memory_limiter, batch]
      exporters: [otlphttp]

Esta configuração fornece monitoramento abrangente de banco de dados com todas as métricas disponíveis.

Crie o arquivo de configuração. O nome do arquivo deve ser mssql-config.yaml:
bash
```
$sudo nano /etc/nrdot-collector/mssql-config.yaml
```
Adicione o conteúdo de configuração abaixo ao arquivo mssql-config.yaml que você criou na etapa anterior.

Importante

Se você já é usuário do NRDOT Collector, certifique-se de mesclar a configuração com seu arquivo mssql-config.yaml existente. Isso inclui adicionar os novos receptores, processadores e exportadores para o monitoramento de banco de dados MSSQL, mantendo suas configurações atuais.

receivers:
  nrsqlserver:
    collection_interval: 15s
    username: <YOUR_USERNAME>
    password: <YOUR_PASSWORD>
    server: <YOUR-RDS-ENDPOINT>
    port: 1433

    metrics:
      # Database
      sqlserver.database.count:
        enabled: true
      sqlserver.database.file.size:
        enabled: true
      sqlserver.database.io:
        enabled: true
      sqlserver.database.latency:
        enabled: true
      sqlserver.database.operations:
        enabled: true
      sqlserver.database.page_file.size:
        enabled: true
      sqlserver.database.transactions.active:
        enabled: true
      sqlserver.database.backup_or_restore.rate:
        enabled: true
      sqlserver.database.execution.errors:
        enabled: true
      sqlserver.database.full_scan.rate:
        enabled: true
      sqlserver.database.tempdb.space:
        enabled: true
      sqlserver.database.tempdb.version_store.size:
        enabled: true
      # Security / Principals
      sqlserver.database.principals.count:
        enabled: true
      sqlserver.database.principals.old:
        enabled: true
      sqlserver.database.principals.orphaned_users:
        enabled: true
      sqlserver.database.principals.recently_created:
        enabled: true
      sqlserver.database.role.members.count:
        enabled: true
      sqlserver.database.role.memberships.count:
        enabled: true
      sqlserver.database.role.permission.risk_level:
        enabled: true
      sqlserver.database.role.roles.count:
        enabled: true
      sqlserver.database.security.role_membership.count:
        enabled: true
      sqlserver.server.security.principal.count:
        enabled: true
      sqlserver.server.security.role_membership.count:
        enabled: true
      # Locks
      sqlserver.lock.by_mode.count:
        enabled: true
      sqlserver.lock.by_resource.count:
        enabled: true
      sqlserver.lock.timeout.rate:
        enabled: true
      sqlserver.lock.wait.count:
        enabled: true
      sqlserver.lock.wait.rate:
        enabled: true
      sqlserver.deadlock.rate:
        enabled: true
      # Transactions
      sqlserver.transaction.delay:
        enabled: true
      sqlserver.transaction.mirror_write.rate:
        enabled: true
      sqlserver.transaction.longest_running_time:
        enabled: true
      sqlserver.transaction.version_cleanup.rate:
        enabled: true
      sqlserver.transaction.version_generation.rate:
        enabled: true
      # Memory
      sqlserver.memory.area:
        enabled: true
      sqlserver.memory.cache.object.count:
        enabled: true
      sqlserver.memory.grants.pending.count:
        enabled: true
      sqlserver.memory.page.count:
        enabled: true
      sqlserver.memory.target:
        enabled: true
      sqlserver.memory.usage:
        enabled: true
      # OS
      sqlserver.os.disk.size:
        enabled: true
      sqlserver.os.memory.usage:
        enabled: true
      sqlserver.os.memory.utilization:
        enabled: true
      sqlserver.os.scheduler.runnable_tasks.count:
        enabled: true
      sqlserver.os.wait.duration:
        enabled: true
      sqlserver.os.wait.tasks.count:
        enabled: true
      # Pages / Buffer
      sqlserver.page.buffer_cache.hit_ratio:
        enabled: true
      sqlserver.page.buffer_cache.free_list.stalls.rate:
        enabled: true
      sqlserver.page.life_expectancy:
        enabled: true
      sqlserver.page.lookup.rate:
        enabled: true
      # Batch / Compilation
      sqlserver.batch.request.rate:
        enabled: true
      sqlserver.batch.sql_compilation.rate:
        enabled: true
      sqlserver.batch.sql_recompilation.rate:
        enabled: true
      sqlserver.batch.compilation.utilization:
        enabled: true
      sqlserver.batch.page_split.utilization:
        enabled: true
      sqlserver.recompilation.ratio:
        enabled: true
      sqlserver.parameterization.rate:
        enabled: true
      sqlserver.plan.execution.rate:
        enabled: true
      sqlserver.attention.rate:
        enabled: true
      # Processes / Connections
      sqlserver.process.count:
        enabled: true
      sqlserver.processes.blocked:
        enabled: true
      sqlserver.user.connection.count:
        enabled: true
      sqlserver.login.rate:
        enabled: true
      sqlserver.logout.rate:
        enabled: true
      # Thread Pool
      sqlserver.thread_pool.tasks.count:
        enabled: true
      sqlserver.thread_pool.workers.count:
        enabled: true
      sqlserver.thread_pool.workers.max:
        enabled: true
      sqlserver.thread_pool.workers.utilization:
        enabled: true
      # TempDB
      sqlserver.tempdb.allocation.wait_time.total:
        enabled: true
      sqlserver.tempdb.contention.waiters.count:
        enabled: true
      sqlserver.tempdb.data_files.count:
        enabled: true
      sqlserver.tempdb.file.size:
        enabled: true
      sqlserver.tempdb.space.usage:
        enabled: true
      # Latch
      sqlserver.latch.superlatch.count:
        enabled: true
      sqlserver.latch.superlatch.transition.rate:
        enabled: true
      sqlserver.latch.wait.rate:
        enabled: true
      sqlserver.latch.wait_time.avg:
        enabled: true
      sqlserver.latch.wait_time.total:
        enabled: true
      # Index
      sqlserver.index.search.rate:
        enabled: true
      # Resource Pool
      sqlserver.resource_pool.disk.operations:
        enabled: true
      sqlserver.resource_pool.disk.throttled.read.rate:
        enabled: true
      sqlserver.resource_pool.disk.throttled.write.rate:
        enabled: true
      # Replica / Always-On
      sqlserver.replica.data.rate:
        enabled: true
      # Server Properties
      sqlserver.computer.uptime:
        enabled: true
      sqlserver.cpu.count:
        enabled: true
      # Tables
      sqlserver.table.count:
        enabled: true
      # Errors
      sqlserver.kill_connection.error.rate:
        enabled: true

    events:
      db.server.query_sample:
        enabled: true
      db.server.top_query:
        enabled: true

    top_query_collection:
      lookback_time: 60s
      max_query_sample_count: 1000
      top_query_count: 250
      collection_interval: 60s

    collect_full_query_text: true
    allowed_comment_keys:
      - nr_service_guid

    query_sample_collection:
      max_rows_per_query: 100

processors:
  memory_limiter:
    check_interval: ${env:NR_MEM_LIMITER_CHECK_INTERVAL:-1s}
    limit_mib:       ${env:NR_MEM_LIMITER_LIMIT_MIB:-500}
    spike_limit_mib: ${env:NR_MEM_LIMITER_SPIKE_MIB:-50}

  batch:


exporters:
  otlphttp:
    endpoint: https://otlp.nr-data.net:4318
    headers:
      api-key: <YOUR_LICENSE_KEY>
    tls:
      insecure: false
    compression: gzip

service:
  telemetry:
    metrics:
      level: none

  pipelines:
    metrics:
      receivers: [nrsqlserver]
      processors: [memory_limiter, batch]
      exporters: [otlphttp]

    logs:
      receivers: [nrsqlserver]
      processors: [memory_limiter, batch]
      exporters: [otlphttp]

Parâmetro de configuração

A tabela a seguir descreve os principais parâmetros de configuração para o receptor nrsqlserver:

Parâmetro	Descrição
`<YOUR_USERNAME>`	Insira seu nome de usuário do banco de dados para autenticação
`<YOUR_NEWRELIC_PASSWORD>`	A senha que você definiu para o usuário newrelic
`<YOUR-RDS-ENDPOINT>`	Seu endpoint do RDS SQL Server (por exemplo, `mydb-instance.xxxxxxxxxxxx.us-east-1.rds.amazonaws.com`)
`port`	Insira o número da porta do SQL Server. O valor padrão é 1433.
`<YOUR_OTLP_ENDPOINT>`	Insira o endpoint OTLP da New Relic. Para mais informações, consulte a documentação dos endpoints OTLP da New Relic.
`<YOUR_LICENSE_KEY>`	Insira sua chave de licença do New Relic.

Dica

Nota: a opção max_concurrent_queries controla quantas consultas de métrica o receiver executa em paralelo no SQL Server durante cada ciclo de scrape.

receivers:
  nrsqlserver:
    max_concurrent_queries: 4  # default is 4 if omitted or set to 0

Dica

Observação: se você habilitar todas as métricas disponíveis, aumente o valor de limit_mib (por exemplo, 1.000) para evitar que o limitador de memória descarte dados.

Atualize o arquivo de configuração do coletor

Execute o seguinte comando para editar a configuração do serviço:
bash
```
$sudo nano /etc/nrdot-collector/nrdot-collector.conf
```
Atualize o caminho da configuração para apontar para o seu novo arquivo mssql-config.yaml:
bash
```
$OTELCOL_CONFIG="/etc/nrdot-collector/mssql-config.yaml"
```

Validar a configuração do NRDOT Collector

Valide a configuração do Collector NRDOT para garantir que esteja formatada corretamente e funcione de maneira adequada.

bash

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

Reiniciar o coletor NRDOT

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

bash

$sudo systemctl restart nrdot-collector

Dica

Sempre reinicie o serviço do coletor NRDOT após fazer alterações na configuração para garantir que as novas configurações entrem em vigor.

Próximos passos

Após configurar o monitoramento do Linux RDS:

Esta tradução de máquina é fornecida para sua comodidade.

Monitoramento do Linux RDS MSSQL com NRDOT

Visualização

Pré-requisitos

Configurar o NRDOT Collector

Importante

Configurar usuário do banco de dados

Dica

Configurar o NRDOT Collector

Configuração padrão

Configuração com todos os recursos

Importante

Parâmetro de configuração

Dica

Dica

Atualize o arquivo de configuração do coletor

Validar a configuração do NRDOT Collector

Reiniciar o coletor NRDOT

Dica

Próximos passos

Esta tradução de máquina é fornecida para sua comodidade.

Monitoramento do Linux RDS MSSQL com NRDOT

Visualização

Pré-requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}

Configurar o NRDOT Collector

Importante

Configurar usuário do banco de dados

Dica

Configurar o NRDOT Collector

Configuração com todos os recursos

Parâmetro de configuração

Dica

Dica

Atualize o arquivo de configuração do coletor

Validar a configuração do NRDOT Collector

Reiniciar o coletor NRDOT

Dica

Próximos passos

Pré-requisitos