Installez & configurez NRDOT pour le monitoring MySQL avec Ansible

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.
• Ansible Core 2.13 ou 2.14, Python 3.10, et les collections ansible.windows et ansible.utils.
• Un hôte collecteur Linux exécutant Debian/Ubuntu ou RHEL/CentOS.
• Pour MySQL auto-hébergé : accès administratif à votre serveur MySQL (le compte root ou équivalent), en utilisant l’authentification par mot de passe.
• Pour MySQL ou Aurora sur AWS RDS : connectivité réseau de l’hôte du collecteur au point de terminaison 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.

Installez le rôle

$
ansible-galaxy install newrelic.newrelic_install

Assurez-vous que les collections requises sont également installées :

$
ansible-galaxy collection install ansible.windows ansible.utils

Configurez le playbook

- name: Install New Relic NRDOT for MySQL
  hosts: all
  roles:
    - role: newrelic.newrelic_install
  vars:
    targets:
      - mysql-otel
  environment:
    NEW_RELIC_API_KEY: <API key>
    NEW_RELIC_ACCOUNT_ID: <Account ID>
    NEW_RELIC_REGION: <Region>
    NR_CLI_MYSQL_CONFIG_PRESET: <1 Basic, 2 Advanced, default 1>
    NR_CLI_MYSQL_INSTANCES_FILE: <path to the instances YAML file on the target host>
    NR_CLI_MYSQL_SECRETS_FILE: <path to the secrets file (KEY=VALUE per instance) on the target host>

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

- name: Install New Relic NRDOT for MySQL on RDS
  hosts: all
  roles:
    - role: newrelic.newrelic_install
  vars:
    targets:
      - mysql-otel-rds
  environment:
    NEW_RELIC_API_KEY: <API key>
    NEW_RELIC_ACCOUNT_ID: <Account ID>
    NEW_RELIC_REGION: <Region>
    NR_CLI_MYSQL_CONFIG_PRESET: <1 Basic, 2 Advanced, default 1>
    NR_CLI_MYSQL_INSTANCES_FILE: <path to the instances YAML file on the target host, using RDS endpoints as host>
    NR_CLI_MYSQL_SECRETS_FILE: <path to the secrets file (KEY=VALUE per instance) on the target host>

Exécutez le playbook

$
ansible-playbook -i <inventory_file> <playbook_file>.yml

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 :

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