Windows RDS에서 MSSQL용 NRDOT 설치 & 구성: 도메인 인증

전제 조건

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

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

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

• SQL Server 요구 사항:

  • Amazon RDS의 SQL Server 2017 이상.
  • RDS 마스터 사용자 자격 증명 또는 rds_superuser 역할을 가진 SQL Server 로그인을 위한 자격 증명
  • 포트 1433 또는 사용자 지정 포트에서 연결을 허용하도록 구성된 RDS 보안 그룹
  • SQL Server Management Studio(SSMS) 또는 sqlcmd 유틸리티.
  • AWS Active Directory 서비스와 연결된 RDS 인스턴스.

• Windows 도메인 인증 요구 사항:

  • Active Directory가 있는 Windows 도메인 환경.
  • 도메인에 가입된 Windows EC2 인스턴스.
  • Windows 인증을 허용하도록 구성된 RDS SQL Server.
  • NRDOT Collector가 사용할 도메인 사용자 계정입니다.

• AWS RDS 콘솔의 연결 및 보안(Connectivity & security)에서 찾을 수 있는 RDS SQL Server 엔드포인트 URL입니다. 자세한 내용은 AWS RDS 문서를 참조하십시오.

NRDOT Collector설치하세요

동일한 도메인의 일부이며 RDS SQL Server 인스턴스에 연결할 수 있는 도메인에 가입된 EC2 Windows 인스턴스 또는 로컬 Windows 머신에 NRDOT Collector를 설치합니다.

1. 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

Windows 도메인 로그인 생성

관리자 권한으로 SQL Server Management Studio(SSMS) 또는 sqlcmd을(를) 사용하여 RDS SQL Server 인스턴스에 연결하십시오.

SQL Server Management Studio(SSMS)에서 다음 스크립트를 실행하여 gMSA 계정에 대한 로그인을 생성하고 필요한 권한을 부여하십시오. 모든 <YOUR_DOMAIN>\<YOUR_DOMAIN_USER>을(를) 실제 도메인 및 계정 이름으로 바꾸십시오.

USE [master];
GO

CREATE LOGIN [<YOUR_DOMAIN>\<YOUR_DOMAIN_USER>] FROM WINDOWS;
GO

GRANT VIEW ANY DATABASE   TO [<YOUR_DOMAIN>\<YOUR_DOMAIN_USER>];
GRANT VIEW SERVER STATE TO [<YOUR_DOMAIN>\<YOUR_DOMAIN_USER>];
GRANT VIEW ANY DEFINITION TO [<YOUR_DOMAIN>\<YOUR_DOMAIN_USER>];
GO

-- Grant access to all databases (required for query monitoring and tempdb metrics)
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 = ''<YOUR_DOMAIN>\<YOUR_DOMAIN_USER>'')
    BEGIN
      CREATE USER [<YOUR_DOMAIN>\<YOUR_DOMAIN_USER>] FOR LOGIN [<YOUR_DOMAIN>\<YOUR_DOMAIN_USER>];
    END;
    GRANT VIEW DATABASE STATE TO [<YOUR_DOMAIN>\<YOUR_DOMAIN_USER>];');
  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

도메인 사용자로 실행

1. PowerShell을 사용하여 도메인 사용자로 실행되도록 NRDOT Collector 서비스를 구성하십시오. YOUR_DOMAIN\YOUR_USER_ACCOUNT을 도메인 및 계정 이름으로 바꾸십시오:

   # Configure service to use domain account
   # The space after obj= and password= is required syntax for sc.exe
   sc.exe config "nrdot-collector" obj= "YOUR_DOMAIN\YOUR_USER_ACCOUNT" password= "<YOUR_PASSWORD>"
   
   # Restart the service
   Restart-Service nrdot-collector

   카피

2. 서비스 ID를 검증하십시오:

   Get-WmiObject Win32_Service -Filter "Name='nrdot-collector'" | Select Name, State, StartName
   # Expected: StartName = YOUR_DOMAIN\YOUR_USER_ACCOUNT

   카피

NRDOT Collector구성

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

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

   카피

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

1
receivers:
2
nrsqlserver:
3
   collection_interval: 15s
4
   datasource: "server=mydb-instance.xxxxxxxxxxxx.us-east-1.rds.amazonaws.com;port=1433;integrated security=true;encrypt=true;TrustServerCertificate=true;"
5

6
   # Enable comprehensive database metrics
7
   metrics:
8
     sqlserver.database.count:
9
       enabled: true
10
     sqlserver.database.io:
11
       enabled: true
12
     sqlserver.database.latency:
13
       enabled: true
14
     sqlserver.database.operations:
15
       enabled: true
16
     sqlserver.database.tempdb.space:
17
       enabled: true
18
     sqlserver.database.tempdb.version_store.size:
19
       enabled: true
20
     sqlserver.deadlock.rate:
21
       enabled: true
22
     sqlserver.os.wait.duration:
23
       enabled: true
24
     sqlserver.processes.blocked:
25
       enabled: true
26
     sqlserver.memory.grants.pending.count:
27
       enabled: true
28
     sqlserver.database.file.size:
29
       enabled: true
30
     sqlserver.memory.area:
31
       enabled: true
32

33
   # Enable query sample, top query, query plan, and top procedure log collection
34
   events:
35
     db.server.query_sample:
36
       enabled: true
37
     db.server.top_query:
38
       enabled: true
39
     db.server.query_plan:
40
       enabled: true
41
     db.server.top_procedure:
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
     collect_full_query_text: true
51
     allowed_comment_keys:
52
       - nr_service_guid
53

54
   # Query sample collection configuration
55
   query_sample_collection:
56
     max_rows_per_query: 100
57
     collect_full_query_text: true
58
     allowed_comment_keys:
59
       - nr_service_guid
60

61
   # Top stored procedure collection configuration
62
   top_procedure_collection:
63
     max_procedure_sample_count: 1000
64
     top_procedure_count: 250
65
     collection_interval: 60s
66

67
   resource_attributes:
68
     db.system.version:
69
       enabled: true
70
     sqlserver.db.edition:
71
       enabled: true
72

73
processors:
74
memory_limiter:
75
   check_interval: ${env:NR_MEM_LIMITER_CHECK_INTERVAL:-1s}
76
   limit_mib:       ${env:NR_MEM_LIMITER_LIMIT_MIB:-200}
77
   spike_limit_mib: ${env:NR_MEM_LIMITER_SPIKE_MIB:-50}
78

79
exporters:
80
otlp:
81
   endpoint: https://otlp.nr-data.net:4318
82
   headers:
83
     api-key: YOUR_LICENSE_KEY
84
   tls:
85
     insecure: false
86
   compression: gzip
87

88
   sending_queue:
89
     enabled: true
90
     sizer: bytes
91
     queue_size: 100_000_000
92
     num_consumers: 10
93
     batch:
94
       sizer: bytes
95
       max_size: 1_000_000
96
       min_size: 0
97
       flush_timeout: 5s
98

99
service:
100
telemetry:
101
   metrics:
102
     level: none
103

104
pipelines:
105
   metrics:
106
     receivers: [nrsqlserver]
107
     processors: [memory_limiter]
108
     exporters: [otlp]
109

110
   logs:
111
     receivers: [nrsqlserver]
112
     processors: [memory_limiter]
113
     exporters: [otlp]

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

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

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

     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

Windows 서비스(services.msc)를 확인하여 서비스가 도메인 계정으로 실행 중인지 확인하십시오. Log On As 열에 도메인 계정이 표시되어야 합니다. 예를 들어, CORP\SQLMonitor입니다.

데이터 찾기 및 사용

데이터가 수집되면 뉴렐릭 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 모니터링을 설정한 후 다음을 수행할 수 있습니다:

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