Dépannage du monitoring MySQL NRDOT

Aperçu

Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez !

Cette fonctionnalité est actuellement fournie dans le cadre d'un aperçu conformément à nos politiques de pré-sortie.

Résoudre les problèmes courants que vous pouvez rencontrer lors du monitoring de votre MySQL avec le NRDOT Collector.

Tester la connectivité

Tester la connectivité réseau vers MySQL

Confirmez d'abord que le port est accessible :

bash

$nc -zv <YOUR_DB_HOST> <YOUR_DB_PORT>

Ensuite, confirmez que l'utilisateur de monitoring peut réellement s'authentifier et exécuter des requêtes :

bash

$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.

Tester la connectivité du point de terminaison OTLP

Exécutez ce qui suit pour vérifier que votre hôte peut atteindre le point de terminaison OTLP New Relic sélectionné :

bash

$ENDPOINT="<YOUR_NEWRELIC_OTLP_ENDPOINT>"
$HOST=$(echo "$ENDPOINT" | sed 's|https://||' | cut -d: -f1)
$PORT=$(echo "$ENDPOINT" | awk -F: '{print $NF}')
$(timeout 2 bash -c "</dev/tcp/$HOST/$PORT" && echo "SUCCESS") || echo "FAILED"

Résultat attendu : SUCCESS

Problèmes courants

Symptômes : Échantillon de requête et événements de log des requêtes principales manquants dans New Relic.

Causes possibles :

performance_schema désactivé
Les événements de requête ne sont pas activés dans la configuration du Récepteur
Privilèges de base de données insuffisants
Solutions :

Vérifiez que Performance Schema est activé :
```
SHOW VARIABLES LIKE 'performance_schema';
```
La valeur doit être ON.

Vérifier la configuration du récepteur :

events:
  db.server.query_sample:
    enabled: true
  db.server.top_query:
    enabled: true

Vérifier les privilèges de la base de données :
```
SHOW GRANTS FOR '<YOUR_DB_USERNAME>'@'%';
```
Devrait inclure SELECT sur performance_schema.*.

Symptômes : les métriques de durée d'attente de verrouillage affichent toujours 0 seconde.

Cause : Le consommateur Performance Schema events_waits_current est désactivé.

Solutions :

Pour une base de données MySQL autogérée : ajoutez à my.cnf/my.ini:

[mysqld]
performance-schema-consumer-events-waits-current=ON

Puis redémarrez MySQL.

Pour AWS RDS :

UPDATE performance_schema.setup_consumers 
SET ENABLED='YES' 
WHERE NAME='events_waits_current';

Important

Sur RDS, ce paramètre ne persiste pas après les redémarrages. Accordez à l’utilisateur de monitoring les privilèges UPDATE sur performance_schema.setup_consumers afin que le collecteur puisse le réactiver automatiquement.

Symptômes : mysql.query_plan est vide pour certaines requêtes, en particulier les plus longues.

Cause : le texte de l'instruction est tronqué par les limites de longueur de résumé de MySQL, ce qui amène le Récepteur à ignorer EXPLAIN.

Solution : augmentez les paramètres du serveur MySQL :

SET GLOBAL max_digest_length = 4096;
SET GLOBAL performance_schema_max_digest_length = 4096;
SET GLOBAL performance_schema_max_sql_text_length = 4096;

Ajouter à my.cnf pour rendre permanent :

[mysqld]
max_digest_length = 4096
performance_schema_max_digest_length = 4096
performance_schema_max_sql_text_length = 4096

Symptômes : plans de requête manquants pour les instructions UPDATE, INSERT, DELETE ou REPLACE.

Cause : l'utilisateur de monitoring manque de privilèges DML et explain_mode est défini sur inline.

Solution : Passez en mode procedure dans la configuration de votre Récepteur :

nrmysql:
  explain_mode: procedure

Cela utilise une procédure SQL SECURITY DEFINER pour expliquer les instructions d’écriture sans accorder de privilèges DML à l’utilisateur de monitoring.

Symptômes : l'attribut mysql.session.client_name est vide pour certaines connexions de base de données.

Cause : pas un bug — certains pilotes clients n’envoient pas d’attributs de connexion par défaut.

Remarques :

Il s'agit d'un comportement dépendant des données
Les différentes bibliothèques clientes MySQL ont une prise en charge variable des attributs de connexion
Toutes les applications ne configurent pas leurs pilotes pour envoyer ces informations

Symptômes : les tags de corrélation APM ne sont pas extraits des commentaires SQL.

Cause : l'extraction du tag de commentaire n'est pas configurée.

Solution : ajoutez allowed_comment_keys aux deux blocs de collecte dans votre configuration :

query_sample_collection:
  allowed_comment_keys: [nr_service_guid]
top_query_collection:
  allowed_comment_keys: [nr_service_guid]

L'extraction de tag de commentaire est vide par défaut pour des raisons de sécurité.

Symptômes :

Entité MySQL manquante dans l'explorateur d'entités

L'application APM n'affiche pas les relations de la base de données

Cause : attributs de ressource server.address et server.port manquants requis pour la synthèse d'entité.

Solution : ajoutez un processeur de ressources à votre configuration du collecteur :

processors:
  resource/mysql:
    attributes:
      - key: server.address
        value: "<YOUR_DB_HOST>"
        action: upsert
      - key: server.port
        value: <YOUR_DB_PORT>
        action: upsert

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

Symptômes :

Erreurs « connexion refusée »
Échecs d'authentification "Access denied"
Solutions :
Pour la connexion refusée :

Vérifiez que MySQL est en cours d'exécution :
bash
```
$systemctl status mysql
```
Vérifiez que les règles du pare-feu autorisent les connexions sur le port MySQL (3306 par défaut)
Vérifiez que bind-address dans la configuration MySQL autorise les connexions externes
Pour les erreurs d'authentification :

Vérifiez que l'utilisateur existe et possède les privilèges corrects :

SELECT User, Host FROM mysql.user WHERE User='<YOUR_DB_USERNAME>';
SHOW GRANTS FOR '<YOUR_DB_USERNAME>'@'%';

Vérifier que le mot de passe est correct
Pour RDS, assurez-vous que le groupe de sécurité autorise les connexions entrantes

Réinitialisations du consommateur RDS Performance Schema : le consommateur events_waits_current se désactive automatiquement lors du redémarrage/basculement RDS. Accordez les privilèges UPDATE sur performance_schema.setup_consumers pour que le collecteur puisse le réactiver :

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

Sécurité réseau RDS : assurez-vous que votre groupe de sécurité RDS autorise le trafic entrant sur le port 3306 à partir de l'adresse IP ou du groupe de sécurité du Collector NRDOT.

Symptômes : Le collecteur ne parvient pas à se connecter, avec une erreur liée au certificat ou à TLS.

Cause : RDS impose TLS. Le collecteur ne fait pas confiance à l’autorité de certification RDS d’Amazon par défaut.

Solution : Définissez tls.ca_file (ou tls.ca_pem) sur le groupe de certificats Amazon RDS, et laissez tls.insecure/tls.insecure_skip_verify à false:

nrmysql:
  tls:
    insecure: false
    insecure_skip_verify: false
    ca_file: /path/to/global-bundle.pem

Exemples de requêtes NRQL

Utilisez ces requêtes NRQL pour dépanner et vérifier votre monitoring MySQL :

Vérifier les requêtes bloquées

FROM Log SELECT * WHERE event.name = 'db.server.query_sample' 
AND mysql.blocking.blocker.count > 0 
SINCE 1 hour ago

Conseil

Filtrez avec mysql.blocking.blocker.count > 0, et non != 0 — en NRQL, null != 0 s'évalue à TRUE, ce qui inclurait silencieusement les sessions non bloquées dans vos résultats.

Trouvez les requêtes les plus lentes

FROM Log SELECT db.query.text, 
mysql.events_statements_summary_by_digest.sum_timer_wait,
mysql.events_statements_summary_by_digest.count_star
WHERE event.name = 'db.server.top_query'
ORDER BY mysql.events_statements_summary_by_digest.sum_timer_wait DESC
LIMIT 10

Vérifier la synthèse d'entité

FROM Metric SELECT uniqueCount(entity.guid) 
WHERE metricName LIKE 'mysql.%' 
FACET server.address, server.port
SINCE 1 hour ago

Obtenir de l'aide

Si vous continuez à rencontrer des problèmes :

Vérifiez les logs du NRDOT Collector :
bash
```
$journalctl -u nrdot-collector -f
```
Vérifiez la syntaxe de votre configuration :
bash
```
$nrdot-collector validate --config=<your-config-file>
```
Passez en revue nos exigences de compatibilité
Contactez le support New Relic avec les logs et la configuration de votre collecteur (supprimez les informations sensibles comme les mots de passe)

Instrumentation dans les environnements auto-hébergés

Découvrez comment configurer le monitoring MySQL dans des environnements auto-hébergés avec New Relic.

Instrumentation dans les environnements RDS

Découvrez comment configurer le monitoring MySQL dans les environnements RDS avec New Relic.

Référence des métriques

Découvrez les métriques disponibles collectées par le collecteur NRDOT.

Cette traduction automatique est fournie pour votre commodité.

Aperçu

Tester la connectivité

Tester la connectivité réseau vers MySQL

Tester la connectivité du point de terminaison OTLP

Problèmes courants

Les événements de requête ou les échantillons n’apparaissent pas

Les métriques de temps d'attente n'apparaissent pas

Important

Plans de requête manquants pour les requêtes longues

Plans de requête manquants dans les principaux événements de requête

Plans d'instructions d'écriture manquants

Le nom du client est vide pour les sessions

Les tags de commentaire sont vides

Entité MySQL ou relation APM manquante

Erreurs de connexion refusée ou d’authentification

Problèmes spécifiques à AWS RDS

Erreur de certificat TLS lors de la connexion à RDS

Exemples de requêtes NRQL

Vérifier les requêtes bloquées

Conseil

Trouvez les requêtes les plus lentes

Vérifier la synthèse d'entité

Obtenir de l'aide

Instrumentation dans les environnements auto-hébergés

Instrumentation dans les environnements RDS

Référence des métriques

Cette traduction automatique est fournie pour votre commodité.

Dépannage du monitoring MySQL NRDOT

Aperçu

Tester la connectivité.css-21sua1{background:none;border:none;width:0;padding:0;}

Tester la connectivité réseau vers MySQL

Tester la connectivité du point de terminaison OTLP

Problèmes courants

Les métriques de temps d'attente n'apparaissent pas

Plans de requête manquants pour les requêtes longues

Plans de requête manquants dans les principaux événements de requête

Plans d'instructions d'écriture manquants

Le nom du client est vide pour les sessions

Les tags de commentaire sont vides

Entité MySQL ou relation APM manquante

Erreurs de connexion refusée ou d’authentification

Problèmes spécifiques à AWS RDS

Erreur de certificat TLS lors de la connexion à RDS

Exemples de requêtes NRQL

Vérifier les requêtes bloquées

Conseil

Trouvez les requêtes les plus lentes

Vérifier la synthèse d'entité

Obtenir de l'aide

Documentation associée

Instrumentation dans les environnements auto-hébergés

Instrumentation dans les environnements RDS

Référence des métriques

Tester la connectivité