Linux RDS를 사용한 MSSQL 모니터링을 위한 NRDOT 설치 및 구성

전제 조건

• 유효한 라이선스 키가 있는 뉴렐릭 계정.

• 해당 리전의 뉴렐릭 OTLP 엔드포인트에 대한 네트워크 연결.

• AWS RDS SQL Server 요구 사항:

  • AWS RDS SQL Server 2017 이상.
  • RDS 마스터 사용자 이름 및 비밀번호.
  • 포트 1433 또는 사용자 지정 포트에서 인바운드 연결을 허용하는 보안 그룹

• Linux 시스템 요구사항:

  • Linux 시스템에 설치된 sqlcmd 유틸리티입니다.

NRDOT Collector설치하세요

Linux 배포판용 NRDOT 패키지를 다운로드하고 설치하십시오. <NRDOT_VERSION>을(를) nrdot-collector-releases 페이지의 최신 릴리스 태그로 교체하십시오.

모니터링 사용자 생성

루트 사용자로 이 스크립트를 실행하여 newrelic 모니터링 사용자를 생성하고 RDS SQL Server 메트릭을 수집하는 데 필요한 권한을 부여하십시오.

1. nr-grant-permission-rds.sql이라는 이름의 파일을 생성하십시오.

2. 다음 SQL 스크립트를 붙여넣어 newrelic 모니터링 사용자를 생성하고 <YOUR_PASSWORD>을(를) 원하는 비밀번호로 변경하십시오:

   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

   카피

3. 로그인을 생성하고 서버 수준 권한을 부여할 수 있는 권한을 가진 로그인(예: sa 로그인 또는 sysadmin 역할을 가진 다른 계정)으로 sqlcmd을(를) 사용하여 스크립트를 실행하십시오. <YOUR-RDS-ENDPOINT>을(를) RDS 엔드포인트로, <YOUR_MASTER_PASSWORD>을(를) 마스터 비밀번호로 바꾸십시오:

   bash

   카피

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

4. (선택 사항) 올바른 권한으로 사용자가 성공적으로 생성되었는지 확인하십시오:

   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';"

NRDOT Collector구성

모니터링 요구 사항에 따라 설정 옵션을 선택하십시오:

1. mssql-config.yaml이라는 이름의 설정 파일을 생성합니다:

   bash

   카피

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

2. 이전 단계에서 생성한 mssql-config.yaml 파일에 다음 설정을 추가하십시오:

   전체 설정

   이 설정은 RDS 환경을 위한 필수 데이터베이스 모니터링에 중점을 둡니다. 사용 가능한 모든 메트릭으로 포괄적인 모니터링을 활성화하려면 설정 참조를 확인하십시오.

   데이터베이스 사용자 이름

   인증을 위한 데이터베이스 사용자 이름을 입력하십시오(일반적으로 newrelic)

   데이터베이스 비밀번호

   newrelic 사용자에 대해 설정한 비밀번호를 입력하십시오.

   RDS 엔드포인트

   RDS SQL Server 엔드포인트를 입력하세요

   SQL Server 포트

   SQL Server 포트 번호를 입력합니다. 기본값은 1433입니다.

   포트 번호가 포함된 뉴렐릭 OTLP 엔드포인트

   뉴렐릭 OTLP 엔드포인트를 입력하십시오. 자세한 내용은 https://docs.newrelic.com/docs/opentelemetry/best-practices/opentelemetry-otlp/를 참조하십시오.

   뉴렐릭 라이선스 키

   뉴렐릭 라이선스 키를 입력하십시오.

   mssql-config.yaml

   Download카피

   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 query sample, top query, query plan, and top procedure log collection
   38
      events:
   39
        db.server.query_sample:
   40
          enabled: true
   41
        db.server.top_query:
   42
          enabled: true
   43
        db.server.query_plan:
   44
          enabled: true
   45
        db.server.top_procedure:
   46
          enabled: true
   47
   
   48
      # Top query collection configuration
   49
      top_query_collection:
   50
        lookback_time: 60s
   51
        max_query_sample_count: 1000
   52
        top_query_count: 250
   53
        collection_interval: 60s
   54
        collect_full_query_text: true
   55
        allowed_comment_keys:
   56
          - nr_service_guid
   57
   
   58
      # Query sample collection configuration
   59
      query_sample_collection:
   60
        max_rows_per_query: 100
   61
        collect_full_query_text: true
   62
        allowed_comment_keys:
   63
          - nr_service_guid
   64
   
   65
      # Top stored procedure collection configuration
   66
      top_procedure_collection:
   67
        max_procedure_sample_count: 1000
   68
        top_procedure_count: 250
   69
        collection_interval: 60s
   70
   
   71
      resource_attributes:
   72
        db.system.version:
   73
          enabled: true
   74
        sqlserver.db.edition:
   75
          enabled: true
   76
   
   77
   processors:
   78
   memory_limiter:
   79
      check_interval: ${env:NR_MEM_LIMITER_CHECK_INTERVAL:-1s}
   80
      limit_mib:       ${env:NR_MEM_LIMITER_LIMIT_MIB:-200}
   81
      spike_limit_mib: ${env:NR_MEM_LIMITER_SPIKE_MIB:-50}
   82
   
   83
   exporters:
   84
   otlp:
   85
      endpoint: https://otlp.nr-data.net:4318
   86
      headers:
   87
        api-key: YOUR_LICENSE_KEY
   88
      tls:
   89
        insecure: false
   90
      compression: gzip
   91
   
   92
      sending_queue:
   93
        enabled: true
   94
        sizer: bytes
   95
        queue_size: 100_000_000
   96
        num_consumers: 10
   97
        batch:
   98
          sizer: bytes
   99
          max_size: 1_000_000
   100
          min_size: 0
   101
          flush_timeout: 5s
   102
   
   103
   service:
   104
   telemetry:
   105
      metrics:
   106
        level: none
   107
   
   108
   pipelines:
   109
      metrics:
   110
        receivers: [nrsqlserver]
   111
        processors: [memory_limiter]
   112
        exporters: [otlp]
   113
   
   114
      logs:
   115
        receivers: [nrsqlserver]
   116
        processors: [memory_limiter]
   117
        exporters: [otlp]

NRDOT Collector 설정 업데이트

위의 대화형 입력으로 YAML 파일을 구성한 후, NRDOT Collector 설정을 완료하십시오:

1. 다음 명령을 사용하여 서비스 설정 파일을 편집합니다:

   bash

   카피

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

2. 새 mssql-config.yaml 파일을 가리키도록 설정 경로를 업데이트하십시오:

   bash

   카피

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

3. (선택 사항) NRDOT Collector 설정을 확인하십시오:

   bash

   카피

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

   팁

   애플리케이션 성능을 데이터베이스 작업과 연관시키려면 데이터베이스 서비스 식별을 설정할 수 있습니다. 자세한 내용은 데이터베이스 서비스 식별 설정 가이드를 참조하십시오.

NRDOT Collector를 다시 시작하십시오

설정을 업데이트한 후 NRDOT Collector 서비스를 다시 시작하십시오:

$
sudo systemctl restart nrdot-collector

데이터 찾기 및 사용

데이터가 수집되면 뉴렐릭 UI를 통해 포괄적인 SQL Server 데이터베이스 모니터링에 액세스할 수 있습니다.

뉴렐릭에서 SQL Server 데이터베이스를 찾으려면 다음을 수행하세요.

1. one.newrelic.com > All capabilities > Databases 으)로 이동합니다.

2. Entity type 드롭다운 메뉴에서 MSSQL instance을(를) 선택한 다음 Apply을(를) 클릭합니다.

3. 모임 목록에서 SQL Server 데이터베이스를 선택합니다.

   NRDOT로 SQL Server 모니터링을 설정한 후 다음을 수행할 수 있습니다:

   • 사용자 정의 대시보드를 만들어 데이터베이스 지표를 시각화하세요.
   • 중요한 데이터베이스 성능에 대한 알림 설정, 참조 값
   • 뉴렐릭 쿼리 기능을 사용하여 데이터 탐색