Integrate PMM with Percona Platform¶
Percona Platform brings together database distributions, support expertise, services, management, and automated insights.
Connect your PMM servers to Percona Platform to boost the monitoring capabilities of your PMM installations and manage database deployments easier. In addition, you get access to PMM updates, automated insights, advanced advisor checks and more alert rule templates.
Connect PMM to Percona Platform¶
You can connect to Percona Platform with a Percona Account or via Google or GitHub authentication. If Percona Support has enabled a custom identity provider for your account, you can also log in using your company’s credentials.
We recommend that you connect with a Percona Account, as this gives you access to other Percona services, including Percona Platform, Percona Customer Portal, and Community Forum. If you don’t have a Percona Account, you can create one on the Percona Platform homepage using the Don’t have an account? Create one? link.
Prerequisites¶
To ensure that PMM can establish a connection to Percona Platform:
Upgrade to PMM 2.27.0 or later¶
Before connecting your PMM server to Percona Platform, make sure you are using PMM version 2.27 or newer. Otherwise, upgrade your PMM installation beforehand.
This is required because, starting with PMM 2.27, Percona Platform has replaced username/password authentication with access token authentication. Access-token authentication increases security and enables federated identity.
This change did not affect existing connections to PMM Platform, which were not automatically terminated.
For more information, see Install and set up PMM.
Check that you are a member of an existing Platform organization¶
To check whether you are a member of an existing Platform organization:
-
Log in to Percona Platform using your Percona Account. If you are connecting via GitHub, make sure you set your email address as public in your GitHub account. If your email address is private instead, Percona Platform cannot access it to authenticate you.
-
On the Getting Started page, check that the Create organization step shows an option to view your organization.
Contact your account administrator or create a new organization for your Percona Account if this is the case.
Set the public address of your PMM server¶
PMM automatically detects and populates the public address of the PMM server when this is not set up. If you need to set it differently, go to Settings > Advanced Settings and edit the Public Address field.
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.