PMM Client installation overview¶
PMM Client is the component of Percona Monitoring and Management (PMM) that collects metrics from your database servers and sends them to PMM Server for analysis and visualization.
Common installation process at a glance
While specific steps vary by deployment method, the general installation process includes:
- Install PMM Client using your preferred method and register the Client node with your PMM Server.
- Add database services for monitoring.
- Verify monitoring data in the PMM web interface.
Prerequisites¶
Complete these steps to prepare your system for PMM installation:
-
Check system requirements to ensure your environment meets the minimum criteria.
-
Install and configure PMM Server using your preferred deployment method. You’ll need PMM Server’s IP address or hostname to configure PMM Client.
-
Set up firewall rules to allow communication between PMM Client and PMM Server.
-
Create monitoring users with necessary permissions for your database
-
Check that you have administrator access to install PMM Client
Deployment options¶
Install PMM Client using one of the following deployment methods:
Your setup | Recommended deployment |
---|---|
Production environments on supported Linux distributions | Package Manager → |
Unsupported Linux distributions or non-root installation | Binary Package → |
Containerized environments or testing | Docker → |
Connect services¶
Each database service requires specific configuration parameters. Configure your service according to its service type:
- MySQL (and variants Percona Server for MySQL, Percona XtraDB Cluster, MariaDB)
- MongoDB
- PostgreSQL
- ProxySQL
- Amazon RDS
- Microsoft Azure
- Google Cloud Platform (MySQL and PostgreSQL)
- Linux
- External services
- HAProxy
- Remote instances
Modifying service configurations¶
If you need to modify the configuration of a service you’ve already added, you’ll need to remove the service and re-add it with the new parameters.
Next steps¶
- Connect database services for monitoring
- Configure optimization settings for specific database types