NRDOT による Microsoft SQL Server の監視

プレビュー

この機能はまだ開発中ですが、ぜひお試しください。

この機能は現在、弊社のプレリリースポリシーに従ってプレビューの一部として提供されています。

New Relicでは、 New Relic Distribution of OpenTelemetry (NRDOT) とNew Relic Relic のデータベース監視機能を使用して、チームが Microsoft SQL Server データベースのパフォーマンスを監視できるようになりました。この統合により、NRDOT コレクターを使用して、包括的なインサイトをデータベースメトリクス、書き込みパフォーマンス、およびシステムの状態に提供します。

この NRDOT ベースのアプローチは、データベース監視のOpenTelemetry標準を活用することで既存のオンホストインテグレーション (OHI) を補完し、既存の監視スタックとの統合を容易にします。

前提条件

始める前に、次のものがあることを確認してください。

有効なNew Relicライセンスキー
サポートされているデータベースのバージョン: 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 システム
- New Relicの OTLP エンドポイントへのネットワーク接続

Microsoft SQL Server 監視用の NRDOT Collector を設定する

NRDOT コレクターを使用して、Microsoft SQL Server データベースを監視できます。 NRDOT コレクターは、New Relic 固有のコンポーネントを含む事前構成済みのディストリビューションです。

NRDOT Collector をインストールして構成するには、次の手順に従います。

NRDOT Collectorセットアップ

お使いの OS とアーキテクチャーに基づいてコレクターをインストールします。

重要

パフォーマンス監視のためにインフラレベルのメトリクスを表示するには、SQL Server インスタンスと同じホストに NRDOT Collectorインストールすることをお勧めします。

この URL をブラウザに貼り付けてインストーラをダウンロードして実行し、 New Relicの NRDOT Collector用のインストーラをダウンロードします。
```
https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-windows-amd64-latest.msi
```
ダウンロードしたファイルを見つけてダブルクリックし、NRDOT Collector をインストールします。

AMD64アーキテクチャーの場合:
- Debian/Ubuntu ベースのディストリビューションの場合:
  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 アーキテクチャーの場合:

Debian/Ubuntu ベースのディストリビューションの場合:

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監視ユーザーを作成するには、次の内容を含むnr-grant-permission.sqlという名前のファイルを Linux インスタンスに作成します。

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を以下の内容に置き換えます。

ウィンドウズ： C:\Program Files (x86)\NRDOT Collector Host\config.yaml

Linux： /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>`	New Relic OTLP エンドポイントを入力します。詳細については、 New Relic OTLP エンドポイントのドキュメントを参照してください。
`<YOUR_NEWRELIC_API_KEY>`	New Relic APIキーを入力します。
`query_monitoring_response_time_threshold`	書き込みが遅いとみなすための最小応答時間 (ミリ秒)。デフォルト値は `100` ミリ秒に設定されています。
`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とデータベースの相関関係を設定する

アプリケーションのパフォーマンスをデータベース操作と関連付けるために、データベースサービス ID を設定できます。この機能を使用すると、特定のデータベースワークロードを生成しているアプリケーションを正確に確認できます。詳細については、「 New RelicでAPMとデータベースの相関関係を取得するためのデータベースサービス ID のセットアップ」を参照してください。

重要

APM でデータベースパフォーマンスデータを表示するには、両方のエンティティが同じ New Relic アカウント内にある必要があります。エンティティが異なる New Relic アカウントにある場合、データを表示するには両方のアカウントにアクセスできる必要があります。

（オプション）シークレット管理を構成する

シークレット管理機能を使用すると、データベース資格情報などの機密情報を安全に管理できます。これにより、構成ファイルに機密データをハードコーディングすることを避け、監視設定のセキュリティを強化できます。詳細については、シークレット管理を参照してください。

データを探す、使う

データが収集されると、New Relic の UI を通じて包括的な SQL Server データベース監視にアクセスできるようになります。

New Relic で SQL Server データベースエンティティを見つけるには:

https://one.newrelic.com > All Capabilities > Databasesに移動します。
検索条件をinstrumentation.provider = opentelemetryに設定します。
エンティティのリストから SQL Server データベースを選択します。

NRDOT コレクターがサポートするコマンド

NRDOT Collectorサービスを管理したり、ログを表示したり、サービスのステータスを確認したりするには、OS に基づいて次のコマンドを使用します。

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からアンインストールします。

インストールステータスを検証するには:
- Debian/Ubuntu ベースのディストリビューションの場合:
  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 サービスを削除するには:
- Debian/Ubuntu ベースのディストリビューションの場合:
  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>

Linux の場合は、次を実行します。
bash
```
$nc -zv <YOUR_IP_ADDRESS> <YOUR_PORT_NUMBER>
```

利用可能なメトリクス

設定フラグごとに整理されたメトリクスを使用して、SQL Server データベースのパフォーマンスを監視します。デフォルトのメトリクスは、 New Relic UI機能のために自動的に収集されます。特定のスクレイパーを有効にすると、提供される追加のメトリクスを使用して、高度でより深いインサイトを取得することもできます。

デフォルトのメトリクス

これらのメトリクスはNew Relicの 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`	1秒あたりの強制パラメータ化
`sqlserver.instance.full_scans_rate`	1秒あたりの完全なテーブル/インデックススキャン
`sqlserver.instance.lock_timeouts_rate`	1秒あたりのロックタイムアウト回数
`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`	1秒あたりのトランザクション数
`sqlserver.buffer.cache_hit_ratio`	バッファキャッシュのヒット率パーセンテージ
`sqlserver.buffer.checkpoint_pages_per_sec`	1秒あたりのチェックポイントページ数
`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`	1秒あたりのログフラッシュ操作数
`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`	1秒あたりのデッドロック
`sqlserver.stats.kill_connection_errors_per_sec`	1秒あたりの接続エラーをキル
`sqlserver.stats.lock_waits_per_sec`	1秒あたりのロック待機数
`sqlserver.stats.sql_compilations_per_sec`	1秒あたりのSQLコンパイル数
`sqlserver.stats.sql_recompilations_per_sec`	1秒あたりのSQL再コンパイル
`sqlserver.stats.user_errors_per_sec`	1秒あたりのユーザーエラー数
`sqlserver.wait_stats.wait_time_ms`	合計待ち時間（ミリ秒）
`sqlserver.access.page_splits_per_sec`	1秒あたりのページ分割数
`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`	1秒あたりのバッチrequests

メトリクス名	説明
`sqlserver.connections.user`	ユーザー接続数

enable_database_metrics: trueを有効にしてこれらのメトリクスを収集します。

メトリクス名	説明
`sqlserver.database.bufferpool.size_per_database_bytes`	データベースに割り当てられた SQL Server バッファプールのサイズ
`sqlserver.database.log.bytes_flushed_per_sec`	1秒あたりにフラッシュされるログバイト数
`sqlserver.database.log.flush_waits_per_sec`	1秒あたりのフラッシュ待機操作の数
`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`	データベース内のアクティブなロックの合計

enable_lock_metrics: trueを有効にしてこれらのメトリクスを収集します。

メトリクス名	説明
`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`	現在の1秒あたりのログイン率
`sqlserver.user_connections.authentication.recent_failed_logins`	過去1時間の失敗したログイン回数
`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 データベース監視を設定した後:

データベースのメトリクスを視覚化するカスタムダッシュボードを作成する
クリティカルデータベースパフォーマンス閾値のアラートを設定する
New Relicのクエリ機能を使用してデータを探索する

この機械翻訳は、参考として提供されています。

NRDOT による Microsoft SQL Server の監視

プレビュー

前提条件 .css-21sua1{background:none;border:none;width:0;padding:0;}

Microsoft SQL Server 監視用の NRDOT Collector を設定する

NRDOT Collectorセットアップ

重要

Linuxの場合

データベースユーザーを構成する

Windows の場合 (SSMS)

Linuxの場合（sqlcmd）

NRDOT Collectorを構成する

重要

設定パラメーター

NRDOTコレクターを再起動します

ヒント

（オプション）APMとデータベースの相関関係を設定する

重要

（オプション）シークレット管理を構成する

データを探す、使う

NRDOT コレクターがサポートするコマンド

Windows サービス管理

Linuxサービス管理

トラブルシューティング

利用可能なメトリクス

デフォルトのメトリクス

NRDOT Collectorによって収集されたデフォルトのメトリクス

追加のメトリクス

インスタンスメトリック

バッファプールのメトリクス

接続メトリクス

データベースメトリック

フェイルオーバークラスタ メトリクス

ロックメトリクス

ロックされたオブジェクトのメトリクス

メモリメトリック

セキュリティメトリクス

TempDB メトリクス

スレッドプールのメトリクス

ユーザー接続メトリクス

待機統計メトリクス

次のステップ

前提条件

フェイルオーバークラスタメトリクス