Documentation forDatabase Performance Analyzer

Register a MySQL, Percona, or Maria database instance

Complete the following steps to register an individual MySQL, Percona, or Maria database instance for monitoring with DPA.

You can use the registration wizard to register a read/write MySQL database instance. To register a read-only instance, see Monitor a read-only MySQL database instance in DPA.

To optimize DPA's reporting capabilities for a MySQL, Percona, or Maria database instance, see the requirements for monitoring MySQL database instances.

You can also use mass registration to registrations to register multiple database instances, or you can register database instances using scripts that call the DPA API.

If you register a database instance within the 14-day trial period, DPA begins monitoring the instance immediately. After the trial period, you must activate a license to monitor the database instance.

Identify the privileged user

If you choose to let DPA create or configure the account used to collect DPA data (the monitoring user), you must provide the credentials of a privileged user. (You can also choose to create the monitoring user yourself.) During registration, the privileged user either creates the monitoring user or grants the required privileges to an existing user that you designate as the monitoring user. DPA does not store the credentials of the privileged user. 

For self-managed MySQL, Percona, or Maria database instances:

  • The privileged user requires the following permission: 

    CREATE USER

  • The privileged user must be able to grant the following permissions:

    PROCESS on *.*
    SELECT & UPDATE on performance_schema.*

  • To enable the retrieval of query execution plans, the privileged user must also be able to grant the following permissions:

    SELECT, INSERT, UPDATE, DELETE on *.*
    SYSADM

Complete the registration wizard

  1. In the upper-left corner of the DPA home page, click Register DB Instance for Monitoring.
  2. Under Self-managed, click MySQL. Then click Next.
  3. Enter the following connection information:
    1. Enter the host name or IP address and port of the server.

      DPA monitors all databases within the instance. If more than one instance exists on the server, you must register each instance separately in DPA.

    2. Create or specify the account that DPA will use to gather information (the monitoring user).

      If you are registering a MySQL 8.0 instance, you must create the repository user manually, and you must include the following in the CREATE USER command:

      IDENTIFIED WITH mysql_native_password BY 'yourPassword';

      SolarWinds recommends creating a separate account for the monitoring user.

      DPA ignores data generated by the monitoring user on the monitored database instance. For this reason, do not specify a user that causes load on the monitored instance.

      • To let DPA create or configure the monitoring user:

        1. Select Let DPA create a new user or configure an existing user for me.
        2. Enter the credentials of an existing user with the required privileges.

          The credentials for the privileged user are not used or stored after the registration.

        3. Select a Tablespace and Temp Tablespace on the monitored database. This is primarily used for gathering Explain Plan data for monitored queries.
        4. Click Next.
      • To create the monitoring user yourself:

        1. Select I'll create the database user.
        2. Click Monitoring User Creation Script.
        3. Copy the script to a file and edit it per the instructions.
        4. Copy the edited script to the MySQL console, and run it.

          The monitoring user is created.

        5. Enter this user's credentials in the Username and Password fields.

      If your repository database is Oracle, the Oracle Repository Tablespace panel opens. If not, continue with step 5.

  4. If your repository database is Oracle, choose the tablespace in the repository database to store DPA performance data for this monitored instance. Then click Next.

    By default, the performance data is stored in the default tablespace of the repository user. However, data for monitored instances can be stored in separate tablespaces.

    If your repository database is not Oracle, the wizard skips this step.

  5. (Optional) Select the alert groups you want the new database instance to join. Then click Next.

    • If no alert groups exist, or the existing groups do not match the database type of this instance, the wizard skips this step.

    • Group membership can be changed after registration

  6. Select a Typical or Custom configuration. SolarWinds recommends the Typical configuration
    • Typical is recommended. With this option:

      • The DPA Recommended option is used for Performance Schema setup.
      • EXPLAIN can be run on SELECT statements.
    • Select Custom to change the Performance Schema setup and to allow EXPLAIN to be run on different statements. Then specify what data the Performance Schema collects and maintains. This table shows which consumers and instruments each option enables.

      The MySQL Performance Schema must be enabled. If you select Leave As Is, verify that Global Instrumentation and Thread Instrumentation are enabled in the existing Performance Schema configuration.

      OptionServer defaultDPA recommendedDetailedLeave as is
      Consumer Global Instrumentation

      NC*

      Consumer Thread Instrumentation

      NC

      Consumer Statement Digest

      NC

      Consumer Statement (Current)

      NC

      Consumer Wait (Current) NC
      Instrument Wait (Lock/*) NC
      Instrument Wait (I/O table) (I/O/file) NC
      Instrument Wait (I/O/socket) NC
      Instrument Wait (Synch/*)  NC

      *NC = No change. DPA does not change the existing Performance Schema configuration.

      Values that are outside of the MYSQL_PERFORMANCE_SCHEMA configuration scope of DPA are not changed. For example, an instrument named stage exists in the MySQL Performance Schema. If you enable or disable that instrument, DPA will not change it.

  7. If you specified a privileged user to create the DPA monitoring user, the Allow EXPLAIN to be run on section is displayed. Select what type of statements you want DPA to collect execution plans for. The monitoring user can run EXPLAIN on the selected statement types.

  8. Review the information and click Register Database Instance.

  9. When the registration is complete, click Finish to return to the DPA home page.