Connect Google Cloud Platform instance

PMM can monitor MySQL or PostgreSQL instances hosted on the Google Cloud Platform.

The connection can be direct, or indirect using Cloud SQL Proxy.

MySQL

To add a MySQL instance on Google Cloud:

1. Set up a MySQL instance on Google Cloud.

2. The database server must be accessible by PMM Client. If PMM Client is not also hosted on GCP, you will need to add a network interface with a public interface.

3. Configure Performance Schema on the MySQL server. Using the GCP console’s Cloud Shell or your own gcloud installation, run:

   gcloud sql instances patch <instance_name> --database-flags performance_schema=on
   

4. Log into the PMM user interface.

5. Select PMM Configuration > PMM Inventory > Service > Add Service > MySQL.

6. Fill in the details for the remote MySQL instance and make sure to enable the Use performance schema option.

7. Click Add service.

8. Go to Dashboards and check for values in the MySQL Instance Summary dashboard and in Query Analytics.

PostgreSQL

To add a PostgreSQL instance on Google Cloud:

1. Set up a PostgreSQL instance on Google Cloud.

2. The database server must be accessible by PMM Client. If PMM Client is not also hosted on GCP, you will need to add a network interface with a public interface.

3. Configure pg_stat_statements. Open an interactive SQL session with your GCP PostgreSQL server and run:

   CREATE EXTENSION pg_stat_statements;
   

4. Log into the PMM user interface.

5. Select PMM Configuration > PMM Inventory > Services > Add Service > PostgreSQL.

6. Fill in the details for the remote PostgreSQL instance and make sure to PG Stat Statements option under Stat tracking options.

   

7. Click Add service.

8. Go to Dashboards and check for values in the PostgreSQL Instances Overview and Query Analytics.

Cloud SQL Proxy

MySQL

To add a MySQL instance:

1. Create instance on GCP.

2. Note connection as <project_id>:<zone>:<db_instance_name>.

3. Enable Admin API and download the JSON credential file.

4. Enable Performance Schema.

5. Run Cloud SQL Proxy (runs on PMM Client node).

   As a Docker containerOn Linux

   docker run -d \
   -v ~/path/to/admin-api-file.json:/config \
   -p 127.0.0.1:3306:3306 \
   gcr.io/cloudsql-docker/gce-proxy:1.19.1 \
   /cloud_sql_proxy \
   -instances=example-project-NNNN:us-central1:mysql-for-pmm=tcp:0.0.0.0:3306 \
   -credential_file=/config
   

   wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.amd64 -O cloud_sql_proxy
   chmod +x cloud_sql_proxy
   ./cloud_sql_proxy -instances=example-project-NNNN:us-central1:mysql-for-pmm=tcp:3306 \
   -credential_file=/path/to/credential-file.json
   

6. Add instance.

   pmm-admin add mysql --host=127.0.0.1 --port=3306 \
   --username=root --password=secret \
   --service-name=MySQLGCP --query-source=perfschema
   

PostgreSQL

To add a PostgreSQL instance:

1. Create instance on GCP.

2. Note connection as <project_id>:<zone>:<db_instance_name>.

3. Enable Admin API and download the JSON credential file.

4. Run Cloud SQL Proxy.

   ./cloud_sql_proxy -instances=example-project-NNNN:us-central1:pg-for-pmm=tcp:5432 \
   -credential_file=/path/to/credential-file.json
   

5. Log into PostgreSQL.

6. Load extension:

   CREATE EXTENSION pg_stat_statements;
   

7. Add service:

   pmm-admin add postgresql --host=127.0.0.1 --port=5432 \
   --username="postgres" --password=secret --service-name=PGGCP
   

Get expert help

If you need assistance, you can find comprehensive and free database knowledge on our community forum or blog posts. For professional support and services, contact our Percona Database Experts.

Community Forum Get a Percona Expert