Helmを使用したMySQL監視用のNRDOTのインストールと構成

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

重要

チャートは、ネットワーク経由でリモートからMySQLに到達するKubernetesデプロイメントとしてコレクターをデプロイします。その結果、常にTCP経由で接続し（Unixソケットの監視はサポートされていません）、MySQLのメトリクスのみを報告します（MySQLが実行されているマシンのホストやインフラストラクチャのメトリクスは報告しません）。mysql.*を使用すると、リリースごとに1つのMySQLインスタンスをモニターします。1つのリリースから複数のインスタンスをモニターするには、代わりにmysqlMulti.*を使用してください（以下の「1つのリリースから複数のインスタンスをモニターする」を参照してください）。

前提条件

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

ネームスペースを作成

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

bash

$kubectl create namespace newrelic

ヒント

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

bash

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

監視資格情報の設定

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

この方法ではセットアップジョブがないため、ここで監視ユーザーが自動的に作成されることはありません。チャートをインストールする前に、セルフホスト型MySQL または RDS上のMySQL の データベースユーザーの構成ステップを使用して自分で作成するか、アドミンユーザーとして同等のSQLを実行してください：

CREATE USER IF NOT EXISTS 'newrelic'@'%' IDENTIFIED BY '<password>';
GRANT SELECT ON performance_schema.* TO 'newrelic'@'%';
FLUSH PRIVILEGES;

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

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

bash

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

この方法では、チャートのセットアップジョブがMySQLの管理者認証情報を使用して監視ユーザーを作成します。監視および管理者の認証情報はどちらもKubernetesシークレットとして提供する必要があります：セットアップジョブはプレーンテキストの管理者認証情報を受け入れることはなく、これを有効にするにはシークレットベースの監視認証情報も必要になります。

監視のユーザー名とパスワードを使用してシークレットを作成します。これは、セットアップジョブが作成し、コレクターが接続に使用するIDです：
bash
```
$kubectl create secret generic mysql-monitor-creds \
>  --from-literal=username=<MONITORING_USERNAME> \
>  --from-literal=password='<MONITORING_PASSWORD>' \
>  -n newrelic
```
セットアップジョブは、Kubernetesシークレットを介した管理者認証情報のみを受け入れます（values.yamlにプレーンテキストのユーザー名/パスワードを含めることはできません）。この認証情報はCREATE USERを実行し、広範なperformance_schemaアクセスを許可できるため、独自のシークレットとして作成してください。セルフホスト型のMySQLにはrootアカウントを使用し、AWS RDS上のMySQLにはRDSマスターユーザーを使用します：
bash
```
$kubectl create secret generic mysql-admin-creds \
>  --from-literal=username=<ADMIN_USERNAME> \
>  --from-literal=password='<ADMIN_PASSWORD>' \
>  -n newrelic
```

Helmの値を設定します

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

価値	説明
`self-hosted`	ネットワーク経由で到達するセルフホスト型MySQL。
`rds`	AWS RDS上のMySQLまたはAurora。

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

licenseKey: <YOUR_LICENSE_KEY>
otlpEndpoint: otlp.nr-data.net:4317

mysql:
  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 user yourself
# before installing the chart.
setupJob:
  enabled: false

licenseKey: <YOUR_LICENSE_KEY>
otlpEndpoint: otlp.nr-data.net:4317

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

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

licenseKey: <YOUR_LICENSE_KEY>
otlpEndpoint: otlp.nr-data.net:4317

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

setupJob:
  enabled: true
  mysqlAdmin:
    existingSecret: mysql-admin-creds
  # -- Also grants UPDATE on performance_schema.setup_consumers,
  # needed for wait-time data. Optional.
  enableWaitTimeMetrics: false

パラメータ	説明
`licenseKey`	New Relicライセンスキー。
`otlpEndpoint`	ご使用のリージョンのOTLP/gRPCエンドポイントは、スキームなしの単なる `host:port` として指定します： `otlp.nr-data.net:4317` （米国）または `otlp.eu01.nr-data.net:4317` （EU）。詳細については、 New Relic OTLPエンドポイントのドキュメントを参照してください。
`mysql.server` / `mysql.port`	クラスタから到達可能な、MySQLホスト（またはRDSエンドポイント）とポート。
`mysql.database`	オプション。監視を1つのデータベースに制限します。すべてのデータベースをモニターするには、空のままにします。
`additionalReceiverConfig.tls.*`	オプション。チャートは `tls` ブロックを宣言しておらず、 `mysql.tls.` 値を持っていません。レシーバー独自のデフォルトが適用され（ `insecure: false` 、 `insecure_skip_verify: false` ）、証明書の検証を伴う暗号化された接続が必要になります。 `additionalReceiverConfig` を使用してこれらをオーバーライドします： `additionalReceiverConfig.tls.insecure_skip_verify=true` を設定して証明書の検証をスキップするか（接続のセキュリティを弱めるため、自己署名証明書を使用したテスト用のみ）、 `additionalReceiverConfig.tls.ca_file` を設定してコレクターコンテナにマウントされたCAバンドルを指すようにします。 SSL/TLSの強制を必要とするAmazon RDSインスタンスでは、`ca_file`をAmazonのRDS CAバンドルに設定する必要があります* 。AmazonがCAをローテーションする際にハードコードされたバンドルが古くなるリスクがあるため、チャートには意図的にデフォルトのバンドルが含まれていません。
`setupJob.image.repository` / `setupJob.image.tag`	セットアップジョブで使用される `mysql` CLIイメージ。デフォルトは公式で積極的に保守されている `mysql:8.4` であるため、セットアップジョブを有効にする際に追加のイメージフラグは必要ありません。異なるバージョンが必要な場合のみオーバーライドしてください。
`setupJob.enableWaitTimeMetrics`	オプション。待機時間データに必要な `performance_schema.setup_consumers` に対する `UPDATE` も付与します。

ヒント

mysql.collectionInterval、mysql.explainMode、statementEvents/querySampleCollection/topQueryCollectionブロック、およびadditionalReceiverConfigエスケープハッチを含む、利用可能なすべての設定オプションについては、チャートのvalues.yamlを参照してください。

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

1つのリリース内の単一のコレクターポッドから複数のMySQLインスタンス（セルフホストまたはRDS）をモニターするには、mysql.*の代わりにmysqlMulti.enabled: trueを設定します。2つのモードは相互に排他的です：同じリリースでmysql.serverとmysqlMulti.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: otlp.nr-data.net:4317

# 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.
mysqlMulti:
  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 user
# 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: otlp.nr-data.net:4317

# 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.
mysqlMulti:
  enabled: true
  topology: <self-hosted|rds>
  databases:
    - name: db1
      server: <YOUR_DB_1_HOST>
      existingSecret: db1-monitor-creds
      mysqlAdmin:
        existingSecret: db1-admin-creds
    - name: db2
      server: <YOUR_DB_2_HOST>
      existingSecret: db2-monitor-creds
      mysqlAdmin:
        existingSecret: db2-admin-creds

setupJob:
  enabled: true

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

パラメータ

説明

mysqlMulti.enabled

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

mysql.*

の代わりに

true

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

false

です。

mysqlMulti.topology

self-hosted

または

rds

、

mysql.topology

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

mysqlMulti.databases

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

name

、

server

（

port

のデフォルトは

3306

）、および

existingSecret

が必要です；

database

はオプションで監視を1つのデータベースに制限します（

mysql.database

と同じ意味です）；

setupJob.enabled

が

true

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

mysqlAdmin.existingSecret

を追加します。

ヒント

スクレイプ設定（収集間隔、TLS、ステートメントイベント、クエリサンプル収集、トップクエリ収集）は、mysqlMulti.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 mysql-otel newrelic/mysql-otel \
>  -n newrelic \
>  --create-namespace \
>  -f values.yaml

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

セットアップジョブが完了し（有効な場合）、コレクターポッドが実行されていることを確認します：
bash
```
$kubectl get jobs,pods -n newrelic --watch
```
データが到着していることを確認するには、クエリビルダーでこのクエリを実行してください：
```
SELECT count(*) FROM Metric
WHERE metricName LIKE 'mysql.%'
AND instrumentation.provider = 'opentelemetry'
SINCE 10 minutes ago
```

データを探す、使う

データの収集が開始されると、New Relic UIから包括的なMySQLデータベース監視にアクセスできます。

New RelicでMySQLデータベースエンティティを見つけるには：

one.newrelic.com > All capabilities > Databasesに移動します。
Entity typeドロップダウンからMySQL instanceを選択し、Applyをクリックします。
エンティティのリストからMySQLデータベースを選択します。

NRDOTを使用したMySQLモニタリングの概要

New Relicを使用したMySQL監視で利用可能なすべてのインストレーション方法についてご確認ください。

CLIインストール

単一のNew Relic CLIコマンドを使用して、MySQL監視をインストールおよび設定する方法を学びます。

Ansibleのインストール

newrelic.newrelic_installを使用して、MySQL監視を大規模にインストールおよび設定する方法をご確認ください。Ansibleロール。

Chefのインストール

newrelic-install Chefクックブックを使用して、MySQL監視を大規模にインストールおよび設定する方法について説明します。

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

Helmを使用したMySQL監視用のNRDOTのインストールと構成

重要

前提条件

ネームスペースを作成

ヒント

監視資格情報の設定

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

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

自動セットアップジョブ

Helmの値を設定します

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

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

自動セットアップジョブ

ヒント

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

セットアップジョブなし

自動セットアップジョブ

ヒント

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

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

データを探す、使う

NRDOTを使用したMySQLモニタリングの概要

CLIインストール

Ansibleのインストール

Chefのインストール

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

Helmを使用したMySQL監視用のNRDOTのインストールと構成

重要

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

ネームスペースを作成

ヒント

監視資格情報の設定

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

自動セットアップジョブ

Helmの値を設定します

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

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

自動セットアップジョブ

ヒント

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

セットアップジョブなし

自動セットアップジョブ

ヒント

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

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

データを探す、使う

関連ドキュメント

NRDOTを使用したMySQLモニタリングの概要

CLIインストール

Ansibleのインストール

Chefのインストール

前提条件