Windows RDS의 MSSQL용 NRDOT 설치 및 구성: gMSA 인증

그룹 관리 서비스 계정(gMSA)을 사용하여 AWS RDS for SQL Server 인스턴스를 모니터하려면 Windows 환경에서 NRDOT Collector를 사용하여 Microsoft SQL Server 모니터링을 설정하십시오. 자체 호스팅 환경에서 모니터하려면 Windows 자체 호스팅 계측을 참조하십시오.

대신 뉴렐릭 UI를 통해 설치하려면 one.newrelic.com > Integrations & Agents > MSSQL (OpenTelemetry) (으)로 이동하십시오. 화면의 지시에 따라 통합을 설정하십시오. 이 페이지에서는 수동 설치만 다룹니다.

이 페이지에서는 gMSA 인증을 다룹니다. 환경에서 다른 인증 방법을 사용하는 경우 SQL Server 인증 또는 Windows 도메인 인증을 참조하십시오.

전제 조건

gMSA 인증을 사용하여 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 인스턴스.
AWS RDS 콘솔의 연결 및 보안(Connectivity & security)에서 찾을 수 있는 RDS SQL Server 엔드포인트 URL입니다. 자세한 내용은 AWS RDS 문서를 참조하십시오.
gMSA를 지원하는 Active Directory 환경.
gMSA 계정을 사용하도록 권한이 부여된 도메인 가입 Windows EC2 인스턴스

NRDOT Collector설치하세요

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

bash

$[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

모니터링 사용자 생성

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

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

USE [master];
GO

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

GRANT VIEW ANY DATABASE TO [<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$];
GRANT VIEW SERVER STATE TO [<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$];
GRANT VIEW ANY DEFINITION TO [<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$];
GO
-- Grant access to all 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;
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_GMSA_USERNAME>$'')
    BEGIN
      CREATE USER [<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$] FOR LOGIN [<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$];
    END;
    GRANT VIEW DATABASE STATE TO [<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$];');
  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

팁

데이터베이스 자격 증명과 같은 민감한 정보를 안전하게 관리하려면 시크릿 관리 도구에 저장하십시오.

gMSA 계정으로 실행

PowerShell을 사용하여 gMSA 계정으로 실행되도록 NRDOT Collector 서비스를 설정하십시오. <YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$을(를) 도메인 및 gMSA 계정 이름으로 교체하십시오. gMSA 계정에 필요하므로 끝에 $을(를) 포함해야 합니다:

bash

$# Stop the NRDOT Collector service
$Stop-Service nrdot-collector
$
$# Configure service to use gMSA account
$# Use cmd /c to avoid PowerShell treating $ as a variable
$cmd /c 'sc config nrdot-collector obj= "<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$" password= ""'
$
$# Verify the configuration
$Get-WmiObject Win32_Service -Filter "Name='nrdot-collector'" | Select Name, StartName
$
$# Start the NRDOT Collector service 
$Start-Service nrdot-collector

중요

gMSA 계정은 비밀번호가 필요하지 않습니다. 서비스를 구성할 때 비워 두십시오.

NRDOT Collector구성

관리자 권한으로 PowerShell에서 이름이 mssql-config.yaml 인 설정 파일을 생성하십시오:
bash
```
$New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```
이전 단계에서 생성한 mssql-config.yaml 파일에 다음 설정을 추가하십시오:
전체 설정
이 설정은 RDS 환경을 위한 필수 데이터베이스 모니터링에 중점을 둡니다. 사용 가능한 모든 메트릭을 사용하여 포괄적인 모니터링을 활성화하려면 설정 참조를 참조하십시오.
RDS 엔드포인트
RDS SQL Server 엔드포인트를 입력하세요
RDS 포트
RDS SQL Server 포트 번호를 입력하십시오. 기본값은 1433입니다.
포트 번호가 포함된 뉴렐릭 OTLP 엔드포인트
뉴렐릭 OTLP 엔드포인트를 입력하십시오. 자세한 내용은 https://docs.newrelic.com/docs/opentelemetry/best-practices/opentelemetry-otlp/를 참조하십시오.
뉴렐릭 라이선스 키
뉴렐릭 라이선스 키를 입력하십시오.
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]

팁

logs 파이프라인은 수집기 디버그 또는 내부 에이전트 로그를 전달하지 않습니다. 이는 쿼리 텍스트, 실행 계획 및 샘플 데이터를 포함한 SQL Server 쿼리 텔레메트리를 전송합니다. nrsqlserver 수신기는 OpenTelemetry 로그 레코드로 발생하는 db.server.query_sample, db.server.top_query, db.server.query_plan 및 db.server.top_procedure 이벤트를 통해 이 텔레메트리를 캡처합니다.
db.server.top_procedure 이벤트에는 sys.dm_exec_procedure_stats.total_spills에 대한 지원이 도입된 SQL Server 2017 CU3 이상이 필요합니다. 이전 버전에서는 이 이벤트가 데이터를 내보내지 않고 오류를 로그에 기록합니다. 다른 이벤트는 영향을 받지 않습니다. sys.dm_exec_procedure_stats에 액세스하려면 VIEW SERVER STATE (또는 SQL Server 버전에 따라 VIEW SERVER PERFORMANCE STATE)이(가) 필요합니다. 또한 모든 사용자 데이터베이스에서 OBJECT_NAME 및 OBJECT_SCHEMA_NAME이(가) 올바르게 확인되려면 VIEW ANY DEFINITION이(가) 필요하며, 초기 세션을 설정하려면 CONNECT SQL이(가) 필요합니다. 모니터링 사용자 생성에서 생성된 gMSA 로그인에는 이미 3개의 권한이 모두 있습니다.

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

다음 방법 중 하나를 사용하여 새 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\""
```
NRDOT Collector 설정을 검증하여 형식이 올바르고 제대로 작동하는지 확인합니다:
bash
```
$& "C:\Program Files\nrdot-collector\nrdot-collector.exe" validate --config="C:\Program Files\nrdot-collector\mssql-config.yaml"
```
팁
애플리케이션 성능을 데이터베이스 작업과 연관시키려면 데이터베이스 서비스 식별을 설정할 수 있습니다. 자세한 내용은 데이터베이스 서비스 식별 설정을 참조하십시오.

NRDOT Collector를 다시 시작하십시오

설정을 업데이트한 후, 도메인에 가입된 EC2 Windows 인스턴스에서 NRDOT Collector 서비스를 다시 시작하세요:

bash

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

Windows 서비스(services.msc)를 확인하여 서비스가 gMSA 계정으로 실행 중인지 확인하십시오. Log On As 열에 gMSA 계정이 표시되어야 합니다(예: CORP\SQL-gMSA$).

데이터 찾기 및 사용

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

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

https://one.newrelic.com > All Capabilities > Databases 으)로 이동합니다.
Entity type 드롭다운 메뉴에서 MSSQL instance을(를) 선택한 다음 Apply을(를) 클릭합니다.
모임 목록에서 SQL Server 데이터베이스를 선택합니다.
NRDOT로 SQL Server 모니터링을 설정한 후 다음을 수행할 수 있습니다:
- 사용자 정의 대시보드를 만들어 데이터베이스 지표를 시각화하세요.
- 중요한 데이터베이스 성능에 대한 알림 설정, 참조 값
- 뉴렐릭 쿼리 기능을 사용하여 데이터 탐색

APM-데이터베이스 상관관계 설정

뉴렐릭에서 애플리케이션 성능을 데이터베이스 작업과 연관시키는 방법을 알아보십시오.

문제점 해결

뉴렐릭에서 MSSQL Windows 모니터링 설정 문제를 해결하는 방법을 알아보십시오.

지표 참조

NRDOT Collector가 수집하는 사용 가능한 메트릭에 대해 알아보십시오.

사용자의 편의를 위해 제공되는 기계 번역입니다.

Windows RDS의 MSSQL용 NRDOT 설치 및 구성: gMSA 인증

전제 조건 .css-21sua1{background:none;border:none;width:0;padding:0;}

NRDOT Collector설치하세요

모니터링 사용자 생성

팁

gMSA 계정으로 실행

중요

NRDOT Collector구성

전체 설정

팁

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

팁

NRDOT Collector를 다시 시작하십시오

데이터 찾기 및 사용

관련 문서

APM-데이터베이스 상관관계 설정

문제점 해결

지표 참조

전제 조건