NRDOT을 이용한 Microsoft SQL Server 모니터링

시사

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

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

뉴렐릭은 이제 뉴렐릭의 데이터베이스 모니터링 기능과 함께 뉴렐릭 NRDOT(Distribution of OpenTelemetry)를 사용하여 Microsoft SQL Server 데이터베이스 성능을 모니터링할 수 있는 권한을 팀에 부여합니다. 이 통합은 NRDOT 수집기를 사용하여 데이터베이스 지표, 쿼리 성능 및 시스템 상태에 대한 포괄적인 인사이트를 제공합니다.

이 NRDOT 기반 접근 방식은 모니터링을 위한 OpenTelemetry 데이터베이스 표준을 활용하여 기존 온호스트 통합(OHI)을 보완하고 기존 옵저버빌리티 그리드와 통합을 더 쉽게 만듭니다.

전제 조건

시작하기 전에 다음 사항이 있는지 확인하세요.

유효한 뉴렐릭 클러스터
지원되는 데이터베이스 버전: SQL Server 2017 이상
SQL Server 데이터베이스 설정:
- SQL Server 인스턴스에 대한 관리자 액세스 권한(sysadmin 역할 또는 그에 상응하는 권한)이 필요합니다.
- 온프레미스 관리형 인스턴스를 지원하는 Microsoft SQL Server
- NRDOT 수집기와 SQL Server 간의 네트워크 연결
- SQL Server Management Studio(SSMS) 또는 sqlcmd 유틸리티
- 서버 호스트명 또는 IP 주소
- 포트 번호(일반적으로 1433) 또는 사용자 지정 포트
- Windows 도메인 또는 SQL Server 인증
- SSL 기본 설정
시스템 요구사항:
- NRDOT 수집기를 실행하려면 Windows 또는 Linux 시스템이 필요합니다.
- 뉴렐릭의 OTLP 엔드포인트에 대한 네트워크 연결

Microsoft SQL Server 모니터링을 위해 NRDOT Collector를 설정하세요.

NRDOT 수집기를 사용하여 Microsoft SQL Server 데이터베이스를 모니터링할 수 있습니다. NRDOT 수집기는 뉴럴릭 관련 구성 요소를 포함하는 사전 구성된 배포판입니다.

NRDOT Collector 설치 및 구성하려면 다음 단계를 따르십시오.

NRDOT Collector설정하세요

귀하의 운영 시스템과 그에 맞춰 수집기를 설치하세요.

중요

쿼리 성능 모니터링을 위한 인프라 수준 메트릭을 보려면 NRDOT Collector를 SQL Server 인스턴스와 동일한 호스트에 설치하는 것이 좋습니다.

뉴렐릭의 NRDOT Collector 통합용 설치 프로그램을 다운로드하려면 이 URL을 브라우저에 붙여넣어 설치 프로그램을 다운로드하고 실행하세요.
```
https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-windows-amd64-latest.msi
```
다운로드한 파일을 찾아 두 번 클릭하여 NRDOT Collector를 설치하세요.

AMD64 아키텍처용:
- 데비안/우분투 기반 배포판의 경우:
  bash
```
$curl -L -o nrdot-collector-host-linux-amd64.deb https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-linux-amd64-latest.deb
$sudo dpkg -i nrdot-collector-host-linux-amd64.deb
```
- RHEL/CentOS 기반 배포판의 경우:
  bash
```
$curl -L -o nrdot-collector-host-linux-amd64.rpm https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-linux-amd64-latest.rpm 
$sudo rpm -ivh nrdot-collector-host-linux-amd64.rpm
```

ARM64 아키텍처용:

데비안/우분투 기반 배포판의 경우:

bash

$curl -L -o nrdot-collector-host-linux-arm64.deb https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-linux-arm64-latest.deb
$sudo dpkg -i nrdot-collector-host-linux-arm64.deb

RHEL/CentOS 기반 배포판의 경우:

bash

$curl -L -o nrdot-collector-host-linux-arm64.rpm https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-linux-arm64-latest.rpm
$sudo rpm -ivh nrdot-collector-host-linux-arm64.rpm

데이터베이스 사용자 구성

다음 스크립트를 root user/sysadmin 사용자 권한으로 실행하여 newrelic 모니터링 사용자를 생성하고 전역 읽기 권한을 부여하십시오.

newrelic 모니터링 사용자를 생성하려면 SQL Server Management Studio(SSMS)를 사용하여 다음 스크립트를 실행하십시오.

USE [master];
GO
CREATE LOGIN [newrelic] WITH PASSWORD = '<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', 'tempdb', '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 'Processing database: ' + @name;
    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];
    GRANT VIEW DEFINITION TO [newrelic];
    ALTER ROLE db_datareader ADD MEMBER [newrelic];');
    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

Linux에서 newrelic 모니터링 사용자를 생성하려면 Linux 인스턴스에 다음 내용이 포함된 nr-grant-permission.sql 이라는 파일을 생성하십시오.

USE [master];
GO
CREATE LOGIN [newrelic] WITH PASSWORD = '<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', 'tempdb', '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 'Processing database: ' + @name;
    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];
    GRANT VIEW DEFINITION TO [newrelic];
    ALTER ROLE db_datareader ADD MEMBER [newrelic];');
    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

스크립트를 실행하려면 다음 명령어를 실행하십시오. <Your_SA_Password> SQL Server 관리자 암호로 바꾸십시오.
bash
```
$sqlcmd -S localhost -U sa -P '<Your_SA_Password>' -C -i nr-grant-permission.sql
```

(선택 사항) 사용자가 성공적으로 생성되었고 올바른 권한을 가졌는지 확인하려면 다음 명령을 실행하십시오. <Your_SA_Password> SQL Server 관리자 암호로 바꾸십시오.

bash

$sqlcmd -S localhost -U sa -P '<Your_SA_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';"

예상 출력:

User Permission_Granted
---------------------------------------------------------------------------------------------
<your_username> CONNECT SQL
<your_username> VIEW ANY DEFINITION
<your_username> VIEW ANY DATABASE
<your_username> VIEW SERVER STATE

이 출력은 필요한 서버 수준 권한을 가지고 사용자가 성공적으로 생성되었음을 확인시켜 줍니다.

NRDOT Collector구성

config.yaml 부분을 아래 내용으로 바꾸세요:

Windows: C:\Program Files (x86)\NRDOT Collector Host\config.yaml

리눅스: /etc/nrdot-collector-host/config.yaml

중요

기존 NRDOT Collector 사용자라면 위의 설정을 기존 config.yaml 파일과 병합하십시오. 여기에는 현재 설정을 유지하면서 MSSQL 데이터베이스 모니터링을 위한 새로운 수신자, 프로세서 및 내보내기를 추가하는 작업이 포함됩니다.

# NRDOT Collector Configuration for New Relic SQL Server Integration
# SQL Server On-Premises/VM Configuration

extensions:
  health_check:

receivers:
  otlp:
    protocols:
      grpc:
      http:

  hostmetrics:
    # Default collection interval is 60s. Lower if you need finer granularity.
    collection_interval: 60s
    scrapers:
      cpu:
        metrics:
          system.cpu.time:
            enabled: false
          system.cpu.utilization:
            enabled: true
      load:
      memory:
        metrics:
          system.memory.utilization:
            enabled: true
      paging:
        metrics:
          system.paging.utilization:
            enabled: false
          system.paging.faults:
            enabled: false
      filesystem:
        metrics:
          system.filesystem.utilization:
            enabled: true
      disk:
        metrics:
          system.disk.merged:
            enabled: false
          system.disk.pending_operations:
            enabled: false
          system.disk.weighted_io_time:
            enabled: false
      network:
        metrics:
          system.network.connections:
            enabled: false
     # Uncomment to enable process metrics, which can be noisy but valuable.
     # processes:
     # process:
     #  metrics:
     #    process.cpu.utilization:
     #      enabled: true
     #    process.cpu.time:
     #      enabled: false

  filelog:
    include:
      - /var/log/alternatives.log
      - /var/log/cloud-init.log
      - /var/log/auth.log
      - /var/log/dpkg.log
      - /var/log/syslog
      - /var/log/messages
      - /var/log/secure
      - /var/log/yum.log

  newrelicsqlserver:
    hostname: "<YOUR_DB_HOST>"
    port: "<YOUR_DB_PORT>"
    username: "<USERNAME>"
    password: "<PASSWORD>"
    monitored_databases: []
    # timeout: 30s
    # collection_interval: 15s  
    # query_monitoring_fetch_interval: 15
    # query_monitoring_response_time_threshold: 100
    # query_monitoring_count_threshold: 30
    # interval_calculator_cache_ttl_minutes: 10

    # Metric Category Toggles - Enable/disable entire categories of metrics
    # enable_instance_metrics: true
    # enable_database_metrics: true
    # enable_user_connection_metrics: true
    # enable_wait_time_metrics: true
    # enable_failover_cluster_metrics: true
    # enable_database_principals_metrics: true
    # enable_database_role_membership_metrics: true
    # enable_security_metrics: true
    # enable_lock_metrics: true
    # enable_thread_pool_metrics: true
    # enable_tempdb_metrics: true

processors:
  # group system.cpu metrics by cpu
  metricstransform:
    transforms:
      - include: system.cpu.utilization
        action: update
        operations:
          - action: aggregate_labels
            label_set: [ state ]
            aggregation_type: mean
      - include: system.paging.operations
        action: update
        operations:
          - action: aggregate_labels
            label_set: [ direction ]
            aggregation_type: sum

  # remove system.cpu metrics for states
  filter/exclude_cpu_utilization:
    metrics:
      datapoint:
        - 'metric.name == "system.cpu.utilization" and attributes["state"] == "interrupt"'
        - 'metric.name == "system.cpu.utilization" and attributes["state"] == "nice"'
        - 'metric.name == "system.cpu.utilization" and attributes["state"] == "softirq"'

  filter/exclude_memory_utilization:
    metrics:
      datapoint:
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_unreclaimable"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "inactive"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "cached"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "buffered"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_reclaimable"'

  filter/exclude_memory_usage:
    metrics:
      datapoint:
        - 'metric.name == "system.memory.usage" and attributes["state"] == "slab_unreclaimable"'
        - 'metric.name == "system.memory.usage" and attributes["state"] == "inactive"'

  filter/exclude_filesystem_utilization:
    metrics:
      datapoint:
        - 'metric.name == "system.filesystem.utilization" and attributes["type"] == "squashfs"'

  filter/exclude_filesystem_usage:
    metrics:
      datapoint:
        - 'metric.name == "system.filesystem.usage" and attributes["type"] == "squashfs"'
        - 'metric.name == "system.filesystem.usage" and attributes["state"] == "reserved"'

  filter/exclude_filesystem_inodes_usage:
    metrics:
      datapoint:
        - 'metric.name == "system.filesystem.inodes.usage" and attributes["type"] == "squashfs"'
        - 'metric.name == "system.filesystem.inodes.usage" and attributes["state"] == "reserved"'

  filter/exclude_system_disk:
    metrics:
      datapoint:
        - 'metric.name == "system.disk.operations" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.merged" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.io" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.io_time" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.operation_time" and IsMatch(attributes["device"], "^loop.*") == true'

  filter/exclude_system_paging:
    metrics:
      datapoint:
        - 'metric.name == "system.paging.usage" and attributes["state"] == "cached"'
        - 'metric.name == "system.paging.operations" and attributes["type"] == "cached"'

  filter/exclude_network:
    metrics:
      datapoint:
        - 'IsMatch(metric.name, "^system.network.*") == true and attributes["device"] == "lo"'

  attributes/exclude_system_paging:
    include:
      match_type: strict
      metric_names:
        - system.paging.operations
    actions:
      - key: type
        action: delete

  # Transform to clear description and unit fields
  transform/clear_metadata:
    metric_statements:
      - context: metric
        statements:
          - set(metric.description, "")
          - set(metric.unit, "")

  # Filter to only include execution plan and event metrics (for logs conversion)
  filter/exec_plan_include:
    metrics:
      include:
        match_type: strict
        metric_names:
          - sqlserver.slowquery.query_details
          - sqlserver.execution.plan
          - sqlserver.blocking_query.details
          - sqlserver.activequery.query_details

  # Filter to exclude execution plan and event metrics (from main metrics pipeline)
  filter/exec_plan_exclude:
    metrics:
      exclude:
        match_type: strict
        metric_names:
          - sqlserver.slowquery.query_details
          - sqlserver.execution.plan
          - sqlserver.blocking_query.details
          - sqlserver.activequery.query_details

  cumulativetodelta:
    max_staleness: 5m
    include:
      match_type: strict
      metrics:
        # Wait stats (sys.dm_os_wait_stats)
        - sqlserver.wait_stats.latch.wait_time_ms
        - sqlserver.wait_stats.latch.waiting_tasks_count
        - sqlserver.wait_stats.wait_time_ms
        - sqlserver.wait_stats.waiting_tasks_count
        # Instance stats (sys.dm_os_performance_counters)
        - sqlserver.stats.sql_compilations_per_sec
        - sqlserver.stats.sql_recompilations_per_sec
        - sqlserver.stats.lock_waits_per_sec
        - sqlserver.stats.deadlocks_per_sec
        - sqlserver.stats.user_errors_per_sec
        - sqlserver.stats.kill_connection_errors_per_sec
        - sqlserver.access.page_splits_per_sec
        - sqlserver.buffer.checkpoint_pages_per_sec
        - sqlserver.bufferpool.batch_requests_per_sec
        - sqlserver.instance.transactions_per_sec
        - sqlserver.instance.forced_parameterizations_per_sec
        - sqlserver.instance.full_scans_rate
        - sqlserver.instance.lock_timeouts_rate
        # Database log (sys.dm_os_performance_counters)
        - sqlserver.database.log.flushes_per_sec
        - sqlserver.database.log.bytes_flushed_per_sec
        - sqlserver.database.log.flush_waits_per_sec
        # Failover cluster
        - sqlserver.failover_cluster.log_bytes_received_per_sec
        # User connections
        - sqlserver.user_connections.authentication.logins_per_sec

  deltatorate:
    metrics:
      - sqlserver.wait_stats.latch.wait_time_ms
      - sqlserver.wait_stats.latch.waiting_tasks_count
      - sqlserver.wait_stats.wait_time_ms
      - sqlserver.wait_stats.waiting_tasks_count
      - sqlserver.stats.sql_compilations_per_sec
      - sqlserver.stats.sql_recompilations_per_sec
      - sqlserver.stats.lock_waits_per_sec
      - sqlserver.stats.deadlocks_per_sec
      - sqlserver.stats.user_errors_per_sec
      - sqlserver.stats.kill_connection_errors_per_sec
      - sqlserver.access.page_splits_per_sec
      - sqlserver.buffer.checkpoint_pages_per_sec
      - sqlserver.bufferpool.batch_requests_per_sec
      - sqlserver.instance.transactions_per_sec
      - sqlserver.instance.forced_parameterizations_per_sec
      - sqlserver.instance.full_scans_rate
      - sqlserver.instance.lock_timeouts_rate
      - sqlserver.database.log.flushes_per_sec
      - sqlserver.database.log.bytes_flushed_per_sec
      - sqlserver.database.log.flush_waits_per_sec
      - sqlserver.failover_cluster.log_bytes_received_per_sec
      - sqlserver.user_connections.authentication.logins_per_sec

  transform/host:
    metric_statements:
      - context: metric
        statements:
          - set(metric.description, "")
          - set(metric.unit, "")

  transform:
    trace_statements:
      - context: span
        statements:
          - truncate_all(span.attributes, 4095)
          - truncate_all(resource.attributes, 4095)
    log_statements:
      - context: log
        statements:
          - truncate_all(log.attributes, 4095)
          - truncate_all(resource.attributes, 4095)

  # used to prevent out of memory situations on the collector
  memory_limiter:
    check_interval: 1s
    limit_mib: ${env:NEW_RELIC_MEMORY_LIMIT_MIB:-100}

  batch:

  resourcedetection:
    detectors: ["system"]
    system:
      hostname_sources: ["os"]
      resource_attributes:
        host.id:
          enabled: true

  resourcedetection/db_safe:
    detectors: ["system"]
    override: false
    system:
      hostname_sources: ["os"]
      resource_attributes:
        host.id:
          enabled: true

  resourcedetection/cloud:
    detectors: ["gcp", "ec2", "azure"]
    timeout: 2s
    override: true

  resourcedetection/env:
    detectors: ["env"]
    timeout: 2s
    override: true

connectors:
  metricsaslogs:
    include_resource_attributes: true
    include_scope_info: true

exporters:
  otlphttp:
    endpoint: "<YOUR_NEWRELIC_OTLP_ENDPOINT>"
    headers:
      api-key: "<YOUR_NEWRELIC_API_KEY>"
    compression: gzip

service:
  pipelines:
    metrics/host:
      receivers: [hostmetrics]
      processors:
        - memory_limiter
        - metricstransform
        - filter/exclude_cpu_utilization
        - filter/exclude_memory_utilization
        - filter/exclude_memory_usage
        - filter/exclude_filesystem_utilization
        - filter/exclude_filesystem_usage
        - filter/exclude_filesystem_inodes_usage
        - filter/exclude_system_disk
        - filter/exclude_network
        - attributes/exclude_system_paging
        - transform/host
        - resourcedetection
        - resourcedetection/cloud
        - resourcedetection/db_safe
        - resourcedetection/env
        - cumulativetodelta
        - deltatorate
        - batch
      exporters: [otlphttp]
    traces:
      receivers: [otlp]
      processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
      exporters: [otlphttp]
    metrics:
      receivers: [newrelicsqlserver, otlp]
      processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, filter/exec_plan_exclude, batch]
      exporters: [otlphttp]
    logs:
      receivers: [metricsaslogs, otlp]
      processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
      exporters: [otlphttp]
    metrics/exec_plan_to_logs:
      receivers: [newrelicsqlserver, otlp]
      processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, filter/exec_plan_include, batch]
      exporters: [metricsaslogs]
  extensions: [health_check]

구성 매개변수

다음 표에서는 newrelicsqlserver 수신자에 대한 주요 설정 초기화에 대해 설명합니다.

매개변수	설명
`<YOUR_DB_HOST>`	SQL Server 호스트명 또는 IP 주소를 입력하십시오.
`<YOUR_DB_PORT>`	SQL Server 포트 번호를 입력하십시오. 기본값은 1433으로 설정되어 있습니다.
`<USERNAME>`	인증을 위해 데이터베이스 사용자 이름을 입력하세요.
`<PASSWORD>`	인증을 위해 데이터베이스 비밀번호를 입력하세요.
`<YOUR_NEWRELIC_OTLP_ENDPOINT>`	뉴렐릭 OTLP 엔드포인트를 입력하세요. 자세한 내용은 뉴렐릭 OTLP 엔드포인트 문서를 참조하세요.
`<YOUR_NEWRELIC_API_KEY>`	뉴렐릭 API 키를 입력하세요.
`query_monitoring_response_time_threshold`	쿼리가 느리다고 간주되는 최소 응답 시간(밀리초)입니다. 기본값은 `100` ms로 설정되어 있습니다.
`query_monitoring_count_threshold`	모니터링에 쿼리를 포함하기 위한 최소 실행 횟수입니다. 기본값은 `30` 으로 설정되어 있습니다.
`query_monitoring_fetch_interval`	쿼리 모니터링 데이터를 가져오는 간격(초). 기본값은 `15` 초로 설정되어 있습니다.
`collection_interval`	수집 간격(초). 기본값은 `15s` 으로 설정되어 있습니다.

NRDOT 수집기 재시작

설정을 업데이트한 후 NRDOT 수집기 서비스를 다시 시작하십시오.

Windows에서 NRDOT Collector 서비스를 다시 시작하려면 다음 명령을 실행하십시오.
bash
```
$net stop nrdot-collector-host
$net start nrdot-collector-host
```
Linux에서 NRDOT Collector 서비스를 다시 시작하려면 다음 명령을 실행하십시오.
bash
```
$sudo systemctl restart nrdot-collector-host
```
팁
설정을 변경한 후에는 반드시 NRDOT 수집기 서비스를 다시 시작하여 새 설정이 적용되도록 하십시오.

(선택 사항) APM-데이터베이스 상관 관계 설정

애플리케이션 성능과 데이터베이스 작업 간의 상관관계를 파악하려면 데이터베이스 서비스 식별을 설정할 수 있습니다. 이를 통해 특정 데이터베이스워크로드 기능을 생성하는 기능을 정확하게 확인할 수 있습니다. 자세한 내용은 뉴렐릭에서 APM- 데이터베이스 상관 관계를 가져오기 위한 데이터베이스 서비스 식별 설정을 참조하세요.

중요

APM 에서 데이터베이스 성능 데이터를 보려면 두 가지 모두 동일한 뉴렐릭 계정에 있어야 합니다. 만약 데이터가 서로 다른 뉴럴릭 계정에 있다면, 데이터를 보려면 두 계정 모두에 접근 권한이 있어야 합니다.

(선택 사항) 비밀 관리 구성

비밀 관리 기능을 사용하면 데이터베이스 자격 증명과 같은 중요한 정보를 안전하게 관리할 수 있습니다. 이렇게 하면 구성 파일에 민감한 데이터를 하드코딩하는 것을 방지하여 모니터링 설정의 보안을 강화할 수 있습니다. 자세한 내용은 비밀 관리 부분 을 참조하십시오.

데이터 찾기 및 사용

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

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

https://one.newrelic.com > All Capabilities > Databases 으)로 이동합니다.
검색 기준을 instrumentation.provider = opentelemetry 으로 설정합니다.
모임 목록에서 SQL Server 데이터베이스를 선택합니다.

NRDOT 수집기 지원 명령

NRDOT Collector 서비스를 관리하거나, 로그를 보거나, 서비스 상태를 확인하려면 운영 체제에 따라 다음 명령어를 사용하십시오.

NRDOT Collector를 다시 시작하려면:

bash

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

NRDOT Collector 상태를 확인하려면 다음을 참조하십시오.
bash
```
$sc query nrdot-collector-host
```
NRDOT Collector 로그를 보려면:
1. 검색창에 Event Viewer 입력하고 선택하세요.
2. 왼쪽 사이드바에서 'Windows 로그'라는 폴더를 확장하세요.
3. 제작을 클릭하여 제작별 이벤트를 중앙 창에 로드합니다.
4. 소스 유형이 = 인 이벤트를 찾으세요 nrdot-collector-host
NRDOT Collector 서비스를 삭제하려면 Add/Remove Programs 통해 제거하십시오.

설치 상태를 확인하려면:
- 데비안/우분투 기반 배포판의 경우:
  bash
```
$dpkg -l | grep nrdot-collector-host
```
- RHEL/CentOS 기반 배포판의 경우:
  bash
```
$rpm -q nrdot-collector-host || ls /etc/nrdot-collector-host
```
NRDOT Collector를 다시 시작하려면:
bash
```
$sudo systemctl restart nrdot-collector-host
```
NRDOT Collector 상태를 확인하려면 다음을 참조하십시오.
bash
```
$sudo systemctl status nrdot-collector-host
```

NRDOT Collector 로그를 보려면:

bash

$sudo journalctl -u nrdot-collector-host -f

NRDOT Collector 서비스를 삭제하려면:
- 데비안/우분투 기반 배포판의 경우:
  bash
```
$sudo apt-get purge -y nrdot-collector-host
```
- RHEL/CentOS 기반 배포판의 경우:
  bash
```
$sudo dnf remove -y nrdot-collector-host&& sudo rm -rf /etc/nrdot-collector-host
```

문제점 해결

NRDOT Collector에서 네트워크 연결 문제가 발생하는 경우 다음 명령을 실행하여 1433번 포트의 SQL Server 인스턴스에 대한 연결을 테스트하십시오.

Windows의 경우 다음 명령을 실행하세요.

bash

$Test-NetConnection -ComputerName <YOUR_IP_ADDRESS> -Port <YOUR_PORT_NUMBER>

리눅스에서는 다음 명령을 실행하세요:
bash
```
$nc -zv <YOUR_IP_ADDRESS> <YOUR_PORT_NUMBER>
```

사용 가능한 지표

설정 플래그로 구성된 지표로 SQL Server 데이터베이스 성능을 모니터링하세요. 뉴럴릭 UI 기능을 위해 기본 설정이 자동으로 수집됩니다. 제공된 추가 정보를 활용하여 특정 스크래퍼를 활성화하면 더욱 고급스럽고 심층적인 인사이트 정보를 얻을 수 있습니다.

기본 측정항목

이러한 지표는 뉴렐릭의 SQL Server 모니터링 기능에 필수적이며 설정에 관계없이 자동으로 수집됩니다.

측정항목 이름	설명
`sqlserver.stats.connections`	현재 사용자 연결
`sqlserver.instance.blocked_processes_count`	차단된 프로세스 수
`sqlserver.instance.buffer_pool_hit_percent`	버퍼 풀 적중률
`sqlserver.instance.buffer_pool_size`	버퍼 풀 크기
`sqlserver.instance.compilations_per_batch`	배치 요청별 SQL 컴파일
`sqlserver.instance.connections_active`	활성 연결 수
`sqlserver.instance.forced_parameterizations_per_sec`	초당 강제 매개변수화
`sqlserver.instance.full_scans_rate`	초당 전체 테이블/인덱스 스캔 횟수
`sqlserver.instance.lock_timeouts_rate`	초당 잠금 시간 초과 횟수
`sqlserver.instance.memory_available`	시스템에서 사용 가능한 물리적 메모리
`sqlserver.instance.memory_utilization_percent`	메모리 사용률
`sqlserver.instance.page_splits_per_batch`	배치 요청별 페이지 분할
`sqlserver.instance.target_memory_kb`	개구리, 목표 서버 메모리(KB)
`sqlserver.instance.transactions_per_sec`	초당 거래량
`sqlserver.buffer.cache_hit_ratio`	버퍼 리치 히트 비율 백분율
`sqlserver.buffer.checkpoint_pages_per_sec`	체크포인트 페이지 초당
`sqlserver.buffer.page_life_expectancy`	페이지 수명(초)
`sqlserver.bufferpool.page_life_expectancy_ms`	페이지 수명(밀리초)
`sqlserver.database.io.stall_ms`	SQL Server 데이터베이스의 총 IO 지연 시간
`sqlserver.database.log.flushes_per_sec`	초당 로그 플러시 작업 횟수
`sqlserver.database.log.transaction_growth`	SQL Server 데이터베이스의 로그 증가 이벤트 수
`sqlserver.database.page_file_available_bytes`	SQL Server 데이터베이스에 사용 가능한 페이지 파일 공간
`sqlserver.database.page_file_total_bytes`	SQL Server 데이터베이스의 총 페이지 파일 공간
`sqlserver.database.size.data_mb`	로그 파일을 제외한 전체 데이터 파일 크기
`sqlserver.database.size.total_mb`	데이터 파일과 로그 파일을 포함한 전체 데이터베이스 크기
`sqlserver.stats.deadlocks_per_sec`	초당 교착 상태 발생 횟수
`sqlserver.stats.kill_connection_errors_per_sec`	초당 연결 오류 발생
`sqlserver.stats.lock_waits_per_sec`	초당 잠금 대기 시간
`sqlserver.stats.sql_compilations_per_sec`	초당 SQL 컴파일 횟수
`sqlserver.stats.sql_recompilations_per_sec`	초당 SQL 재컴파일 횟수
`sqlserver.stats.user_errors_per_sec`	초당 사용자 오류 수
`sqlserver.wait_stats.wait_time_ms`	총 대기 시간(밀리초)
`sqlserver.access.page_splits_per_sec`	초당 페이지 분할
`sqlserver.execution.plan`	상세 비용 견적을 제공하는 SQL Server 실행 계획 연산자
`sqlserver.plan.avg_elapsed_time_ms`	이 계획 실행당 평균 소요 시간(과거 데이터)
`sqlserver.slowquery.avg_elapsed_time_ms`	실행당 평균 소요 시간(밀리초)
`sqlserver.slowquery.historical_avg_elapsed_time_ms`	과거 평균 경과 시간(밀리초)
`sqlserver.slowquery.historical_execution_count`	역사적 처형 횟수
`sqlserver.slowquery.historical_logical_reads`	역사적 총 논리적 읽기
`sqlserver.slowquery.historical_physical_reads`	과거 총 물리적 판독 횟수
`sqlserver.slowquery.historical_rows`	반환된 총 행 수에 대한 과거 기록
`sqlserver.slowquery.historical_wait_time_ms`	역대 총 대기 시간(밀리초)
`sqlserver.slowquery.historical_worker_time_ms`	과거 총 작업자(CPU) 시간(밀리초)
`sqlserver.slowquery.interval_avg_elapsed_time_ms`	구간 평균 경과 시간(밀리초)
`sqlserver.slowquery.interval_avg_logical_reads`	실행당 간격 평균 논리적 읽기 횟수
`sqlserver.slowquery.interval_avg_physical_reads`	실행당 간격 평균 물리적 읽기 횟수
`sqlserver.slowquery.interval_avg_rows`	실행당 반환되는 행 수의 간격 평균
`sqlserver.slowquery.interval_avg_wait_time_ms`	실행당 평균 대기 시간(밀리초)
`sqlserver.slowquery.interval_avg_worker_time_ms`	실행당 간격 평균 작업자(CPU) 시간(밀리초)
`sqlserver.slowquery.interval_elapsed_time_ms`	간격별 총 경과 시간(밀리초)
`sqlserver.slowquery.interval_execution_count`	간격 실행 횟수
`sqlserver.slowquery.interval_logical_reads`	간격 논리 읽기
`sqlserver.slowquery.interval_physical_reads`	간격 물리적 판독
`sqlserver.slowquery.interval_rows`	간격 행이 반환되었습니다.
`sqlserver.slowquery.interval_wait_time_ms`	간격 대기 시간(밀리초)
`sqlserver.slowquery.interval_worker_time_ms`	인터벌 워커(CPU) 시간(밀리초)
`sqlserver.slowquery.query_details`	느린 쿼리에 대한 텍스트 및 타임스탬프를 포함한 쿼리 세부 정보
`sqlserver.activequery.wait_time_seconds`	현재 실행 중인 쿼리의 대기 시간
`sqlserver.blocking_query.details`	활성 쿼리와의 상관 관계에 대한 차단 쿼리 세부 정보

추가 지표

SQL Server 데이터베이스 성능 및 상태에 대한 심층적인 인사이트를 위해 필요에 따라 이러한 추가 지표를 활성화합니다.

이러한 정보를 수집하려면 enable_instance_metrics: true 활성화하세요.

측정항목 이름	설명
`sqlserver.instance.background_processes_count`	백그라운드 프로세스 수
`sqlserver.instance.disk_in_bytes`	총 디스크 공간(바이트)
`sqlserver.instance.dormant_processes_count`	휴면 프로세스 수
`sqlserver.instance.memory_total`	시스템의 총 물리적 메모리
`sqlserver.instance.preconnect_processes_count`	사전 연결 프로세스 수
`sqlserver.instance.runnable_processes_count`	실행 가능한 프로세스 수
`sqlserver.instance.runnable_tasks`	실행 가능한 작업 수
`sqlserver.instance.running_processes_count`	실행 중인 프로세스 수
`sqlserver.instance.sleeping_processes_count`	수면 과정 수
`sqlserver.instance.suspended_processes_count`	일시 중단된 프로세스 수

측정항목 이름	설명
`sqlserver.bufferpool.batch_requests_per_sec`	초당 배치 requests

측정항목 이름	설명
`sqlserver.connections.user`	사용자 연결 수

이러한 정보를 수집하려면 enable_database_metrics: true 활성화하세요.

측정항목 이름	설명
`sqlserver.database.bufferpool.size_per_database_bytes`	데이터베이스에 할당된 SQL Server 버퍼 풀의 크기
`sqlserver.database.log.bytes_flushed_per_sec`	초당 플러시된 로그 바이트 수
`sqlserver.database.log.flush_waits_per_sec`	초당 플러시 대기 작업 횟수
`sqlserver.database.log.used_space_mb`	로그 공간 사용량(메가바이트)
`sqlserver.database.max_disk_size_bytes`	SQL Server 데이터베이스에 허용되는 최대 디스크 크기
`sqlserver.database.principals.applicationRoles`	애플리케이션 역할 수
`sqlserver.database.principals.old`	기존 교장 수 (365일 이상 경과)
`sqlserver.database.principals.orphanedUsers`	서버 로그인이 없는 고아 사용자 수
`sqlserver.database.principals.recentlyCreated`	최근 30일 동안 생성된 주요 담당자 수
`sqlserver.database.principals.roles`	데이터베이스 역할 수
`sqlserver.database.principals.sqlUsers`	SQL 인증 사용자 수
`sqlserver.database.principals.total`	데이터베이스 주체의 총 수
`sqlserver.database.principals.users`	데이터베이스 사용자 수
`sqlserver.database.principals.windowsUsers`	Windows 인증 사용자 수
`sqlserver.database.role.members.applicationRoles`	애플리케이션 역할 구성원 수
`sqlserver.database.role.members.crossRole`	교차 역할 구성원 수
`sqlserver.database.role.members.highPrivilege`	높은 권한을 가진 역할 구성원 수
`sqlserver.database.role.members.unique`	역할에 속한 고유 구성원 수
`sqlserver.database.role.memberships.active`	활성 역할 멤버십 수
`sqlserver.database.role.memberships.custom`	사용자 지정 역할 멤버십 수
`sqlserver.database.role.memberships.nested`	중첩된 역할 멤버십 수
`sqlserver.database.role.memberships.total`	역할 멤버십 총 개수
`sqlserver.database.role.memberships.users`	사용자 역할 멤버십 수
`sqlserver.database.role.permission.memberCount`	해당 역할의 구성원 수
`sqlserver.database.role.permission.riskLevel`	역할 위험 수준
`sqlserver.database.role.roles.empty`	공석 수
`sqlserver.database.role.roles.withMembers`	멤버가 있는 고유 역할 수
`sqlserver.database.transactions.active`	활성 거래 수

이러한 정보를 수집하려면 enable_failover_cluster_metrics: true 활성화하세요.

측정항목 이름	설명
`sqlserver.failover_cluster.ag_cluster_type`	가용성 그룹의 Cluster 유형
`sqlserver.failover_cluster.ag_failure_condition_level`	가용성 그룹에 대한 자동 페일오버 조건 수준
`sqlserver.failover_cluster.ag_health_check_timeout`	가용성 그룹에 대한 상태 확인 시간 초과(밀리초)
`sqlserver.failover_cluster.ag_replica_role`	가용성 그룹 내 복제본의 현재 역할
`sqlserver.failover_cluster.ag_required_sync_secondaries`	트랜잭션을 커밋하는 데 필요한 동기식 보조 복제본 수
`sqlserver.failover_cluster.ag_synchronization_health`	기본 복제본과 보조 복제본 간의 데이터 동기화 상태
`sqlserver.failover_cluster.flow_control_time_ms`	기본 복제본의 로그 레코드에 의한 흐름 제어에 소요된 시간(밀리초/초)
`sqlserver.failover_cluster.log_bytes_received_per_sec`	보조 복제본이 기본 복제본으로부터 초당 수신하는 로그 레코드 수(바이트)
`sqlserver.failover_cluster.log_send_queue_kb`	보조 복제본으로 전송될 로그 전송 큐에 있는 로그 레코드 수(킬로바이트)
`sqlserver.failover_cluster.redo_queue_kb`	보조 복제본에서 재실행을 기다리는 재실행 큐의 로그 레코드 수(킬로바이트)
`sqlserver.failover_cluster.redo_rate_kb_sec`	보조 복제본에서 로그 레코드가 다시 생성되는 속도(킬로바이트/초)
`sqlserver.failover_cluster.transaction_delay_ms`	보조 복제본에서 트랜잭션 처리에 소요되는 평균 지연 시간(밀리초)

이러한 정보를 수집하려면 enable_lock_metrics: true 활성화하세요.

측정항목 이름	설명
`sqlserver.lock.mode.bulk_update`	대량 업데이트 잠금 개수
`sqlserver.lock.mode.exclusive`	전용 잠금 장치의 수
`sqlserver.lock.mode.intent`	의도 잠금 개수
`sqlserver.lock.mode.schema`	스키마 잠금 개수
`sqlserver.lock.mode.shared`	공유 잠금 장치 수
`sqlserver.lock.mode.shared_intent_exclusive`	공유 의도 독점 잠금 수
`sqlserver.lock.mode.total`	모드별 활성 잠금 장치 총 개수
`sqlserver.lock.mode.update`	업데이트 잠금 수
`sqlserver.lock.resource.allocation_unit`	할당 단위 잠금 개수
`sqlserver.lock.resource.application`	애플리케이션 잠금 개수
`sqlserver.lock.resource.database_level`	데이터베이스 수준 잠금 수
`sqlserver.lock.resource.extent`	확장 수준 잠금 개수
`sqlserver.lock.resource.file`	파일 수준 잠금 수
`sqlserver.lock.resource.hobt`	힙 또는 B-트리 잠금 개수
`sqlserver.lock.resource.key`	키 레벨 잠금 장치의 수
`sqlserver.lock.resource.metadata`	메타데이터 잠금 수
`sqlserver.lock.resource.page`	페이지 수준 잠금 수
`sqlserver.lock.resource.row`	행 수준 잠금 수
`sqlserver.lock.resource.table`	테이블 레벨 잠금 개수
`sqlserver.lock.resource.total`	데이터베이스에 있는 활성 잠금 총 개수

측정항목 이름	설명
`sqlserver.locked_object`	세션에 의해 잠긴 데이터베이스 객체

이러한 정보를 수집하려면 enable_instance_metrics: true 활성화하세요.

측정항목 이름	설명
`sqlserver.memory.target`	개구리, 목표 서버 메모리(KB)
`sqlserver.memory.total`	서버 총 메모리 용량(KB)

이러한 정보를 수집하려면 enable_security_metrics: true 활성화하세요.

측정항목 이름	설명
`sqlserver.security.server_principals_count`	서버 주체(로그인) 총 수
`sqlserver.security.server_role_members_count`	서버 역할 멤버의 총 수

이러한 정보를 수집하려면 enable_tempdb_metrics: true 활성화하세요.

측정항목 이름	설명
`sqlserver.tempdb.allocation_waits_ms`	총 할당 관련 대기 시간
`sqlserver.tempdb.current_waiters`	현재 TempDB 페이지 래치를 기다리는 작업 수
`sqlserver.tempdb.data_file_count`	TempDB 데이터 파일 수
`sqlserver.tempdb.pagelatch_waits_ms`	서버 시작 이후 총 페이지 래치 대기 시간
`sqlserver.tempdb.total_size_mb`	TempDB 데이터 파일의 총 크기

이러한 정보를 수집하려면 enable_thread_pool_metrics: true 활성화하세요.

측정항목 이름	설명
`sqlserver.threadpool.current_tasks`	현재 스케줄러에게 할당된 총 작업 수
`sqlserver.threadpool.max_workers`	최대 구성된 작업자 스레드 수
`sqlserver.threadpool.runnable_tasks`	작업 실행 준비 완료, CPU 시간 대기 중
`sqlserver.threadpool.running_workers`	현재 실행 중인 작업자 스레드 수
`sqlserver.threadpool.utilization_percent`	현재 사용 중인 작업자 스레드 비율
`sqlserver.threadpool.waiting_tasks`	현재 스레드 풀 작업자 스레드를 기다리는 작업 수
`sqlserver.threadpool.work_queue_count`	스케줄러 작업 큐에 있는 총 작업 수

이러한 정보를 수집하려면 enable_user_connection_metrics: true 활성화하세요.

측정항목 이름	설명
`sqlserver.user_connections.authentication.churn_rate`	접속 끊김률(로그아웃/로그인 비율, 백분율)
`sqlserver.user_connections.authentication.logins_per_sec`	현재 초당 로그인 속도
`sqlserver.user_connections.authentication.recent_failed_logins`	지난 한 시간 동안 로그인 실패 횟수
`sqlserver.user_connections.authentication.total_failed_logins`	현재 오류 로그에 기록된 로그인 실패 시도 횟수
`sqlserver.user_connections.authentication.unique_failed_sources`	로그인 실패가 발생한 서로 다른 소스 IP 주소 수
`sqlserver.user_connections.authentication.unique_failed_users`	로그인 실패를 기록한 고유 사용자 이름 수
`sqlserver.user_connections.client.count`	클라이언트 호스트 및 프로그램별로 그룹화된 연결 수
`sqlserver.user_connections.client.unique_hosts`	활성 연결을 가진 고유 클라이언트 호스트 수
`sqlserver.user_connections.client.unique_programs`	활성 연결을 가진 고유 프로그램 수
`sqlserver.user_connections.runnable`	실행 가능한 사용자 연결 수
`sqlserver.user_connections.running`	실행 중인 사용자 연결 수
`sqlserver.user_connections.sleeping`	절전 모드 사용자 연결 수
`sqlserver.user_connections.suspended`	일시 중단된 사용자 연결 수
`sqlserver.user_connections.total`	모든 상태를 아우르는 총 사용자 연결 수
`sqlserver.user_connections.utilization.active_ratio`	활성 연결 수 대비 전체 연결 수의 비율
`sqlserver.user_connections.utilization.idle_ratio`	유휴 연결 수 대비 전체 연결 수의 비율

이러한 정보를 수집하려면 enable_wait_time_metrics: true 활성화하세요.

측정항목 이름	설명
`sqlserver.wait_stats.latch.wait_time_ms`	래치 대기 시간(밀리초)
`sqlserver.wait_stats.latch.waiting_tasks_count`	래치 대기 중인 작업 수
`sqlserver.wait_stats.waiting_tasks_count`	현재 대기 중인 작업 수

무엇 향후 계획

NRDOT을 사용하여 SQL Server 데이터베이스 모니터링을 설정한 후:

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

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

NRDOT을 이용한 Microsoft SQL Server 모니터링

시사

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

Microsoft SQL Server 모니터링을 위해 NRDOT Collector를 설정하세요.

NRDOT Collector설정하세요

중요

리눅스용

데이터베이스 사용자 구성

Windows용(SSMS)

리눅스용(sqlcmd)

NRDOT Collector구성

중요

구성 매개변수

NRDOT 수집기 재시작

팁

(선택 사항) APM-데이터베이스 상관 관계 설정

중요

(선택 사항) 비밀 관리 구성

데이터 찾기 및 사용

NRDOT 수집기 지원 명령

Windows 서비스 관리

리눅스 서비스 관리

문제점 해결

사용 가능한 지표

기본 측정항목

기본 정보는 NRDOT Collector에서 수집합니다.

추가 지표

인스턴스 측정항목

버퍼 풀 메트릭

연결 지표

데이터베이스 측정항목

장애 조치 클러스터 메트릭

잠금 메트릭

잠긴 객체 메트릭

메모리 메트릭

보안 지표

TempDB 메트릭

스레드 풀 메트릭

사용자 연결 지표

대기 통계 지표

무엇 향후 계획

전제 조건