Helmを使用したMSSQL監視用NRDOTのインストールと設定

mssql-otel Helmチャートを使用して、Kubernetes上にSQL Serverの監視をインストールおよび構成できます。オプションとして、チャートは監視用のログインを作成するセットアップジョブを実行することもできます。

ガイド付きインストレーション

代わりにNew Relic UIからこれをインストールするには、one.newrelic.com > Integrations & Agents > Microsoft SQL Server (Database 360) に移動してください。画面上の指示に従って、インテグレーションをセットアップします。このページでは、手動インストレーションについてのみ説明します。

重要

このチャートは、SQL Server認証（ユーザー名/パスワード）のみをサポートします。Windows認証、Windowsドメイン認証、またはgMSAはサポートしていません。コレクターは、LinuxまたはWindows、セルフホストまたはRDSのいずれで実行されているかにかかわらず、常にネットワーク経由でリモートからSQL Serverにアクセスします。そのため、SQL認証はすべての場合において同じように機能します。また、コレクターはSQL Serverホスト自体ではなく、Kubernetesデプロイメントとして実行されるため、SQL Serverのメトリクスのみを報告します（ホスト/インフラストラクチャのメトリクスはありません）。

前提条件

有効なNew Relicのライセンスキー。
Helm 3.0以降、およびKubernetesクラスタにアクセスするように設定されたkubectl。
KubernetesクラスタからSQL Serverホスト（またはRDSエンドポイント）およびポートへのネットワーク接続：
- セルフホスト：SQL Serverホストへのルーティングされたパス（VPN、ピアリング、または共有ネットワーク）が必要であり、SQL Server側のファイアウォールは接続の送信元IPを許可する必要があります。
- AWS RDS：RDSインスタンスとのVPCピアリング、トランジットゲートウェイ、または共有VPCへの配置が必要であり、RDSセキュリティグループでクラスタのエグレスソースからのSQL Serverポート（デフォルトでは1433）を許可する必要があります。
すでに作成済みの監視ログイン、またはチャートのセットアップジョブが監視ログインを作成できるようにするためのSQL Server管理者認証情報（saやRDSマスターユーザーなどのsysadminロールのログイン）のいずれかが必要です。以下の監視認証情報の設定を参照してください。

ネームスペースを作成

インストール先のネームスペースを作成します。helm install --create-namespaceは最後のインストール手順でのみネームスペースを作成するため、次の手順でシークレットを作成する前に、ネームスペースが存在している必要があります：

bash

$kubectl create namespace newrelic

ヒント

以下のすべてのコマンドで-nを渡す必要がないように、現在のkubectlコンテキストのデフォルトのネームスペースとして設定します：

bash

$kubectl config set-context --current --namespace=newrelic

監視資格情報の設定

チャートのセットアップジョブにSQL Serverの監視ログインを作成させるかどうかを決定し、作成させない場合は、その資格情報をどのように提供するかを決定してください：

この方法ではセットアップジョブがないため、ここで監視ログインが作成されることはありません。このチャートはSQL Server認証のみをサポートしているため、インストールする前に、環境に応じて Linuxセルフホスト、 Windowsセルフホスト、 Linux RDS 、または Windows RDS のSQL Server認証の監視ユーザーの作成ステップを使用して、ご自身で監視ログインを作成してください。

次のステップで、監視用のユーザー名とパスワードを直接values.yamlに設定します。

この方法でも、セットアップジョブはありません。まず、上記の plain-credentials メソッドとまったく同じように、ご自身で監視ログインを作成してください。唯一の違いは、資格情報の保存場所です：values.yamlにプレーンテキストで保存する代わりに、Kubernetesシークレットに保存します：

bash

$kubectl create secret generic mssql-monitor-creds \
>  --from-literal=username=<MONITORING_USERNAME> \
>  --from-literal=password='<MONITORING_PASSWORD>' \
>  -n newrelic

この方法では、チャートのセットアップジョブが、SQL Serverの管理者資格情報を使用して監視ログインを作成します。監視と管理者の両方の資格情報は、Kubernetesシークレットとして提供する必要があります：セットアップジョブはプレーンテキストの管理者資格情報を受け入れることはなく、セットアップジョブを有効にするにはシークレットベースの監視資格情報も必要になります。

監視のユーザー名とパスワードを使用してシークレットを作成します。これは、セットアップジョブが作成し、コレクターが接続に使用するIDです：
bash
```
$kubectl create secret generic mssql-monitor-creds \
>  --from-literal=username=<MONITORING_USERNAME> \
>  --from-literal=password='<MONITORING_PASSWORD>' \
>  -n newrelic
```
セットアップジョブは、Kubernetesシークレット経由でのみ管理者資格情報を受け入れます（values.yamlにプレーンテキストのユーザー名/パスワードを含めることはできません）。この資格情報はログインを作成し、幅広いVIEWアクセスを付与できるため、独自のシークレットとして作成してください。セルフホスト型のSQL Serverにはsysadminロール（または同等のもの）のログインを使用し、AWS RDS上のSQL ServerにはRDSマスターユーザーを使用してください：
bash
```
$kubectl create secret generic mssql-admin-creds \
>  --from-literal=username=<ADMIN_USERNAME> \
>  --from-literal=password='<ADMIN_PASSWORD>' \
>  -n newrelic
```

Helmの値を設定します

環境に合わせてmssql.topologyを設定してください：

価値	説明
`self-hosted`	ネットワーク経由でアクセスするセルフホスト型のSQL Server（LinuxまたはWindowsホスト）。
`rds`	AWS RDS上のSQL Server。

前の手順で選択した資格情報メソッドに一致するvalues.yamlを使用します：

licenseKey: <YOUR_LICENSE_KEY>
otlpEndpoint: https://otlp.nr-data.net:4318

mssql:
  topology: <self-hosted|rds>
  server: <YOUR_DB_HOST>
  port: <YOUR_DB_PORT>
  username: <YOUR_MONITORING_USERNAME>
  password: <YOUR_MONITORING_PASSWORD>

# No setup job runs, so create the monitoring login yourself
# before installing the chart.
setupJob:
  enabled: false

licenseKey: <YOUR_LICENSE_KEY>
otlpEndpoint: https://otlp.nr-data.net:4318

mssql:
  topology: <self-hosted|rds>
  server: <YOUR_DB_HOST>
  port: <YOUR_DB_PORT>
  existingSecret: mssql-monitor-creds

# No setup job runs, so the monitoring login referenced by
# this secret must already exist - create it yourself
# before installing the chart.
setupJob:
  enabled: false

licenseKey: <YOUR_LICENSE_KEY>
otlpEndpoint: https://otlp.nr-data.net:4318

mssql:
  topology: <self-hosted|rds>
  server: <YOUR_DB_HOST>
  port: <YOUR_DB_PORT>
  existingSecret: mssql-monitor-creds

setupJob:
  enabled: true
  image:
    # -- sqlcmd image. No default: see the chart's README for why
    # (mcr.microsoft.com/mssql-tools:latest is freely pullable but
    # stale and unmaintained).
    repository: ""
    tag: ""
    pullPolicy: IfNotPresent
  sqlAdmin:
    existingSecret: mssql-admin-creds

パラメータ	説明
`licenseKey`	New Relicライセンスキー。
`otlpEndpoint`	ご使用のリージョンのOTLP/HTTPエンドポイント（スキームを含む完全なURL）： `https://otlp.nr-data.net:4318` (US)または `https://otlp.eu01.nr-data.net:4318` (EU)。詳細については、 New Relic OTLPエンドポイントのドキュメントを参照してください。
`mssql.server` / `mssql.port`	クラスタから到達可能な、SQL Serverホスト（またはRDSエンドポイント）とポート。
`mssql.tls.enabled` / `mssql.tls.trustServerCertificate`	オプション。SQL Serverへの接続を暗号化するには `enabled: true` を、証明書の検証をスキップするには `trustServerCertificate: true` を設定してください（テスト環境での自己署名証明書に便利です）。
`setupJob.image.repository` / `setupJob.image.tag`	セットアップジョブで使用される `sqlcmd` 対応イメージ。デフォルトはありません：Microsoftが自由にプルできる `mcr.microsoft.com/mssql-tools:latest` は2017年のものであり、メンテナンスされていません。そのため、使用する前にその古さ（パッチ未適用のCVEを含む）に問題がないことを確認するか、Microsoftの `mssql-tools18` aptパッケージから最新のイメージを自分でビルドしてください。セットアップジョブが有効になっている、シークレットベースの認証情報の場合にのみ必要です。

ヒント

mssql.collectionInterval、mssql.maxConcurrentQueries、およびadditionalReceiverConfigエスケープハッチを含む、利用可能なすべての設定オプションについては、チャートのvalues.yamlをご覧ください。

(オプション) 1つのリリースから複数のインスタンスをモニターする

1つのリリースで単一のコレクターポッドから複数のSQL Serverインスタンス（セルフホスト型またはRDS）をモニターするには、mssql.*の代わりにmssqlMulti.enabled: trueを設定します。2つのモードは相互に排他的です：同じリリースでmssql.serverとmssqlMulti.enabled: trueを設定しないでください。

マルチインスタンスモードには、プレーンなユーザー名/パスワードのパスはありません：各インスタンスには、監視資格情報を含む独自のKubernetesシークレットが必要です。セットアップジョブで各監視ログインも作成するかどうかを決定します：

インストールする前に、各インスタンスの監視ログインシークレットをご自身で作成してください（values.yaml で指定する name に合わせて、インスタンスごとに繰り返します）：

bash

$kubectl create secret generic db1-monitor-creds \
>  --from-literal=username=<MONITORING_USERNAME> \
>  --from-literal=password='<MONITORING_PASSWORD>' \
>  -n newrelic
$# Repeat for every instance (db2-monitor-creds, ...)

licenseKey: <YOUR_LICENSE_KEY>
otlpEndpoint: https://otlp.nr-data.net:4318

# EDIT the two example entries below (or add more) to match
# your real instances - each `name` must be unique within
# this release and match the Secret you created for it.
mssqlMulti:
  enabled: true
  topology: <self-hosted|rds>
  databases:
    - name: db1
      server: <YOUR_DB_1_HOST>
      existingSecret: db1-monitor-creds
    - name: db2
      server: <YOUR_DB_2_HOST>
      existingSecret: db2-monitor-creds

# No admin credential is configured here since the setup
# job is disabled - create each instance's monitoring login
# yourself first.
setupJob:
  enabled: false

各インスタンスには、独自の監視ログインシークレットと独自の管理者資格情報シークレットの両方が必要です（インスタンスごとに繰り返します）：

bash

$kubectl create secret generic db1-monitor-creds \
>  --from-literal=username=<MONITORING_USERNAME> \
>  --from-literal=password='<MONITORING_PASSWORD>' \
>  -n newrelic
>kubectl create secret generic db1-admin-creds \
>  --from-literal=username=<ADMIN_USERNAME> \
>  --from-literal=password='<ADMIN_PASSWORD>' \
>  -n newrelic
$# Repeat for every instance (db2-monitor-creds, db2-admin-creds, ...)

licenseKey: <YOUR_LICENSE_KEY>
otlpEndpoint: https://otlp.nr-data.net:4318

# EDIT the two example entries below (or add more) to match
# your real instances - each `name` must be unique within
# this release and match the Secrets you created for it.
mssqlMulti:
  enabled: true
  topology: <self-hosted|rds>
  databases:
    - name: db1
      server: <YOUR_DB_1_HOST>
      existingSecret: db1-monitor-creds
      sqlAdmin:
        existingSecret: db1-admin-creds
    - name: db2
      server: <YOUR_DB_2_HOST>
      existingSecret: db2-monitor-creds
      sqlAdmin:
        existingSecret: db2-admin-creds

setupJob:
  enabled: true
  image:
    repository: ""
    tag: ""

パラメータ	説明
`mssqlMulti.enabled`	1つのリリースから複数のインスタンスをモニターするには、 `mssql.*` の代わりに `true` に設定します。デフォルトは `false` です。
`mssqlMulti.topology`	`self-hosted` または `rds` 、 `mssql.topology` と同じ意味であり、このリリースのすべてのインスタンスで共有されます。
`mssqlMulti.databases`	モニターするインスタンスの一覧。各エントリには一意の `name` 、 `server` （ `port` のデフォルトは `1433` ）、および `existingSecret` が必要です； `setupJob.enabled` が `true` の場合にのみ、エントリごとに `sqlAdmin.existingSecret` を追加してください。

パラメータ

説明

mssqlMulti.enabled

1つのリリースから複数のインスタンスをモニターするには、

mssql.*

の代わりに

true

に設定します。デフォルトは

false

です。

mssqlMulti.topology

self-hosted

または

rds

、

mssql.topology

と同じ意味であり、このリリースのすべてのインスタンスで共有されます。

mssqlMulti.databases

モニターするインスタンスの一覧。各エントリには一意の

name

、

server

（

port

のデフォルトは

1433

）、および

existingSecret

が必要です；

setupJob.enabled

が

true

の場合にのみ、エントリごとに

sqlAdmin.existingSecret

を追加してください。

ヒント

スクレイプ設定（収集間隔、TLS、メトリクス）は、mssqlMulti.databasesのすべてのインスタンスに同一に適用されます。インスタンスごとのオーバーライドはありません。異なる必要があるものにはadditionalReceiverConfigを使用します。セットアップジョブは、リリースごとに1回ではなく、インスタンス（<release>-setup-<name>）ごとに1回実行されます。

Helmチャートをインストールする

New Relic Helm リポジトリを追加します。

bash

$helm repo add newrelic https://helm-charts.newrelic.com
$helm repo update

values.yamlファイルを使用してチャートをインストールします：

bash

$helm upgrade --install mssql-otel newrelic/mssql-otel \
>  -n newrelic \
>  --create-namespace \
>  -f values.yaml

インストレーションを確認する

セットアップジョブが完了し（有効な場合）、コレクターポッドが実行されていることを確認します：
bash
```
$kubectl get jobs,pods -n newrelic --watch
```

データが到着していることを確認するには、クエリビルダーでこのクエリを実行してください：

SELECT count(*) FROM Metric
WHERE metricName LIKE 'sqlserver.%'
AND instrumentation.provider = 'opentelemetry'
SINCE 10 minutes ago

データを探す、使う

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

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

one.newrelic.com > All capabilities > Databasesに移動します。
Entity typeドロップダウンからMSSQL instanceを選択し、Applyをクリックします。
エンティティのリストから SQL Server データベースを選択します。
NRDOTを使用してSQL Serverの監視をセットアップした後、次のことができます：
- データベースのメトリクスを視覚化するカスタムダッシュボードを作成する
- クリティカルデータベースパフォーマンス閾値のアラートを設定する
- New Relicのクエリ機能を使用して、データを探索します

メトリクスリファレンス

NRDOT Collectorによって収集される利用可能なメトリクスについて説明します。

トラブルシューティング

New RelicでMSSQL監視セットアップをトラブルシューティングする方法について説明します。

APMとデータベースの相関を設定する

New Relicでアプリケーションパフォーマンスとデータベース操作を関連付ける方法について説明します。

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

Helmを使用したMSSQL監視用NRDOTのインストールと設定

ガイド付きインストレーション

重要

前提条件

ネームスペースを作成

ヒント

監視資格情報の設定

セットアップジョブなし：プレーンなユーザー名とパスワード

セットアップジョブなし：シークレットベースの認証情報

自動セットアップジョブ

Helmの値を設定します

セットアップジョブなし：プレーンなユーザー名とパスワード

セットアップジョブなし：シークレットベースの認証情報

自動セットアップジョブ

ヒント

(オプション) 1つのリリースから複数のインスタンスをモニターする

セットアップジョブなし

自動セットアップジョブ

ヒント

Helmチャートをインストールする

インストレーションを確認する

データを探す、使う

メトリクスリファレンス

トラブルシューティング

APMとデータベースの相関を設定する

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

Helmを使用したMSSQL監視用NRDOTのインストールと設定

ガイド付きインストレーション

重要

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

ネームスペースを作成

ヒント

監視資格情報の設定

セットアップジョブなし：シークレットベースの認証情報

自動セットアップジョブ

Helmの値を設定します

セットアップジョブなし：プレーンなユーザー名とパスワード

セットアップジョブなし：シークレットベースの認証情報

自動セットアップジョブ

ヒント

(オプション) 1つのリリースから複数のインスタンスをモニターする

セットアップジョブなし

自動セットアップジョブ

ヒント

Helmチャートをインストールする

インストレーションを確認する

データを探す、使う

関連ドキュメント

メトリクスリファレンス

トラブルシューティング

APMとデータベースの相関を設定する

前提条件