MySQL moduleedit

This module periodically fetches metrics from MySQL servers.

The default metricset is status.

Module-specific configuration notesedit

When configuring the hosts option, you must use a MySQL Data Source Name (DSN) of the following format:


You can also separately specify the username and password using the respective configuration options. Usernames and passwords specified in the DSN take precedence over those specified in the username and password config options.

- module: mysql
  metricsets: ["status"]
  hosts: ["tcp("]
  username: root
  password: secret


The mysql MetricSets were tested with MySQL and Percona 5.7 and 8.0 and are expected to work with all versions >= 5.7.0. It is also tested with MariaDB 10.2, 10.3 and 10.4.


The mysql module comes with a predefined dashboard. For example:

metricbeat mysql

Example configuration

The MySQL module supports the standard configuration options that are described in Modules. Here is an example configuration:

- module: mysql
    - status
  #  - galera_status
  #  - performance
  #  - query
  period: 10s

  # Host DSN should be defined as "user:pass@tcp("
  # or "unix(/var/lib/mysql/mysql.sock)/",
  # or another DSN format supported by <>.
  # The username and password can either be set in the DSN or using the username
  # and password config options. Those specified in the DSN take precedence.
  hosts: ["root:secret@tcp("]

  # Username of hosts. Empty by default.
  #username: root

  # Password of hosts. Empty by default.
  #password: secret

  # By setting raw to true, all raw fields from the status metricset will be added to the event.
  #raw: false

  # Optional SSL/TLS. By default is false.
  #ssl.enabled: true

  # List of root certificates for SSL/TLS server verification
  #ssl.certificate_authorities: ["/etc/pki/root/ca.crt"]

  # Certificate for SSL/TLS client authentication
  #ssl.certificate: "/etc/pki/client/cert.crt"

  # Client certificate key file
  #ssl.key: "/etc/pki/client/cert.key"


The following metricsets are available: