Installez & configurez NRDOT pour le monitoring MySQL avec AWS RDS

Prérequis

Avant d’installer, assurez-vous d’avoir :

• Une clé de licence New Relic.

• Connectivité réseau entre l'hôte où vous installez le Collector NRDOT et votre instance RDS MySQL.

• Connectivité réseau vers la documentation sur les points de terminaison OTLP de New Relic

• Identifiants de l'utilisateur maître RDS.

  Pour les versions de MySQL prises en charge, les droits requis et les exigences performance_schema, consultez Compatibilité et prérequis.

Configurer le Collector NRDOT

Installez le NRDOT Collector sur un système qui peut se connecter à votre instance RDS :

$
NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_amd64.deb" --output nrdot-collector.deb && sudo dpkg -i nrdot-collector.deb

$
NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_x86_64.rpm" --output nrdot-collector.rpm && sudo rpm -ivh nrdot-collector.rpm

$
NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_arm64.deb" --output nrdot-collector.deb && sudo dpkg -i nrdot-collector.deb

$
NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_arm64.rpm" --output nrdot-collector.rpm && sudo rpm -ivh nrdot-collector.rpm

Configurer l'utilisateur de la base de données

Créez un utilisateur de monitoring avec les privilèges nécessaires pour votre instance RDS MySQL.

• Pour créer un utilisateur de monitoring, connectez-vous à votre instance RDS en tant qu'utilisateur principal et exécutez :

CREATE USER '<YOUR_DB_USERNAME>'@'%' IDENTIFIED BY '<YOUR_DB_PASSWORD>';

• Pour collecter des échantillons de requêtes et les requêtes principales, accordez les privilèges suivants à l’utilisateur de monitoring :

GRANT SELECT ON performance_schema.* TO '<YOUR_DB_USERNAME>'@'%';
      GRANT SELECT ON *.* TO '<YOUR_DB_USERNAME>'@'%';
      GRANT REPLICATION CLIENT ON *.* TO '<YOUR_DB_USERNAME>'@'%';
      GRANT PROCESS ON *.* TO '<YOUR_DB_USERNAME>'@'%';

• (Facultatif) Pour afficher les données de temps d'attente dans la plateforme New Relic, accordez les privilèges suivants à l'utilisateur de monitoring :

GRANT UPDATE ON performance_schema.setup_consumers TO '<YOUR_DB_USERNAME>'@'%';

• (Facultatif) Pour vérifier la connexion et les autorisations, exécutez :

$
mysql -h <YOUR_DB_HOST> -P <YOUR_DB_PORT> -u <YOUR_DB_USERNAME> -p -e "SELECT 1;"

Si la commande se termine sans erreur, l'utilisateur de monitoring, l'hôte et le port sont tous corrects.

Configurer le collecteur NRDOT

Configurez le Collector NRDOT avec vos paramètres spécifiques à MySQL.

Cette configuration se concentre sur le monitoring essentiel de MySQL avec le Récepteur nrmysql uniquement.

1. Créez un fichier de configuration nommé mysql-config.yaml:

$
sudo nano /etc/nrdot-collector/mysql-config.yaml

2. Ajoutez la configuration suivante au fichier mysql-config.yaml que vous avez créé à l’étape précédente.

receivers:
      nrmysql:
        endpoint: "<YOUR_DB_HOST>:<YOUR_DB_PORT>"
        transport: tcp
        username: "<YOUR_DB_USERNAME>"
        password: "<YOUR_DB_PASSWORD>"
        allow_native_passwords: true
        collection_interval: 15s
        initial_delay: 1s
        explain_mode: procedure
        statement_events:
          digest_text_limit: 4096
          time_limit: 24h
          limit: 500
        query_sample_collection:
          max_rows_per_query: 100
          allowed_comment_keys: [nr_service_guid]
        top_query_collection:
          lookback_time: 60
          max_query_sample_count: 5000
          top_query_count: 200
          collection_interval: 60s
          query_plan_cache_size: 1000
          query_plan_cache_ttl: 1h
          allowed_comment_keys: [nr_service_guid]
        events:
          db.server.query_sample:
            enabled: true
          db.server.top_query:
            enabled: true
          db.server.query_plan:
            enabled: true
        resource_attributes:
          db.system.version:
            enabled: true
        metrics:
          mysql.query.count:
            enabled: true
          mysql.query.slow.count:
            enabled: true
          mysql.commands:
            enabled: true
          mysql.innodb.data_file.io:
            enabled: true

    processors:
      batch:

    exporters:
      otlp/newrelic:
        endpoint: "<YOUR_NEWRELIC_OTLP_ENDPOINT>"
        headers:
          api-key: "<YOUR_NEWRELIC_LICENSE_KEY>"
        compression: gzip
        retry_on_failure:
          enabled: true
          initial_interval: 5s
          max_interval: 30s
          max_elapsed_time: 300s

    service:
      pipelines:
        metrics:
          receivers: [nrmysql]
          processors: [batch]
          exporters: [otlp/newrelic]
        logs:
          receivers: [nrmysql]
          processors: [batch]
          exporters: [otlp/newrelic]

Paramètres de configuration

Le tableau suivant décrit les principaux paramètres de configuration du récepteur nrmysql :

Valider la configuration du Collector NRDOT

1. Mettez à jour le chemin de configuration pour pointer vers votre nouveau fichier mysql-config.yaml :

$
sudo sed -i 's|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/config.yaml"|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/mysql-config.yaml"|' /etc/nrdot-collector/nrdot-collector.conf

2. Validez la configuration du Collector NRDOT pour vous assurer qu'elle est correctement formatée et qu'elle fonctionnera correctement :

$
sudo /usr/bin/nrdot-collector validate --config=/etc/nrdot-collector/mysql-config.yaml

Redémarrer NRDOT Collector

• Après avoir mis à jour votre configuration, redémarrez le service NRDOT Collector :

$
sudo systemctl restart nrdot-collector

• Pour vérifier que le collecteur fonctionne correctement, vérifiez l'état du service :

$
sudo systemctl status nrdot-collector

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 RDS MySQL via l'UI de New Relic.

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

1. Allez à https://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 RDS MySQL dans la liste des entités.