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

New Relic CLIを使用して、MySQL監視用のNRDOT Collectorをインストールおよび設定できます。CLIは単一のコマンドで、コレクターをインストールし、監視ユーザーを作成し、コレクターを設定します。

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

代わりにNew Relic UIからインストールするには、one.newrelic.com > Integrations & Agents > MySQL (Database 360) に移動してください。このページでは、手動インストレーションについてのみ説明します。

前提条件

有効なライセンスキーを持つNew Relicアカウント。
New Relic アカウントID。
MySQL 5.7以降。
curlとsystemdがインストールされ、mysqlクライアントが利用可能な、Debian/UbuntuまたはRHEL/CentOSを実行しているLinuxコレクターホスト。
セルフホスト型MySQLの場合：MySQLサーバーへの管理者アクセス権（rootアカウントまたは同等のもの）。
AWS RDS/Aurora MySQLの場合：コレクターホストからRDSエンドポイントへのネットワーク接続（RDSセキュリティグループのMySQLポートへのインバウンドアクセス）、およびRDSマスターのユーザー名とパスワード。
ご利用のリージョンのNew Relic OTLPエンドポイントへのネットワーク接続。

詳細な要件については、「互換性と前提条件」を参照してください。

NRDOT Collectorのインストールと設定

このレシピは、1つのコレクターから1つ以上のMySQLインスタンスをモニターします。単一のホスト/ポート/認証情報のセットの入力を求める代わりに、事前に作成した2つのファイルを読み込みます：モニターするすべてのインスタンスをリストしたインスタンスファイル（YAML）と、それぞれのアドミンログインとパスワードが含まれ、一致するようにインデックス付けされたシークレットファイル（KEY=VALUE）です。

インスタンスファイルを作成します。このコレクターでモニターするMySQLインスタンスごとに1つのエントリを追加してください；単一のインスタンスのみを実行している場合は、1つのエントリのみを追加してください：
bash
```
$cat > ~/mysql-instances.yml << 'EOF'
$instances:
$  - host: localhost
$    port: 3306
$    login_name: newrelic
$EOF
```
インスタンスファイルの順序と一致するようにインデックスを付けた、各インスタンスのアドミンログイン（任意のフルアドミンユーザーを使用できます；rootである必要はありません）とパスワードを含むシークレットファイルを作成します：
bash
```
$umask 077
$cat > ~/mysql-secrets.env << 'EOF'
$NR_CLI_MYSQL_ADMIN_USER_1=root
$NR_CLI_MYSQL_ADMIN_PASSWORD_1=YourRootPassword1
$EOF
$chmod 600 ~/mysql-secrets.env
```

bash

$curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n nrdot-collector-mysql

重要

このインストーラはパスワードを使用してTCP経由でMySQLに接続するため、シークレットファイルの管理者アカウントはパスワードベースの認証を使用する必要があります。一部のDebian/Ubuntuインストールでは、root@localhostはデフォルトでauth_socketプラグイン（パスワードなし、ローカルソケットのみ）になりますが、これはここでは機能しません。まず、これをrootとしてローカルで実行して切り替えてください：

bash

$mysql -u root -e "ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '<password>';"

Access deniedで失敗した場合、mysql-serverパッケージは、/etc/mysql/debian.cnfに既知の管理者資格情報を持つdebian-sys-maintアカウントも作成します。代わりにそれを使用してください：

bash

$mysql --defaults-file=/etc/mysql/debian.cnf -e "ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '<password>';"

CLIは、以下の変数について対話的にプロンプトを表示します。非対話的に実行するために、事前に環境変数として設定することもできます。

変数	説明	デフォルト
`NR_CLI_MYSQL_CONFIG_PRESET`	NRDOTの設定： `1` Basic用 `2` Advanced用	`1`
`NR_CLI_MYSQL_INSTANCES_FILE`	必須。インスタンスYAMLファイルへのパス。	なし
`NR_CLI_MYSQL_SECRETS_FILE`	必須。シークレットファイルへのパス（`KEY=VALUE`、インスタンスごとに1つの管理者ログイン/パスワードのペア）。	なし

変数

説明

デフォルト

NR_CLI_MYSQL_CONFIG_PRESET

NRDOTの設定：

1 Basic用
2 Advanced用

1

NR_CLI_MYSQL_INSTANCES_FILE

必須。インスタンスYAMLファイルへのパス。

なし

NR_CLI_MYSQL_SECRETS_FILE

必須。シークレットファイルへのパス（KEY=VALUE、インスタンスごとに1つの管理者ログイン/パスワードのペア）。

なし

ヒント

このコレクターから複数のMySQLインスタンスをモニターするには、インスタンスファイルにエントリーを追加し、シークレットファイルに一致する番号付きの認証情報（_2、_3、...）を追加します。チェックに失敗したインスタンスは、インストール全体を中止するのではなく、理由がログに記録されてスキップされます。インストールが完全に失敗するのは、どのインスタンスもパスしなかった場合のみです。

このレシピは、セルフホスト型と同じインスタンスファイル/シークレットファイルのパターンを使用して、単一のコレクターから1つ以上のRDS MySQLまたはAuroraエンドポイントをモニターします。

RDSエンドポイントをhostとして使用して、インスタンスファイルを作成します。単一のRDSインスタンスのみを監視する場合は、エントリは1つだけです：
bash
```
$cat > ~/mysql-instances.yml << 'EOF'
$instances:
$  - host: mydb1.abcdefg12345.us-east-1.rds.amazonaws.com
$    port: 3306
$    login_name: newrelic
$EOF
```
各インスタンスのRDSマスターユーザー名とパスワードを含むシークレットファイルを作成し、インスタンスファイルの順序と一致するようにインデックスを付けます：
bash
```
$umask 077
$cat > ~/mysql-secrets.env << 'EOF'
$NR_CLI_MYSQL_ADMIN_USER_1=admin
$NR_CLI_MYSQL_ADMIN_PASSWORD_1=YourMasterPassword1
$EOF
$chmod 600 ~/mysql-secrets.env
```

bash

$curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n nrdot-collector-mysql-rds

CLIは、以下の変数について対話的にプロンプトを表示します。非対話的に実行するために、事前に環境変数として設定することもできます。

変数	説明	デフォルト
`NR_CLI_MYSQL_CONFIG_PRESET`	NRDOTの設定： `1` Basic用 `2` Advanced用	`1`
`NR_CLI_MYSQL_INSTANCES_FILE`	必須。RDSエンドポイントを`host`として使用する、インスタンスYAMLファイルへのパス。	なし
`NR_CLI_MYSQL_SECRETS_FILE`	必須。シークレットファイルへのパス（`KEY=VALUE`、インスタンスごとに1つのRDSマスターユーザー名/パスワードのペア）。	なし

変数

説明

デフォルト

NR_CLI_MYSQL_CONFIG_PRESET

NRDOTの設定：

1 Basic用
2 Advanced用

1

NR_CLI_MYSQL_INSTANCES_FILE

必須。RDSエンドポイントをhostとして使用する、インスタンスYAMLファイルへのパス。

なし

NR_CLI_MYSQL_SECRETS_FILE

必須。シークレットファイルへのパス（KEY=VALUE、インスタンスごとに1つのRDSマスターユーザー名/パスワードのペア）。

なし

ヒント

このコレクターから複数のRDS MySQLまたはAuroraエンドポイントをモニターするには、インスタンスファイルにさらにエントリを追加し、secretsファイルに対応する番号付きの認証情報を追加してください。チェックに失敗したインスタンスは、インストール全体を中止するのではなく、理由をログに記録してスキップされます。

データを探す、使う

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

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

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

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

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

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

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

Ansibleのインストール

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

Chefのインストール

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

Helmチャートのインストール

mysql-otel Helmチャートを使用して、KubernetesでMySQL監視をインストールおよび構成する方法について説明します。

Dockerのインストール

Dockerですでに実行されているMySQLインスタンスのシブリングコンテナとして、NRDOT Collectorを実行する方法について説明します。

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

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

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

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

NRDOT Collectorのインストールと設定

AWS RDS/Aurora MySQL

データを探す、使う

関連ドキュメント

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

Ansibleのインストール

Chefのインストール

Helmチャートのインストール

Dockerのインストール

前提条件