Skip to content

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 Configuration PMM Inventory Add Instance.

  6. Click MySQL Add a remote instance.

  7. Fill in the details for the remote MySQL instance.

    • Ensure Use performance schema is selected.
  8. Click Add service.

  9. Check for values in the MySQL Instance Overview 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 Configuration PMM Inventory Add Instance.

  6. Select PostgreSQL Add a remote instance.

  7. Fill in the details for the remote PostgreSQL instance:

    • In Stat tracking options, select PG Stat Statements.
  8. Click Add service.

  9. Check for values in the PostgreSQL Instance Overview dashboard 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).

    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.