Windows 자체 호스팅의 MSSQL용 NRDOT 설치 및 구성: SQL 인증

전제 조건

NRDOT로 Microsoft SQL Server를 모니터링하기 전에 환경이 다음 요구 사항을 충족하는지 확인하십시오:

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

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

• SQL Server 요구 사항:

  • SQL Server 2017 이상.
  • SQL Server에 대한 관리자 액세스 권한(sysadmin 역할 또는 동등한 권한).
  • 포트 1433 또는 사용자 지정 포트에서 수집기와 SQL Server 간의 네트워크 연결.
  • SQL Server Management Studio(SSMS) 또는 sqlcmd 유틸리티.
  • Windows 도메인 또는 SQL Server 인증.

NRDOT Collector설치하세요

PowerShell을 사용하여 NRDOT Collector를 다운로드하고 설치합니다:

$
[Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; $NRDOT_VERSION = (Invoke-RestMethod -Uri "https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest").tag_name; $WebClient = New-Object System.Net.WebClient; $WebClient.Headers.Add("User-Agent", "Mozilla/5.0"); $WebClient.DownloadFile("https://github.com/newrelic/nrdot-collector-releases/releases/download/$NRDOT_VERSION/nrdot-collector_${NRDOT_VERSION}_windows_x64.msi", "$env:TEMP\nrdot-collector.msi"); Start-Process msiexec.exe -ArgumentList "/i `"$env:TEMP\nrdot-collector.msi`" /qn /norestart /L*V `"$env:TEMP\nrdot_install.log`"" -Wait; Get-Service nrdot-collector -ErrorAction SilentlyContinue

모니터링 사용자 생성

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

SQL Server Management Studio(SSMS)에서 다음 스크립트를 실행하여 newrelic 모니터링 사용자를 생성하십시오. <YOUR_PASSWORD>을(를) 원하는 비밀번호로 교체하십시오:

USE [master];
GO
CREATE LOGIN [newrelic] WITH PASSWORD = '<YOUR_PASSWORD>';
GO

GRANT VIEW SERVER STATE TO [newrelic];
GRANT VIEW ANY DEFINITION TO [newrelic];
GRANT VIEW ANY DATABASE TO [newrelic];
GO

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

NRDOT Collector구성

1. 관리자 권한으로 PowerShell에서 mssql-config.yaml (으)로 명명된 설정 파일을 생성하십시오:

   bash

   카피

   $
   New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File

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

   전체 설정

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

   SQL Server 사용자 이름

   SQL Server 사용자 이름을 입력합니다

   SQL Server 비밀번호

   SQL Server 비밀번호를 입력하십시오.

   서버 호스트명/IP

   SQL Server 호스트명 또는 IP 주소를 입력하십시오.

   서버 포트

   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
      username: newrelic
   5
      password: YOUR_PASSWORD
   6
      server: sqlserver.example.com
   7
      port: 1433
   8
   
   9
      # Enable comprehensive database metrics
   10
      metrics:
   11
        sqlserver.database.count:
   12
          enabled: true
   13
        sqlserver.database.io:
   14
          enabled: true
   15
        sqlserver.database.latency:
   16
          enabled: true
   17
        sqlserver.database.operations:
   18
          enabled: true
   19
        sqlserver.database.tempdb.space:
   20
          enabled: true
   21
        sqlserver.database.tempdb.version_store.size:
   22
          enabled: true
   23
        sqlserver.deadlock.rate:
   24
          enabled: true
   25
        sqlserver.os.wait.duration:
   26
          enabled: true
   27
        sqlserver.processes.blocked:
   28
          enabled: true
   29
        sqlserver.memory.grants.pending.count:
   30
          enabled: true
   31
        sqlserver.database.file.size:
   32
          enabled: true
   33
        sqlserver.memory.area:
   34
          enabled: true
   35
   
   36
      # Enable query sample, top query, query plan, and top procedure log collection
   37
      events:
   38
        db.server.query_sample:
   39
          enabled: true
   40
        db.server.top_query:
   41
          enabled: true
   42
        db.server.query_plan:
   43
          enabled: true
   44
        db.server.top_procedure:
   45
          enabled: true
   46
   
   47
      # Top query collection configuration
   48
      top_query_collection:
   49
        lookback_time: 60s
   50
        max_query_sample_count: 1000
   51
        top_query_count: 250
   52
        collection_interval: 60s
   53
        collect_full_query_text: true
   54
        allowed_comment_keys:
   55
          - nr_service_guid
   56
   
   57
      # Query sample collection configuration
   58
      query_sample_collection:
   59
        max_rows_per_query: 100
   60
        collect_full_query_text: true
   61
        allowed_comment_keys:
   62
          - nr_service_guid
   63
   
   64
      # Top stored procedure collection configuration
   65
      top_procedure_collection:
   66
        max_procedure_sample_count: 1000
   67
        top_procedure_count: 250
   68
        collection_interval: 60s
   69
   
   70
      resource_attributes:
   71
        db.system.version:
   72
          enabled: true
   73
        sqlserver.db.edition:
   74
          enabled: true
   75
   
   76
   processors:
   77
   memory_limiter:
   78
      check_interval: ${env:NR_MEM_LIMITER_CHECK_INTERVAL:-1s}
   79
      limit_mib:       ${env:NR_MEM_LIMITER_LIMIT_MIB:-200}
   80
      spike_limit_mib: ${env:NR_MEM_LIMITER_SPIKE_MIB:-50}
   81
   
   82
   exporters:
   83
   otlp:
   84
      endpoint: https://otlp.nr-data.net:4318
   85
      headers:
   86
        api-key: YOUR_LICENSE_KEY
   87
      tls:
   88
        insecure: false
   89
      compression: gzip
   90
   
   91
      sending_queue:
   92
        enabled: true
   93
        sizer: bytes
   94
        queue_size: 100_000_000
   95
        num_consumers: 10
   96
        batch:
   97
          sizer: bytes
   98
          max_size: 1_000_000
   99
          min_size: 0
   100
          flush_timeout: 5s
   101
   
   102
   service:
   103
   telemetry:
   104
      metrics:
   105
        level: none
   106
   
   107
   pipelines:
   108
      metrics:
   109
        receivers: [nrsqlserver]
   110
        processors: [memory_limiter]
   111
        exporters: [otlp]
   112
   
   113
      logs:
   114
        receivers: [nrsqlserver]
   115
        processors: [memory_limiter]
   116
        exporters: [otlp]

Windows 서비스 레지스트리 업데이트

1. 다음 방법 중 하나를 사용하여 새 mssql-config.yaml 파일을 사용하도록 Windows 서비스 레지스트리를 업데이트하십시오:

   • PowerShell의 경우: 다음 명령을 관리자 권한으로 실행하십시오:

     bash

     카피

     $
     Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Services\nrdot-collector" -Name "ImagePath" -Value '"C:\Program Files\nrdot-collector\nrdot-collector.exe" --config "C:\Program Files\nrdot-collector\mssql-config.yaml"'

   • 명령 프롬프트의 경우: PowerShell을 사용할 수 없는 경우 명령 프롬프트를 대신 사용하고 다음 명령을 관리자로 실행하십시오:

   bash

   카피

   $
   sc config "nrdot-collector" binPath= "\"C:\Program Files\nrdot-collector\nrdot-collector.exe\" --config \"C:\Program Files\nrdot-collector\mssql-config.yaml\""

2. NRDOT Collector 설정의 유효성을 검사하여 형식이 올바르고 제대로 작동하는지 확인합니다.

   bash

   카피

   $
   & "C:\Program Files\nrdot-collector\nrdot-collector.exe" validate --config="C:\Program Files\nrdot-collector\mssql-config.yaml"

   팁

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

NRDOT Collector를 다시 시작하십시오

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

$
net stop nrdot-collector
$
net start nrdot-collector

데이터 찾기 및 사용

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

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

1. https://one.newrelic.com > All Capabilities > Databases 으)로 이동합니다.

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

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

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

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