Référence des métriques MySQL NRDOT

Monitorez les performances de votre base de données MySQL avec des métriques complètes collectées par le NRDOT Collector. Par défaut, New Relic collecte les métriques référencées dans la section Métriques par défaut. Vous pouvez améliorer votre monitoring en activant les métriques souhaitées listées dans la section Métriques supplémentaires.

Les métriques suivantes sont collectées automatiquement pour les fonctionnalités de l'UI de New Relic.

métrique	Description	Unité	Type	Attributs
`mysql.buffer_pool.data_pages`	Nombre de pages de données dans le pool tampon InnoDB	`1`	somme (cumulée, int)	`status` (dirty, clean)
`mysql.buffer_pool.limit`	Taille configurée du pool tampon InnoDB	`By`	somme (cumulée, int)	Aucun
`mysql.buffer_pool.operations`	Opérations sur le pool tampon InnoDB	`1`	somme (cumulatif, entier, monotone)	`operation` (read_ahead_rnd, read_ahead, read_ahead_evicted, read_requests, reads, wait_free, write_requests)
`mysql.buffer_pool.page_flushes`	Requêtes pour vider les pages du pool tampon InnoDB	`1`	somme (cumulatif, entier, monotone)	Aucun
`mysql.buffer_pool.pages`	Nombre de pages dans le pool tampon InnoDB	`1`	somme (cumulée, int)	`kind` (données, libre, divers, total)
`mysql.buffer_pool.usage`	Octets dans le pool tampon InnoDB	`By`	somme (cumulée, int)	`status` (dirty, clean)
`mysql.double_writes`	Écritures dans le tampon de double écriture InnoDB	`1`	somme (cumulatif, entier, monotone)	`kind` (pages_written, writes)
`mysql.handlers`	Requêtes vers divers gestionnaires MySQL	`1`	somme (cumulatif, entier, monotone)	`kind` (commit, delete, discover, external_lock, mrr_init, prepare, read_first, read_key, read_last, read_next, read_prev, read_rnd, read_rnd_next, rollback, savepoint, savepoint_rollback, update, write)
`mysql.index.io.wait.count`	Nombre d'événements d'attente d'I/O pour un index	`1`	somme (cumulatif, entier, monotone)	`operation` , `table` , `schema` , `index`
`mysql.index.io.wait.time`	Temps de l'événement d'attente I/O pour un index	`ns`	somme (cumulatif, entier, monotone)	`operation` , `table` , `schema` , `index`
`mysql.locks`	Nombre de verrous MySQL	`1`	somme (cumulatif, entier, monotone)	`kind` (immediate, waited)
`mysql.log_operations`	Opérations de log InnoDB	`1`	somme (cumulatif, entier, monotone)	`operation` (waits, write_requests, writes, fsyncs)
`mysql.mysqlx_connections`	Connexions mysqlx (plug-in X/Document Store)	`1`	somme (cumulatif, entier, monotone)	`status` (acceptés, fermés, rejetés)
`mysql.opened_resources`	Nombre de ressources ouvertes	`1`	somme (cumulatif, entier, monotone)	`kind` (file, table_definition, table)
`mysql.operations`	Opérations InnoDB	`1`	somme (cumulatif, entier, monotone)	`operation` (fsyncs, reads, writes)
`mysql.page_operations`	Opérations de la page InnoDB	`1`	somme (cumulatif, entier, monotone)	`operation` (created, read, written)
`mysql.prepared_statements`	Commandes d'instructions préparées émises	`1`	somme (cumulatif, entier, monotone)	`command` (execute, close, fetch, prepare, reset, send_long_data)
`mysql.row_locks`	Verrous de ligne InnoDB	`1`	somme (cumulatif, entier, monotone)	`kind` (waits, time)
`mysql.row_operations`	Opérations de ligne InnoDB	`1`	somme (cumulatif, entier, monotone)	`operation` (supprimé, inséré, lu, mis à jour)
`mysql.sorts`	Nombre de tris MySQL	`1`	somme (cumulatif, entier, monotone)	`kind` (merge_passes, range, rows, scan)
`mysql.table.io.wait.count`	Nombre d'événements d'attente d'I/O pour une table	`1`	somme (cumulatif, entier, monotone)	`operation` , `table` , `schema`
`mysql.table.io.wait.time`	Temps d'événement d'attente d'I/O pour une table	`ns`	somme (cumulatif, entier, monotone)	`operation` , `table` , `schema`
`mysql.threads`	État des threads MySQL	`1`	somme (cumulée, int)	`kind` (mis en cache, connecté, créé, en cours d'exécution)
`mysql.tmp_resources`	Ressources temporaires créées	`1`	somme (cumulatif, entier, monotone)	`resource` (disk_tables, files, tables)
`mysql.uptime`	Secondes depuis le démarrage du serveur	`s`	somme (cumulatif, entier, monotone)	Aucun

Métriques supplémentaires

Les métriques suivantes sont désactivées par défaut, mais peuvent être activées pour obtenir des informations détaillées sur les performances et l'état de santé de MySQL. Ces métriques sont organisées par fonctionnalité et la plupart nécessitent une connexion MySQL directe.

métrique	Description	Unité	Type	Attributs
`mysql.connection.count`	Tentatives de connexion (réussies ou non)	`1`	somme (cumulatif, entier, monotone)	Aucun
`mysql.connection.errors`	Erreurs lors du processus de connexion du client	`1`	somme (cumulatif, entier, monotone)	`error` (accept, internal, max_connections, peer_address, select, tcpwrap, aborted, aborted_clients, locked)
`mysql.max_used_connections`	Connexions simultanées maximales depuis le démarrage du serveur	`1`	somme (cumulée, int)	Aucun
`mysql.client.network.io`	Octets transmis entre le serveur et les clients	`By`	somme (cumulatif, entier, monotone)	`kind` (reçu, envoyé)
`mysql.mysqlx_worker_threads`	threads de travail mysqlx disponibles	`1`	somme (cumulée, int)	`kind` (disponible, actif)

métrique	Description	Unité	Type	Attributs
`mysql.commands`	Nombre de fois que chaque type de commande a été exécuté	`1`	somme (cumulatif, entier, monotone)	`command` (delete, delete_multi, insert, select, update, update_multi)
`mysql.query.count`	Instructions exécutées par le serveur	`1`	somme (cumulatif, entier, monotone)	Aucun
`mysql.query.client.count`	Instructions envoyées au serveur par les clients uniquement	`1`	somme (cumulatif, entier, monotone)	Aucun
`mysql.query.slow.count`	Requêtes lentes	`1`	somme (cumulatif, entier, monotone)	Aucun
`mysql.joins`	Jointures qui effectuent des analyses de table	`1`	somme (cumulatif, entier, monotone)	`kind` (full, full_range, range, range_check, scan)
`mysql.statement_event.count`	Résumé des événements d’instruction actuels/récents	`1`	somme (cumulée, int)	`schema` , `digest` , `digest_text` , `kind` (errors, warnings, rows_affected, rows_sent, rows_examined, created_tmp_disk_tables, created_tmp_tables, sort_merge_passes, sort_rows, no_index_used)
`mysql.statement_event.wait.time`	Temps d'attente total des événements chronométrés résumés	`ns`	somme (cumulée, int)	`schema` , `digest` , `digest_text`

métrique	Description	Unité	Type	Attributs
`mysql.table.average_row_length`	Longueur moyenne des lignes pour une table	`By`	somme (cumulée, int)	`table` , `schema`
`mysql.table.rows`	Nombre de lignes pour une table	`1`	somme (cumulée, int)	`table` , `schema`
`mysql.table.size`	Taille de la table	`By`	somme (cumulée, int)	`table` , `schema` , `kind` (données, index)
`mysql.table_open_cache`	Succès/échecs/dépassements pour le cache des tables ouvertes	`1`	somme (cumulatif, entier, monotone)	`status` (succès, échec, débordement)
`mysql.table.lock_wait.read.count`	Événements de lecture en attente de verrouillage de table	`1`	somme (cumulée, int)	`schema` , `table` , `kind` (normal, with_shared_locks, high_priority, no_insert, external)
`mysql.table.lock_wait.read.time`	Temps de l'événement de lecture d'attente de verrou de table	`ns`	somme (cumulée, int)	`schema` , `table` , `kind` (normal, with_shared_locks, high_priority, no_insert, external)
`mysql.table.lock_wait.write.count`	Événements d’attente de verrouillage de table en écriture	`1`	somme (cumulée, int)	`schema` , `table` , `kind` (allow_write, concurrent_insert, low_priority, normal, external)
`mysql.table.lock_wait.write.time`	Temps de l’événement d’attente d’écriture de verrou de table	`ns`	somme (cumulée, int)	`schema` , `table` , `kind` (allow_write, concurrent_insert, low_priority, normal, external)

métrique	Description	Unité	Type	Attributs
`mysql.replica.sql_delay`	Secondes de retard que le réplica doit avoir sur la source	`s`	somme (cumulée, int)	Aucun
`mysql.replica.time_behind_source`	À quel point le réplica est « en retard »	`s`	somme (cumulée, int)	Aucun
`mysql.page_size`	Taille de page InnoDB	`By`	somme (cumulée, int)	Aucun

Événements de log

`db.server.query_sample`

Visibilité en temps réel sur les instructions de base de données en cours d’exécution : un instantané ponctuel pris à chaque collecte, et non un log d’exécution complet. Désactivé par défaut.

Attribut	Description
`db.system.name`	`mysql`
`mysql.threads.thread_id`	Identifiant unique pour le thread exécutant l'instruction
`mysql.session.id`	`PROCESSLIST_ID`: l'ID de connexion visible via `SHOW PROCESSLIST`
`user.name`	Utilisateur du thread de premier plan ; vide pour les threads d'arrière-plan
`db.namespace`	Base de données actuelle du thread (`processlist_db`)
`mysql.threads.processlist_command`	Type de commande, ou `Sleep` si inactif
`mysql.threads.processlist_state`	Action/état actuel du thread
`db.query.text`	Texte de l'instruction SQL
`mysql.events_statements_current.digest`	Empreinte de l’instruction SHA-256
`mysql.events_statements_current.timer_start`	Compteur de picosecondes monotone marquant le début de l'instruction : une clé stable par exécution à travers les cycles de collecte
`mysql.events_statements_current.timer_wait`	Temps d'exécution écoulé, en secondes
`mysql.events_waits_current.timer_wait`	Temps d’attente écoulé, en secondes (nécessite le consommateur `events_waits_current`)
`mysql.wait_event_type`	Classification d'attente de niveau supérieur dérivée du nom de l'événement d'attente (`io`, `lock`, `synch`), ou `CPU`/`User sleep`/`other` lorsqu'il n'y a pas d'attente réelle. Associé à `mysql.wait_event`.
`mysql.wait_event`	Répartition détaillée des attentes : le nom de l’événement d’attente sans son segment de catégorie (par exemple, `table/sql/handler`, `mutex/innodb/checkpoint_state`), ou `CPU`/`User sleep`/`other` lorsqu’il n’y a pas d’attente réelle. Associé à `mysql.wait_event_type`.
`mysql.wait_type`	Nom brut et non traité de l'instrument qui a produit l'événement d'attente. Pour la répartition analysée/catégorisée, consultez `mysql.wait_event_type` / `mysql.wait_event`.
`mysql.session.status`	`waiting`, `running`, ou `other`
`mysql.event_id`	Thread + numéro de l'événement actuel lorsque l'événement a commencé
`client.address` / `client.port`	Hôte/port du client (port renseigné sur MySQL 8.0.22+ uniquement, sinon `0`)
`network.peer.address` / `network.peer.port`	Identique, comme attributs de couche réseau
`mysql.blocking.blockers`	éventail JSON de `{thread_id, session_id}` tuples, un par bloqueur de verrou de ligne InnoDB simultané pour cette session (pas seulement le premier, s’il en existe plus d’un). `"[]"` lorsqu’il n’est pas bloqué ; le `session_id` d’un bloqueur est `null` s’il s’est déconnecté avant de pouvoir être résolu.
`mysql.blocking.blocker.count`	Nombre entier de bloqueurs simultanés. `0` signifie non bloqué.
`mysql.session.client_name`	Identité auto-déclarée du pilote client (par exemple, `MySQL Connector/J`), provenant de `session_connect_attrs`. Vide si le pilote n'envoie pas d'attributs de connexion.
`db.query.comment_tags` / `.nr_service_guid`	Tags de commentaire de corrélation APM : voir (Facultatif) Configurer la corrélation APM-base de données
`db.query.text.normalized.hash`	MD5 du SQL normalisé pour la corrélation inter-moteurs

Conseil

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

`db.server.top_query`

Les requêtes consommant le plus de temps d’exécution, agrégées côté serveur par le propre performance_schema.events_statements_summary_by_digest de MySQL : un véritable compteur d’exécution par digest, et non un nombre d’échantillons. Désactivé par défaut.

Attribut	Description
`db.system.name`	`mysql`
`db.query.text`	Texte de l’instruction SQL (obfusqué)
`db.namespace`	Du digest `SCHEMA_NAME`
`mysql.events_statements_summary_by_digest.digest`	Empreinte de l’instruction SHA-256
`mysql.events_statements_summary_by_digest.count_star`	Nombre de fois où l'instruction a été exécutée, rapporté comme un delta par collecte, non cumulatif
`mysql.events_statements_summary_by_digest.sum_timer_wait`	Temps d’exécution total, delta en secondes
`mysql.events_statements_summary_by_digest.sum_rows_examined` / `.sum_rows_sent`	Nombres de lignes delta. Diviser par `count_star` donne les moyennes par exécution. Ce sont des nombres de lignes, et non des lectures logiques.
`db.query.comment_tags` / `.nr_service_guid`	Identique à `query_sample`
`db.query.text.normalized.hash`	Identique à `query_sample`

`db.server.query_plan`

Plan d’exécution pour une instruction, signalé comme son propre événement afin que le plan puisse être filtré, routé ou supprimé indépendamment des statistiques propres à top_query/query_sample. Nécessite qu’au moins db.server.top_query ou db.server.query_sample soit également activé. Une fois activé, mysql.query_plan n’est plus inclus dans les enregistrements db.server.top_query/db.server.query_sample. Consultez Collecte du plan d’exécution pour les mécanismes de EXPLAIN.

Attribut	Description
`db.system.name`	`mysql`
`db.namespace`	La base de données / le schéma par défaut pour la requête. Dans les échantillons de requêtes, il s’agit de la base de données actuelle du thread (`processlist_db`) ; dans les requêtes principales, il s’agit du `SCHEMA_NAME` du digest. Vide lorsqu’aucune base de données par défaut n’a été sélectionnée.
`mysql.query_plan.hash`	Défini sur la même valeur que `mysql.events_statements_summary_by_digest.digest` (digest de la requête) par conception
`mysql.query_plan.source`	L'événement pour lequel le plan a été signalé (`db.server.top_query` ou `db.server.query_sample`), afin que les plans puissent être routés ou rejetés par événement source
`mysql.query_plan`	Le plan de requête pour l'instruction, si disponible

Collecte du plan d’exécution

EXPLAIN nécessite une instruction SQL littérale : le texte de condensé normalisé utilise des espaces réservés (SELECT ? FROM t WHERE id = ?) que MySQL ne peut pas exécuter.

Version de MySQL	Disponibilité du plan
`8.0.3`+	Disponible : `query_sample_text` dans la table de résumé du condensé contient une véritable instruction pour `EXPLAIN`
`5.x`, `8.0.0`–`8.0.2`	Non disponible : aucun `query_sample_text` à expliquer

Si une instruction capturée est tronquée (se termine par ...), EXPLAIN est ignoré sur chaque version. Voir Paramètres de serveur recommandés.

explain_mode Comportement

inline (défaut) Exécute EXPLAIN FORMAT=json <statement> directement ; suffisant pour les workloads SELECTuniquement

procedure Passe par une procédure SQL SECURITY DEFINER (<schema>.explain_statement) afin que les instructions d’écriture (UPDATE/DELETE/INSERT/REPLACE) puissent être expliquées sans accorder de DML à l’utilisateur de monitoring. Se rabat sur inline si la procédure est manquante. Nécessite l’étape de configuration unique par schéma. Consultez Plans de requête pour les instructions d’écriture.

`explain_mode`	Comportement
`inline` (défaut)	Exécute `EXPLAIN FORMAT=json <statement>` directement ; suffisant pour les workloads `SELECT`uniquement
`procedure`	Passe par une procédure `SQL SECURITY DEFINER` (`<schema>.explain_statement`) afin que les instructions d’écriture (`UPDATE`/`DELETE`/`INSERT`/`REPLACE`) puissent être expliquées sans accorder de DML à l’utilisateur de monitoring. Se rabat sur `inline` si la procédure est manquante. Nécessite l’étape de configuration unique par schéma. Consultez Plans de requête pour les instructions d’écriture.

Important

mysql.query_plan est la sortie EXPLAIN FORMAT=json brute, enveloppée dans un éventail JSON à un élément avant la mise en cache, afin que l’ingestion de log de New Relic ne l’aplatisse pas automatiquement et ne la détruise pas. Analysez l’index [0] pour récupérer l’objet plan.

Unités de temps

Type de télémétrie	Champs	Unité
Événements de log ( `query_sample` , `top_query` )	`sum_timer_wait` , `events_statements_current.timer_wait` , `events_waits_current.timer_wait`	secondes
Métriques (événements d'instruction, attente d'I/O de table/index, attente de verrouillage de table)	par unité `metadata.yaml` : ns	nanosecondes

Type de télémétrie

Champs

Unité

Événements de log (

query_sample

top_query

)

sum_timer_wait

events_statements_current.timer_wait

events_waits_current.timer_wait

secondes

Métriques (événements d'instruction, attente d'I/O de table/index, attente de verrouillage de table)

par unité

metadata.yaml

: ns

nanosecondes

Important

mysql.events_waits_current.timer_wait est le seul champ qui est une durée d’attente/blocage véritable et distincte (et non le temps total écoulé). Associez-le avec mysql.wait_event_type / mysql.wait_event (ou le mysql.wait_type brut).

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.

Guide de dépannage

Apprenez à résoudre les problèmes courants liés au monitoring MySQL.

Cette traduction automatique est fournie pour votre commodité.

Métriques par défaut

Métriques supplémentaires

Connexions, threads & sessions

Statistiques de requête & d'instruction

Tables & schéma

Métadonnées de réplication & de serveur

Événements de log

`db.server.query_sample`

Conseil

`db.server.top_query`

`db.server.query_plan`

Collecte du plan d’exécution

Important

Unités de temps

Important

Instrumentation dans les environnements auto-hébergés

Instrumentation dans les environnements RDS

Guide de dépannage

Cette traduction automatique est fournie pour votre commodité.

Référence des métriques MySQL NRDOT

Métriques supplémentaires .css-21sua1{background:none;border:none;width:0;padding:0;}

Connexions, threads & sessions

Statistiques de requête & d'instruction

Tables & schéma

Métadonnées de réplication & de serveur

Événements de log

db.server.query_sample

Conseil

db.server.top_query

db.server.query_plan

Collecte du plan d’exécution

Important

Unités de temps

Important

Documentation associée

Instrumentation dans les environnements auto-hébergés

Instrumentation dans les environnements RDS

Guide de dépannage

Métriques supplémentaires

`db.server.query_sample`

`db.server.top_query`

`db.server.query_plan`