互換性と前提条件

プレビュー

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

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

NRDOTでMySQLの監視を開始する前に、環境がこれらの要件を満たしていることを確認してください。

前提条件

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

有効なNew Relicライセンスキー
NRDOT CollectorをインストールするホストとMySQLデータベース間のネットワーク接続。NRDOT CollectorをMySQLデータベースとは異なるホストにインストールする予定の場合は、ネットワークアクセス要件を参照してください。
New Relic OTLPエンドポイントのドキュメントへのネットワーク接続
このインテグレーションは、New Relicパブリックプレビュープログラムの一環としてご利用いただけます。プレビューとトライアルページからオプトインするには、組織マネージャーに確認してください。

サポート対象MySQLバージョン

レシーバーは最初の接続時にデータベース製品とバージョンを検出し、それに応じて動作を調整します — サポートされていないバージョンや古いバージョンでも機能しますが、機能は制限されます：

バージョン	クエリプランの有効化 `db.server.top_query`	Traceparentの伝播	`client.port` / `network.peer.port`	レプリカステータスの構文
`5.7.x`	いいえ	はい	0	`SHOW SLAVE STATUS`
`8.0.0` – `8.0.2`	いいえ	はい	0	`SHOW SLAVE STATUS`
`8.0.3` – `8.0.21`	はい	はい	0	`SHOW SLAVE STATUS`
`8.0.22+`	はい	はい	入力済み	`SHOW REPLICA STATUS`
`8.4.x`	はい	はい	入力済み	`SHOW REPLICA STATUS`
`9.x`	はい	はい	入力済み	`SHOW REPLICA STATUS`

重要

バージョン検出は致命的ではありません：失敗した場合、レシーバーはエラーになるのではなく、MySQL < 8の動作にフォールバックします。

ネットワークアクセス要件

デフォルトでは、NRDOTはTCP経由で接続します（レシーバー設定のtransport: tcp、デフォルト）。コレクターがデータベースと同じホストで実行されている場合は、代わりにtransport: unixを設定し、endpointをデータベースのUnixドメインソケット（たとえば/var/run/mysqld/mysqld.sock）に向けることができます。これにより、以下のネットワークチェックを完全に回避できます。その他のデプロイメント — コレクターとデータベースが異なるホスト、コンテナ、またはVPCにある場合 — には、TCPが必要です。

デプロイメント	チェックポイント
EC2上の自己管理型MySQL	セキュリティグループ : コレクターが別のEC2インスタンスで実行されている場合は、コレクターのソース — 自身のセキュリティグループID（同一VPC、生のIPよりも推奨） — からDBポート（デフォルトは `3306` ）へのインバウンドルールを追加します。同じインスタンスでサイドカーとして実行されている場合は、ルールは必要ありません。また、 `my.cnf` の `bind-address` も確認してください：多くのディストリビューションのデフォルトでは `bind-address = 127.0.0.1` が設定されており、ローカル以外のTCP接続を拒否します — リモートのコレクターが到達できるようにするには、インスタンスのプライベートIPまたは `0.0.0.0` に設定してください。
Amazon RDS/Aurora for MySQL	VPCセキュリティグループ : コレクターのセキュリティグループまたはプライベートIPから、RDSインスタンスのポート（デフォルトは `3306` ）にインバウンドルールを追加します；RDSには編集するOSレベルの `my.cnf` がないため、これが唯一のネットワークゲートになります。権限付与はRDSマスターユーザーから行う必要があります — RDSには `root` アカウントがありません。制限された権限 : `SUPER` および `FILE` は、RDSエンジンのバージョンとパラメーターグループによっては制限されるか、利用できません。 TLS : "Require SSL/TLS"が強制されるRDSインスタンスでは、コレクターがAmazonのRDS CAを信頼する必要があります — `tls.ca_file` （または `tls.ca_pem` ）を Amazon RDS証明書バンドルに設定し、 `tls.insecure` / `tls.insecure_skip_verify` は `false` のままにします。
リモート/クロスホストのデプロイメント	MySQLは、ユーザー名が同じであっても、 `'<user>'@'localhost'` と `'<user>'@'%'` （または特定のホスト/CIDR）を別のアカウントとして扱います — 監視ユーザーを `'<user>'@'localhost'` として作成すると、他の場所で実行されているコレクターからの認証に暗黙的に失敗し、間違ったパスワードと区別がつかないアクセス拒否エラーが発生します。 `'<user>'@'%'` を使用するか、コレクターの特定のプライベートIP/CIDRにスコープを設定してください。

デプロイメント

チェックポイント

EC2上の自己管理型MySQL

セキュリティグループ

: コレクターが別のEC2インスタンスで実行されている場合は、コレクターのソース — 自身のセキュリティグループID（同一VPC、生のIPよりも推奨） — からDBポート（デフォルトは

3306

）へのインバウンドルールを追加します。同じインスタンスでサイドカーとして実行されている場合は、ルールは必要ありません。また、

my.cnf

の

bind-address

も確認してください：多くのディストリビューションのデフォルトでは

bind-address = 127.0.0.1

が設定されており、ローカル以外のTCP接続を拒否します — リモートのコレクターが到達できるようにするには、インスタンスのプライベートIPまたは

0.0.0.0

に設定してください。

Amazon RDS/Aurora for MySQL

VPCセキュリティグループ

: コレクターのセキュリティグループまたはプライベートIPから、RDSインスタンスのポート（デフォルトは

3306

）にインバウンドルールを追加します；RDSには編集するOSレベルの

my.cnf

がないため、これが唯一のネットワークゲートになります。

権限付与

はRDSマスターユーザーから行う必要があります — RDSには

root

アカウントがありません。

制限された権限

SUPER

および

FILE

は、RDSエンジンのバージョンとパラメーターグループによっては制限されるか、利用できません。

TLS

: "Require SSL/TLS"が強制されるRDSインスタンスでは、コレクターがAmazonのRDS CAを信頼する必要があります —

tls.ca_file

（または

tls.ca_pem

）を

Amazon RDS証明書バンドル

に設定し、

tls.insecure

tls.insecure_skip_verify

は

false

のままにします。

リモート/クロスホストのデプロイメント

MySQLは、ユーザー名が同じであっても、

'<user>'@'localhost'

と

'<user>'@'%'

（または特定のホスト/CIDR）を

別のアカウント

として扱います — 監視ユーザーを

'<user>'@'localhost'

として作成すると、他の場所で実行されているコレクターからの認証に暗黙的に失敗し、間違ったパスワードと区別がつかないアクセス拒否エラーが発生します。

'<user>'@'%'

を使用するか、コレクターの特定のプライベートIP/CIDRにスコープを設定してください。

重要

稼働中のAmazon RDS for MySQLインスタンスに対して検証済み：RDSのmysql8.0パラメーターグループファミリーは、performance_schema_consumer_*パラメーターをまったく公開していません — そこで設定できるのは、サイジング/バッファーパラメーターと、performance_schema、slow_query_log、およびlong_query_timeのみです。これは、events_waits_current（mysql.events_waits_current.timer_wait、および一般的な待機ベースのダッシュボードに必要）はRDSの実行時にのみオンにでき、再起動やフェイルオーバー後には維持されないことを意味します。

推奨されるサーバーサイドコンフィグレーション

レシーバーが利用可能なすべてのメトリクスとクエリプランを収集できるように、これらのMySQLサーバーのパラメーターを構成します。次の表に、パラメーターとその推奨値を示します：

パラメータ	推奨値	理由
`performance_schema`	有効	クエリサンプル、トップクエリ、およびブロッキング検出はすべてこれに依存しています
`max_digest_length`	`4096`	MySQLが切り捨てる前のより長いダイジェストテキスト
`performance_schema_max_digest_length`	`4096`	パフォーマンススキーマ層でも同様
`performance_schema_max_sql_text_length`	`4096`	キャプチャされたステートメントが切り捨てられた場合、レシーバーはそのステートメントの `EXPLAIN` を完全にスキップします。デフォルトの `1024` バイトでは、長いステートメントのクエリプランが警告なしに消失します

次のステップ

環境がこれらの前提条件を満たしていることを確認したら：

インストール方法を選択してください:

収集される利用可能なメトリクスを確認してください。
書き込みステートメントのクエリプランやロック待機時間の追跡などのオプション機能については、高度な設定をご覧ください
一般的な問題については、トラブルシューティングガイドをご覧ください

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