Installez & configurez NRDOT pour le monitoring de MySQL avec la CLI

Vous pouvez installer et configurer le NRDOT Collector pour le monitoring MySQL à l'aide de la CLI New Relic. La CLI installe le collecteur, crée l'utilisateur de monitoring, et configure le collecteur en une seule commande.

Installation guidée

Pour installer plutôt via l’UI de New Relic, accédez à one.newrelic.com > Integrations & Agents > MySQL (Database 360) . Cette page traite uniquement de l’installation manuelle.

Prérequis

Un compte New Relic avec une clé de licence valide.
Un ID de compte New Relic.
MySQL 5.7 ou version ultérieure.
Un hôte collecteur Linux exécutant Debian/Ubuntu ou RHEL/CentOS, avec curl et systemd installés, et le client mysql disponible.
Pour MySQL auto-hébergé : accès administrateur à votre serveur MySQL (le compte root ou équivalent).
Pour AWS RDS/Aurora MySQL : connectivité réseau depuis l’hôte du collecteur vers le point de terminaison RDS (accès entrant sur le port MySQL dans le groupe de sécurité RDS), et le nom d’utilisateur et le mot de passe maître RDS.
Connectivité réseau vers le point de terminaison OTLP New Relic pour votre région.

Pour connaître les exigences détaillées, reportez-vous à Compatibilité et prérequis.

Installer et configurer le NRDOT Collector

Cette recette monitore une ou plusieurs instances MySQL à partir d’un seul collecteur. Au lieu de demander un seul ensemble hôte/port/identifiants, elle lit deux fichiers que vous créez à l’avance : un fichier d’instances (YAML) listant chaque instance à monitorer, et un fichier de secrets (KEY=VALUE) avec un identifiant et un mot de passe administrateur pour chacune, indexés pour correspondre.

Créez le fichier d’instance. Ajoutez une entrée par instance MySQL que vous souhaitez que ce collecteur monitore ; juste une entrée si vous n’exécutez qu’une seule instance :
bash
```
$cat > ~/mysql-instances.yml << 'EOF'
$instances:
$  - host: localhost
$    port: 3306
$    login_name: newrelic
$EOF
```
Créez le fichier de secrets avec un identifiant admin (n'importe quel utilisateur admin complet fonctionne ; il n'est pas nécessaire que ce soit root) et un mot de passe pour chaque instance, indexés pour correspondre à l'ordre du fichier d'instance :
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

Important

Ce programme d’installation se connecte à MySQL via TCP à l’aide d’un mot de passe, donc le compte administrateur dans votre fichier de secrets doit utiliser une authentification par mot de passe. Sur certaines installations Debian/Ubuntu, root@localhost utilise par défaut le plug-in auth_socket (sans mot de passe, socket local uniquement), ce qui ne fonctionnera pas ici. Modifiez-le d’abord en exécutant ceci localement en tant que root :

bash

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

Si cela échoue avec Access denied, le package mysql-server crée également un compte debian-sys-maint avec des identifiants d’administrateur connus dans /etc/mysql/debian.cnf. Utilisez-le plutôt :

bash

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

La CLI affiche un prompt de manière interactive pour les variables suivantes. Vous pouvez également les définir à l’avance comme variables d’environnement pour une exécution non interactive.

Variable	Description	Défaut
`NR_CLI_MYSQL_CONFIG_PRESET`	Configuration NRDOT : `1` pour Basic `2` pour Advanced	`1`
`NR_CLI_MYSQL_INSTANCES_FILE`	Requis. Chemin d’accès au fichier YAML d’instance.	Aucun
`NR_CLI_MYSQL_SECRETS_FILE`	Requis. Chemin vers le fichier de secrets (`KEY=VALUE`, une paire identifiant / mot de passe administrateur par instance).	Aucun

Variable

Description

Défaut

NR_CLI_MYSQL_CONFIG_PRESET

Configuration NRDOT :

1 pour Basic
2 pour Advanced

1

NR_CLI_MYSQL_INSTANCES_FILE

Requis. Chemin d’accès au fichier YAML d’instance.

Aucun

NR_CLI_MYSQL_SECRETS_FILE

Requis. Chemin vers le fichier de secrets (KEY=VALUE, une paire identifiant / mot de passe administrateur par instance).

Aucun

Conseil

Pour monitorer plus d'une instance MySQL à partir de ce collecteur, ajoutez des entrées supplémentaires au fichier d'instances, et des identifiants numérotés correspondants (_2, _3,…) au fichier de secrets. Une instance qui échoue à ses vérifications est ignorée avec une raison dans le log plutôt que d’annuler toute l’installation. L'installation n'échoue complètement que si aucune des instances ne réussit.

Cette recette monitore un ou plusieurs points de terminaison RDS MySQL ou Aurora à partir d’un seul collecteur, en utilisant le même modèle de fichier d’instances / fichier de secrets que la version auto-hébergée.

Créez le fichier d’instances, en utilisant le point de terminaison RDS comme host; juste une entrée si vous effectuez uniquement le monitoring d’une seule instance RDS :
bash
```
$cat > ~/mysql-instances.yml << 'EOF'
$instances:
$  - host: mydb1.abcdefg12345.us-east-1.rds.amazonaws.com
$    port: 3306
$    login_name: newrelic
$EOF
```
Créez le fichier de secrets avec le nom d’utilisateur et le mot de passe maître RDS pour chaque instance, indexé pour correspondre à l’ordre du fichier des instances :
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

La CLI affiche un prompt de manière interactive pour les variables suivantes. Vous pouvez également les définir à l’avance comme variables d’environnement pour une exécution non interactive.

Variable	Description	Défaut
`NR_CLI_MYSQL_CONFIG_PRESET`	Configuration NRDOT : `1` pour Basic `2` pour Advanced	`1`
`NR_CLI_MYSQL_INSTANCES_FILE`	Requis. Chemin d'accès au fichier YAML des instances, en utilisant les points de terminaison RDS comme `host`.	Aucun
`NR_CLI_MYSQL_SECRETS_FILE`	Requis. Chemin vers le fichier de secrets (`KEY=VALUE`, une paire nom d’utilisateur / mot de passe maître RDS par instance).	Aucun

Variable

Description

Défaut

NR_CLI_MYSQL_CONFIG_PRESET

Configuration NRDOT :

1 pour Basic
2 pour Advanced

1

NR_CLI_MYSQL_INSTANCES_FILE

Requis. Chemin d'accès au fichier YAML des instances, en utilisant les points de terminaison RDS comme host.

Aucun

NR_CLI_MYSQL_SECRETS_FILE

Requis. Chemin vers le fichier de secrets (KEY=VALUE, une paire nom d’utilisateur / mot de passe maître RDS par instance).

Aucun

Conseil

Pour monitorer plus d’un point de terminaison RDS MySQL ou Aurora depuis ce collecteur, ajoutez plus d’entrées au fichier des instances, et les identifiants numérotés correspondants au fichier des secrets. Une instance qui échoue à ses vérifications est ignorée avec une raison dans le log plutôt que d’annuler toute l’installation.

Trouvez et utilisez vos données

Une fois vos données collectées, vous pouvez accéder à un monitoring complet de la base de données MySQL via l'UI de New Relic.

Pour trouver votre entité de base de données MySQL dans New Relic :

Allez à one.newrelic.com > All capabilities > Databases.
Dans la liste déroulante Entity type, sélectionnez MySQL instance, puis cliquez sur Apply.
Sélectionnez votre base de données MySQL dans la liste des entités.

Pour confirmer que les données arrivent, exécutez cette requête dans le générateur de requêtes:

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

Introduction au monitoring MySQL avec NRDOT

Découvrez toutes les méthodes d'installation disponibles pour le monitoring de MySQL avec New Relic.

Installation via Ansible

Découvrez comment installer et configurer le monitoring MySQL à grande échelle avec le newrelic.newrelic_install rôle Ansible.

Installation via Chef

Découvrez comment installer et configurer le monitoring MySQL à grande échelle avec le cookbook Chef newrelic-install.

Installation du chart Helm

Apprenez à installer et configurer le monitoring MySQL sur Kubernetes avec le chart Helm mysql-otel.

Installation Docker

Apprenez à exécuter le Collector NRDOT en tant que conteneur frère d’une instance MySQL déjà en cours d’exécution dans Docker.

Cette traduction automatique est fournie pour votre commodité.

Installez & configurez NRDOT pour le monitoring de MySQL avec la CLI

Installation guidée

Prérequis .css-21sua1{background:none;border:none;width:0;padding:0;}

Installer et configurer le NRDOT Collector

AWS RDS/Aurora MySQL

Trouvez et utilisez vos données

Documentation associée

Introduction au monitoring MySQL avec NRDOT

Installation via Ansible

Installation via Chef

Installation du chart Helm

Installation Docker

Prérequis