NRDOT를 사용한 Windows 자체 호스팅 MSSQL 모니터링

시사

이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다!

이 기능은 현재 사전 출시 정책 에 따라 미리보기의 일부로 제공됩니다.

물리적 서버, 가상 머신 및 독립 실행형 Windows 설치를 포함한 Windows 자체 호스팅 환경에서 NRDOT Collector를 사용하여 Microsoft SQL Server 모니터링을 설정하십시오. Windows RDS 환경에서 모니터링하려면 Windows RDS 계측을 참조하십시오.

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

SQL Server 보안 설정에 따라 세 가지 인증 방법 중 하나를 선택하여 NRDOT Collector를 SQL Server 인스턴스에 연결할 수 있습니다:

전제 조건

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 인증
뉴렐릭 OTLP 엔드포인트에 대한 네트워크 연결

미리보기에 등록하십시오

이 통합은 뉴렐릭 공개 프리뷰 프로그램의 일환으로 제공됩니다. Previews & Trials 페이지에서 옵트인하려면 조직 관리자에게 문의하십시오.

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

모니터링 사용자 생성

이 스크립트를 루트 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구성

관리자 권한으로 PowerShell에서 mssql-config.yaml (으)로 명명된 설정 파일을 생성하십시오:
bash
```
$New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```
다음 설정에 환경별 값을 추가하고 이전 단계에서 생성한 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
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 top query and query sample log collection 37 events: 38 db.server.query_sample: 39 enabled: true 40 db.server.top_query: 41 enabled: true 42 43 # Top query collection configuration 44 top_query_collection: 45 lookback_time: 60s 46 max_query_sample_count: 1000 47 top_query_count: 250 48 collection_interval: 60s 49 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 58 processors: 59 memory_limiter: 60 check_interval: ${env:NR_MEM_LIMITER_CHECK_INTERVAL:-1s} 61 limit_mib: ${env:NR_MEM_LIMITER_LIMIT_MIB:-200} 62 spike_limit_mib: ${env:NR_MEM_LIMITER_SPIKE_MIB:-50} 63 64 batch: 65 66 exporters: 67 otlp: 68 endpoint: https://otlp.nr-data.net:4318 69 headers: 70 api-key: YOUR_LICENSE_KEY 71 tls: 72 insecure: false 73 compression: gzip 74 75 service: 76 telemetry: 77 metrics: 78 level: none 79 80 pipelines: 81 metrics: 82 receivers: [nrsqlserver] 83 processors: [memory_limiter, batch] 84 exporters: [otlp] 85 86 logs: 87 receivers: [nrsqlserver] 88 processors: [memory_limiter, batch] 89 exporters: [otlp]

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를 다시 시작하십시오

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

bash

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

팁

새로운 설정이 적용되도록 설정 변경 후에는 항상 NRDOT Collector 서비스를 다시 시작하십시오.

데이터 찾기 및 사용

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

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

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

전제 조건

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

유효한 라이선스 키가 있는 뉴렐릭 계정
해당 리전의 뉴렐릭 OTLP 엔드포인트
SQL Server 요구 사항, 다음이 필요합니다:
- SQL Server 2017 이상
- SQL Server에 대한 관리자 액세스 권한(sysadmin 역할 또는 동등한 권한)
- 포트 1433 또는 사용자 지정 포트에서의 수집기와 SQL Server 간 네트워크 연결
- SQL Server Management Studio(SSMS) 또는 sqlcmd 유틸리티
Active Directory가 있는 Windows 도메인 환경
Windows 인증을 허용하도록 설정된 SQL Server
적절한 SQL Server 권한이 있는 도메인 사용자 계정
뉴렐릭 OTLP 엔드포인트에 대한 네트워크 연결

미리보기에 등록하십시오

이 통합은 뉴렐릭 공개 프리뷰 프로그램의 일환으로 제공됩니다. Previews & Trials 페이지에서 옵트인하려면 조직 관리자에게 문의하십시오.

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가 Windows 인증을 위해 설정되어 있는지 확인하고 연결을 확인합니다.

Windows 사용자 이름을 조회하십시오:
```
SELECT SYSTEM_USER;
```

다음 명령을 실행하여 Windows 사용자에게 필요한 권한이 부여되었는지 확인하십시오. 모든 <ACCOUNT_USERNAME>을(를) 1단계에서 가져온 사용자 이름으로 바꾸십시오:

DECLARE @TargetUser SYSNAME = '<ACCOUNT_USERNAME>'; -- <-- Set your Windows user here

-- 1. Create the checklist of required permissions from your script
DECLARE @Checklist TABLE (Scope NVARCHAR(50), [Database] SYSNAME, [Permission] NVARCHAR(128));

INSERT INTO @Checklist VALUES
('Server', 'ALL', 'VIEW SERVER STATE'),
('Server', 'ALL', 'VIEW ANY DEFINITION'),
('Server', 'ALL', 'VIEW ANY DATABASE');

INSERT INTO @Checklist
SELECT 'Database Role', [name], 'db_datareader' FROM sys.databases WHERE [name] NOT IN ('master', 'msdb', 'model', 'rdsadmin', 'distribution') AND [state] = 0
UNION ALL
SELECT 'Database Explicit', [name], 'VIEW DATABASE STATE' FROM sys.databases WHERE [name] NOT IN ('master', 'msdb', 'model', 'rdsadmin', 'distribution') AND [state] = 0
UNION ALL
SELECT 'Database Explicit', [name], 'VIEW DEFINITION' FROM sys.databases WHERE [name] NOT IN ('master', 'msdb', 'model', 'rdsadmin', 'distribution') AND [state] = 0;

-- 2. Gather existing explicit permissions
WITH ExplicitPerms AS (
    SELECT 'Server' AS Scope, CAST('ALL' AS NVARCHAR(128)) COLLATE DATABASE_DEFAULT AS [Database], p.permission_name COLLATE DATABASE_DEFAULT AS [Permission]
    FROM sys.server_permissions p JOIN sys.server_principals l ON p.grantee_principal_id = l.principal_id WHERE l.name = @TargetUser
    UNION ALL
    SELECT 'Database Role', d.name COLLATE DATABASE_DEFAULT, r.name COLLATE DATABASE_DEFAULT
    FROM sys.databases d CROSS APPLY (SELECT dp_role.name FROM sys.database_role_members drm JOIN sys.database_principals dp_role ON drm.role_principal_id = dp_role.principal_id JOIN sys.database_principals dp_user ON drm.member_principal_id = dp_user.principal_id JOIN sys.server_principals sp ON dp_user.sid = sp.sid WHERE sp.name = @TargetUser) r WHERE d.state = 0
    UNION ALL
    SELECT 'Database Explicit', d.name COLLATE DATABASE_DEFAULT, p.permission_name COLLATE DATABASE_DEFAULT
    FROM sys.databases d CROSS APPLY (SELECT db_p.permission_name FROM sys.database_permissions db_p JOIN sys.database_principals dp_user ON db_p.grantee_principal_id = dp_user.principal_id JOIN sys.server_principals sp ON dp_user.sid = sp.sid WHERE sp.name = @TargetUser) p WHERE d.state = 0
)
-- 3. Output the exact verification matrix
SELECT
    chk.Scope,
    chk.[Database],
    chk.[Permission] AS [Required Permission],
    CASE
        WHEN exp.[Permission] IS NOT NULL THEN 'GRANTED'
        WHEN IS_SRVROLEMEMBER('sysadmin', @TargetUser) = 1 THEN 'PASSED (via SysAdmin Role)'
        ELSE 'MISSING'
    END AS [Verification Status]
FROM @Checklist chk
LEFT JOIN ExplicitPerms exp ON chk.Scope = exp.Scope AND chk.[Database] = exp.[Database] AND chk.[Permission] = exp.[Permission]
ORDER BY chk.Scope, chk.[Database], chk.[Permission];

(선택 사항) 필요한 권한이 없는 경우 SSMS 또는 sqlcmd 유틸리티에서 다음 명령을 실행하여 Windows 계정에 필요한 권한을 부여하십시오. 모든 <ACCOUNT_USERNAME>을(를) 1단계에서 검색한 Windows 사용자 이름으로 바꾸십시오:

USE [master];
GO

-- 1. Grant Instance-level permissions to your Windows Account
GRANT VIEW SERVER STATE TO [<ACCOUNT_USERNAME>];
GRANT VIEW ANY DEFINITION TO [<ACCOUNT_USERNAME>];
GRANT VIEW ANY DATABASE TO [<ACCOUNT_USERNAME>];
GO

-- 2. Loop through all user databases and grant read/visibility permissions
DECLARE @name SYSNAME;
DECLARE @sql NVARCHAR(MAX);

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
        PRINT 'Granting permissions on database: ' + @name;

        -- Create the database user mapping if it doesn't exist, then grant roles
        SET @sql = '
            USE [' + @name + '];
            IF NOT EXISTS (SELECT 1 FROM sys.database_principals WHERE name = ''<ACCOUNT_USERNAME>'')
            BEGIN
                CREATE USER [<ACCOUNT_USERNAME>] FOR LOGIN [<ACCOUNT_USERNAME>];
            END;
            GRANT VIEW DATABASE STATE TO [<ACCOUNT_USERNAME>];
            GRANT VIEW DEFINITION TO [<ACCOUNT_USERNAME>];
            ALTER ROLE db_datareader ADD MEMBER [<ACCOUNT_USERNAME>];';

        EXEC sp_executesql @sql;
        PRINT 'Success: ' + @name;
    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

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

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

bash

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

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

bash

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

팁

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

NRDOT Collector구성

관리자 권한으로 PowerShell에서 mssql-config.yaml (으)로 명명된 설정 파일을 생성하십시오:
bash
```
$New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```

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

전체 설정

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

SQL Server 호스트명/IP

SQL Server 포트

뉴렐릭 OTLP 엔드포인트

뉴렐릭 라이선스 키

mssql-config.yaml

1
receivers:
2
nrsqlserver:
3
   collection_interval: 15s
4
   datasource: "server=sqlserver.example.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 top query and query sample log collection
34
   events:
35
     db.server.query_sample:
36
       enabled: true
37
     db.server.top_query:
38
       enabled: true
39

40
   # Top query collection configuration
41
   top_query_collection:
42
     lookback_time: 60s
43
     max_query_sample_count: 1000
44
     top_query_count: 250
45
     collection_interval: 60s
46

47
   collect_full_query_text: true
48
   allowed_comment_keys:
49
     - nr_service_guid
50

51
   # Query sample collection configuration
52
   query_sample_collection:
53
     max_rows_per_query: 100
54

55
processors:
56
memory_limiter:
57
   check_interval: ${env:NR_MEM_LIMITER_CHECK_INTERVAL:-1s}
58
   limit_mib:       ${env:NR_MEM_LIMITER_LIMIT_MIB:-200}
59
   spike_limit_mib: ${env:NR_MEM_LIMITER_SPIKE_MIB:-50}
60

61
batch:
62

63
exporters:
64
otlp:
65
   endpoint: https://otlp.nr-data.net:4318
66
   headers:
67
     api-key: YOUR_LICENSE_KEY
68
   tls:
69
     insecure: false
70
   compression: gzip
71

72
service:
73
telemetry:
74
   metrics:
75
     level: none
76

77
pipelines:
78
   metrics:
79
     receivers: [nrsqlserver]
80
     processors: [memory_limiter, batch]
81
     exporters: [otlp]
82

83
   logs:
84
     receivers: [nrsqlserver]
85
     processors: [memory_limiter, batch]
86
     exporters: [otlp]

팁

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

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를 다시 시작하십시오

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

bash

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

팁

새로운 설정이 적용되도록 설정 변경 후에는 항상 NRDOT Collector 서비스를 다시 시작하십시오.

데이터 찾기 및 사용

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

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

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

전제 조건

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

유효한 라이선스 키가 있는 뉴렐릭 계정
해당 리전의 뉴렐릭 OTLP 엔드포인트
SQL Server 요구 사항, 다음이 필요합니다:
- SQL Server 2017 이상
- SQL Server에 대한 관리자 액세스 권한(sysadmin 역할 또는 동등한 권한)
- 수집기와 SQL Server 간의 포트 1433 또는 사용자 지정 포트에 대한 네트워크 연결
- SQL Server Management Studio(SSMS) 또는 sqlcmd 유틸리티
gMSA를 지원하는 Active Directory 환경
Windows 호스트는 도메인에 가입되어 있어야 하며 gMSA 계정을 사용하도록 권한이 부여되어야 합니다
뉴렐릭 OTLP 엔드포인트에 대한 네트워크 연결

미리보기에 등록하십시오

이 통합은 뉴렐릭 공개 프리뷰 프로그램의 일환으로 제공됩니다. Previews & Trials 페이지에서 옵트인하려면 조직 관리자에게 문의하십시오.

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)에서 다음 스크립트를 실행하여 gMSA 계정에 대한 로그인을 생성하고 필요한 권한을 부여하십시오. 모든 <YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>을(를) 실제 도메인 및 gMSA 계정 이름으로 교체하십시오.

USE [master];
GO

-- Provision an engine login identity for the gMSA
CREATE LOGIN [<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$] FROM WINDOWS;
GO

-- Grant monitoring permissions
GRANT VIEW SERVER STATE TO [<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$];
GRANT VIEW ANY DEFINITION TO [<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$];
GRANT VIEW ANY DATABASE TO [<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$];
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_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 계정으로 실행

NRDOT Collector를 설치한 후 PowerShell을 사용하여 gMSA 계정으로 실행되도록 서비스를 설정하십시오. YOUR_DOMAIN\YOUR_gMSA_ACCOUNT$을(를) 도메인 및 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_ACCOUNT$" password= ""'
$
$# Verify the configuration
$Get-WmiObject Win32_Service -Filter "Name='nrdot-collector'" | Select Name, StartName
$
$# start the NRDOT Collector service
$Start-Service nrdot-collector

NRDOT Collector구성

관리자 권한으로 PowerShell에서 mssql-config.yaml (으)로 명명된 설정 파일을 생성하십시오:
bash
```
$New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```

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

전체 설정

SQL Server 호스트명/IP

SQL Server 포트

뉴렐릭 OTLP 엔드포인트

뉴렐릭 라이선스 키

mssql-config.yaml

1
receivers:
2
nrsqlserver:
3
   collection_interval: 15s
4
   datasource: "server=sqlserver.example.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 top query and query sample log collection
34
   events:
35
     db.server.query_sample:
36
       enabled: true
37
     db.server.top_query:
38
       enabled: true
39

40
   # Top query collection configuration
41
   top_query_collection:
42
     lookback_time: 60s
43
     max_query_sample_count: 1000
44
     top_query_count: 250
45
     collection_interval: 60s
46

47
   collect_full_query_text: true
48
   allowed_comment_keys:
49
     - nr_service_guid
50

51
   # Query sample collection configuration
52
   query_sample_collection:
53
     max_rows_per_query: 100
54

55
processors:
56
memory_limiter:
57
   check_interval: ${env:NR_MEM_LIMITER_CHECK_INTERVAL:-1s}
58
   limit_mib:       ${env:NR_MEM_LIMITER_LIMIT_MIB:-200}
59
   spike_limit_mib: ${env:NR_MEM_LIMITER_SPIKE_MIB:-50}
60

61
batch:
62

63
exporters:
64
otlp:
65
   endpoint: https://otlp.nr-data.net:4318
66
   headers:
67
     api-key: YOUR_LICENSE_KEY
68
   tls:
69
     insecure: false
70
   compression: gzip
71

72
service:
73
telemetry:
74
   metrics:
75
     level: none
76

77
pipelines:
78
   metrics:
79
     receivers: [nrsqlserver]
80
     processors: [memory_limiter, batch]
81
     exporters: [otlp]
82

83
   logs:
84
     receivers: [nrsqlserver]
85
     processors: [memory_limiter, batch]
86
     exporters: [otlp]

팁

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

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를 다시 시작하십시오

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

bash

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

팁

새로운 설정이 적용되도록 설정 변경 후에는 항상 NRDOT Collector 서비스를 다시 시작하십시오.

데이터 찾기 및 사용

데이터가 수집되면 뉴렐릭 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가 수집하는 사용 가능한 메트릭에 대해 알아보십시오.

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

NRDOT를 사용한 Windows 자체 호스팅 MSSQL 모니터링

시사

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

미리보기에 등록하십시오

NRDOT Collector설치하세요

모니터링 사용자 생성

팁

NRDOT Collector구성

전체 설정

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

팁

NRDOT Collector를 다시 시작하십시오

팁

데이터 찾기 및 사용

전제 조건

미리보기에 등록하십시오

NRDOT Collector설치하세요

모니터링 사용자 생성

다른 Windows 호스트의 Collector

팁

NRDOT Collector구성

전체 설정

팁

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

팁

NRDOT Collector를 다시 시작하십시오

팁

데이터 찾기 및 사용

전제 조건

미리보기에 등록하십시오

NRDOT Collector설치하세요

모니터링 사용자 생성

팁

gMSA 계정으로 실행

NRDOT Collector구성

전체 설정

팁

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

NRDOT Collector를 다시 시작하십시오

팁

데이터 찾기 및 사용

관련 문서

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

문제점 해결

지표 참조

전제 조건