Register a MySQL or Percona database instance

Complete the following steps to register an individual MySQL or Percona 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 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 or Percona 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 DPA to retrieve query execution plans and generate tuning advisors, the privileged user must also be able to grant the following permissions:

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

Complete the registration wizard

In the upper-left corner of the DPA home page, click Register DB Instance for Monitoring.
Under Self-managed, click MySQL or Percona. Then click Next.
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).
  In DPA 2024.3 and earlier: If you are registering a MySQL 8.0 instance, you must create the monitoring user manually and you must include the following in the CREATE USER command:
  IDENTIFIED WITH mysql_native_password BY 'yourPassword';
  DPA ignores data generated by the monitoring user on the monitored database instance. For this reason, create a separate account for the monitoring user. Do not specify an existing user that generates 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.
3. If the database server uses SSL, click Advanced Connection Properties. Then enter the following in JDBC URL Properties:
  trustServerCertificate=true;useSSL=true
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.
(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

Select a Typical or Custom configuration. SolarWinds recommends the Typical configuration.

Typical is recommended. With this option:
- The DPA Recommended option (shown in the following table) is used for Performance Schema setup.
- DPA can run EXPLAIN on SELECT, INSERT, UPDATE, and DELETE statements.

If you select Custom, you can:

Specify what data the Performance Schema collects and maintains. The following table shows which consumers and instruments each option enables.
Specify what types of SQL statements DPA can run EXPLAIN on.

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.

Option	Server Default	DPA Recommended	Detailed	Leave 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_OR_MARIADB_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.

In DPA 2024.3 and earlier, the MYSQL_OR_MARIADB_PERFORMANCE_SCHEMA option was named MYSQL_PERFORMANCE_SCHEMA.

If you specified a privileged user to create the DPA monitoring user, the wizard displays the Allow EXPLAIN to be run on section. Select what type of statements you want DPA to collect execution plans for. The monitoring user can run EXPLAIN on the selected statement types, and this data is used to generate tuning advisors.
Click Next.
Review the information, and click Register Database Instance.
When the registration is complete, click Finish to return to the DPA home page.

Search SolarWinds Support

Register a MySQL or Percona database instance

Identify the privileged user

Complete the registration wizard