Skip to content
logo
Percona Monitoring and Management
PMM 2.29.0
Initializing search
    percona/pmm-doc
    percona/pmm-doc
    • Welcome
        • Network
        • Docker
        • Podman
        • Helm
        • Virtual Appliance
        • AWS Marketplace
        • Easy-install script
        • MySQL
        • MongoDB
        • PostgreSQL
        • ProxySQL
        • Amazon RDS
        • Microsoft Azure
        • Google Cloud Platform
        • Linux
        • External Services
        • HAProxy
        • Remote instances
      • User Interface
      • Percona Alerting
        • Prepare a storage location
          • MongoDB backup prerequisites
          • Create MongoDB on-demand and scheduled backups
          • Create MongoDB PITR backups
          • Restore a MongoDB backup
          • MongoDB Backup and Restore support matrix
          • MySQL backup prerequisites
          • Create a MySQL backup
          • Restore a MySQL backup
        • Edit a scheduled backup
        • Delete a backup
        • Configure access control
        • Labels for access control
        • Create access roles
        • Manage access roles
        • Assign roles to users
        • Use Case
      • Query Analytics
      • Working with Advisors
      • Configure
      • Manage users
      • Upgrade
      • Secure
      • Optimize
      • Annotate
      • Share dashboards and panels
      • Extend Metrics
      • Resolve issues
        • Check Percona Portal account information
      • Architecture
      • UI components
      • PMM components and versions
      • Data handling in PMM
      • Develop Advisor checks
      • PMM Inventory
        • Manage dashboards
            • Advanced Data Exploration
            • VictoriaMetrics
            • VictoriaMetrics Agents Overview
            • Environment Summary
            • Kubernetes Pods Status
            • Kubernetes Volumes
          • DBaas
            • Disk Details
            • Network Details
            • Memory Details
            • Node Temperature Details
            • Nodes Compare
            • Nodes Overview
            • Node Summary
            • NUMA Details
            • Processes Details
            • Prometheus Exporters Overview
            • MySQL Command/Handler Counters Compare
            • MySQL InnoDB Compression Details
            • MySQL InnoDB Details
            • MySQL MyISAM/Aria Details
            • MySQL MyRocks Details
            • MySQL Instance Summary
            • MySQL Instances Compare
            • MySQL Instances Overview
            • MySQL Wait Event Analyses Details
            • MySQL Performance Schema Details
            • MySQL Query Response Time Details
            • MySQL Replication Summary
            • MySQL Group Replication Summary
            • MySQL Table Details
            • MySQL User Details
            • MySQL TokuDB Details
            • Experimental MongoDB Collection Details
            • Experimental MongoDB Oplog Details
            • MongoDB Cluster Summary
            • MongoDB Instance Summary
            • MongoDB Instances Overview
            • MongoDB Instances Compare
            • MongoDB ReplSet Summary
            • MongoDB InMemory Details
            • MongoDB MMAPv1 Details
            • MongoDB WiredTiger Details
            • PostgreSQL Instance Summary
            • PostgreSQL Instances Compare
            • Experimental PostgreSQL Vacuum Monitoring
          • ProxySQL Dashboards
            • PXC/Galera Cluster Summary
            • Experimental PXC/Galera Cluster Summary
            • PXC/Galera Nodes Compare
            • HAProxy Instance Summary
        • pmm-admin - PMM Administration Tool
        • pmm-agent - PMM Client agent
      • API
      • VictoriaMetrics
      • ClickHouse
      • PostgreSQL
      • Glossary
      • Introduction
      • DBaaS architecture
        • Setting up DBaaS
        • Create a Kubernetes Cluster
        • Deleting Kubernetes clusters
        • Activating DBaaS
        • Add a Kubernetes cluster automatically
        • Add a Kubernetes cluster manually
        • Manage allowed component versions
          • OLM installation
          • Operators installation
        • Add a DB Cluster
        • Manage a DB Cluster
        • Delete a DB Cluster
        • Create a database cluster from a template
      • Backup and restore
    • FAQ
      • PMM 2.39.0
      • PMM 2.38.1
      • PMM 2.38.0
      • PMM 2.37.1
      • PMM 2.37.0
      • PMM 2.36.0
      • PMM 2.35.0
      • PMM 2.34.0
      • PMM 2.33.0
      • PMM 2.32.0
      • PMM 2.31.0
      • PMM 2.30.0
      • PMM 2.29.1
      • PMM 2.29.0
        • Release Highlights
          • Guided tour of PMM
          • Deploying PMM in various environments
            • K8s
            • Podman
            • Local file system
            • RHEL 9 support (client):
          • Monitoring
            • Meta metrics
            • PXC Cluster dashboard
          • Troubleshooting
            • Managing logs
            • Additional parameters added in commands
          • Percona Platform Integration
            • Terminate Percona Platform connections as an Admin
            • Easier access to your Percona Support Specialist
          • Advisors
            • Extended severities for advisor checks and alerts
            • Use filters to explore available advisors checks
          • DBaaS
          • Components upgrade
          • Important bug fixes
        • New Features
        • Improvements
        • Bugs Fixed
      • PMM 2.28.0
      • PMM 2.27.0
      • PMM 2.26.0
      • PMM 2.25.0
      • PMM 2.24.0
      • PMM 2.23.0
      • PMM 2.22.0
      • PMM 2.21.0
      • PMM 2.20.0
      • PMM 2.19.0
      • PMM 2.18.0
      • PMM 2.17.0
      • PMM 2.16.0
      • PMM 2.15.1
      • PMM 2.15.0
      • PMM 2.14.0
      • PMM 2.13.0
      • PMM 2.12.0
      • PMM 2.11.1
      • PMM 2.11.0
      • PMM 2.10.1
      • PMM 2.10.0
      • PMM 2.9.1
      • PMM 2.9.0
      • PMM 2.8.0
      • PMM 2.7.0
      • PMM 2.6.1
      • PMM 2.6.0
      • PMM 2.5.0
      • PMM 2.4.0
      • PMM 2.3.0
      • PMM 2.2.2
      • PMM 2.2.1
      • PMM 2.2.0
      • PMM 2.1.0
      • PMM 2.0.1
      • PMM 2.0.0
      • Copyright and licensing information
      • Trademark policy

    • Release Highlights
      • Guided tour of PMM
      • Deploying PMM in various environments
        • K8s
        • Podman
        • Local file system
        • RHEL 9 support (client):
      • Monitoring
        • Meta metrics
        • PXC Cluster dashboard
      • Troubleshooting
        • Managing logs
        • Additional parameters added in commands
      • Percona Platform Integration
        • Terminate Percona Platform connections as an Admin
        • Easier access to your Percona Support Specialist
      • Advisors
        • Extended severities for advisor checks and alerts
        • Use filters to explore available advisors checks
      • DBaaS
      • Components upgrade
      • Important bug fixes
    • New Features
    • Improvements
    • Bugs Fixed

    Percona Monitoring and Management 2.29.0¶

    Release date: July 19, 2022
    Installation: Installing Percona Monitoring and Management

    Percona Monitoring and Management (PMM) is an open source database monitoring, management, and observability solution for MySQL, PostgreSQL, and MongoDB.

    Important

    We recommend using the latest version of PMM. This ensures that you have access to the latest PMM features and that your environment runs on the latest version of the underlying components, such as VictoriaMetrics, with all the bug fixes in place.

    Release Highlights¶

    Guided tour of PMM¶

    PMM now includes a short in-app tutorial that automatically pops up when you first launch the application.

    If you are a new user, this is your virtual unboxing of key PMM features to help you get started easier.

    If you are an Intermediate or Advanced user, use the tour as a checklist of features worth exploring to ensure you’re making the most out of your PMM.

    Deploying PMM in various environments¶

    K8s¶

    Disclaimer

    Deploying PMM on Kubernetes is still technical preview and is subject to change. We recommend that early adopters use this feature for testing purposes only.

    Starting with PMM 2.29.0, we have introduced the helm chart supported by Percona to seamlessly deploy your PMM instances on Kubernetes (k8s), a prominent container orchestration system. With the Helm chart, you can customize your deployment. You can tweak your PMM installation by setting these various parameters. For more information, see the documentation.

    Before introducing the helm chart for PMM, if you wanted to deploy PMM, you would need a separate virtual machine to run PMM, but with the helm chart, that is not required. Helm Charts provide the ability to leverage Kubernetes packages at the click of a button or a single CLI command.

    Podman¶

    Disclaimer

    Podman support is still technical preview and is subject to change. We recommend that early adopters use this feature for testing purposes only.

    Starting with PMM 2.29.0, get your PMM instances up and running quickly with the Podman. Using Podman makes it easy to run, build, and deploy PMM.

    Deployment of PMM with the Podman is far more secure as it does not require root privileges to create, run and manage containers. It lets you run containers as a non-root user, so you never have to give a user root permission on the host. Thus it adds a new security layer, which is crucial in the event of a security breach. Podman also allows multiple unprivileged users to run containers on the same machine. For more information on deploying PMM on Podman, see the documentation.

    Local file system¶

    You can start your PMM instances without a data container using your local file system.

    You can use docker volume or host directory with the -v docker-cli option for storing PMM state (databases, configs, etc.)

    RHEL 9 support (client):¶

    PMM client now supports RHEL 9.

    Monitoring¶

    Meta metrics¶

    We have added some metrics for Mongodb exporters to monitor the time it takes to collect data for different collectors. With these metrics, you can identify the monitoring cost of various collectors by the MongoDB exporters.

    PXC Cluster dashboard¶

    Important

    This experimental dashboard is subject to change. It is recommended to use this dashboard for testing purposes only.

    Created a new experimental PXC/Galera Cluster Summary dashboard to make it simple, intuitive, and provide at-a-glance visibility for better decision making. Critical data for the PXC cluster is put together in this dashboard to obtain feedback from our users. For more information, refer to the documentation.

    Earlier, the PXC Cluster data was distributed over different dashboards. The users had to browse the MySQL compare dashboard to check for the data like slow queries and network overviews that were not in the PXC nodes compare dashboard. This made it time-consuming to identify any possible issues with the database. With the new PXC dashboard, we aim to solve this problem and gain insightful data about the cluster and services. Now the users can have an overview of the PXC clusters from this dashboard. Also, users with beginner to intermediate levels of expertise can effortlessly analyze the data on this dashboard.

    Troubleshooting¶

    Managing logs¶

    As a PMM user, you can explicitly set a detailed level of logging so that, by default, you will have meaningful logs to see, thereby enhancing your troubleshooting experience.

    If you want detailed logging, you can set --log-level to INFO. By default, INFO is not logged. Thus, you have more control over the logs you want to view with the --log-level parameter with the flexibility to choose options such as warning, error, fatal, and info.

    For example, to set the log level to fatal for a MySQL database:

    pmm-admin add mysql --username=XXX --password=XXX --log-level=fatal

    Additional parameters added in commands¶

    • Added the agent (exporter) port to the output of the pmm-admin commands, which is crucial during debugging.

      pmm-admin list
      pmm-admin status
      pmm-admin inventory list agents
      
    • Added new flag --agent-password to the following commands to support a custom password via the CLI to make it more secure:

      pmm-admin register --agent-password=AGENT-PASSWORD
      pmm-admin config --agent-password=AGENT-PASSWORD`
      
    • You can use the pprof parameter in the pmm-admin summary command.

      pmm-admin summary --pprof
      

      pprof reads a collection of profiling data from the PMM server, enabling you to generate reports in textual and graphical formats to visualize and analyze data.

      You can analyze CPU, Memory usage, heap size, and thread count for your PMM components with the data obtained.

    Percona Platform Integration¶

    Terminate Percona Platform connections as an Admin¶

    When regular users are not able to disconnect a server (for example, when PMM was moved to a network segment without outbound connections to public networks), PMM Admins can now terminate such connections instead.

    The Disconnect option under Settings > Percona Platform now enables PMM Admins to retire PMM instances from Percona Platform even if they are not logged in with a Percona Account.

    When disconnecting servers without a Percona Account, the lingering servers are not automatically removed from the list of PMM instances in Percona Platform. As a Percona Platform Admin, you can ensure that your list of PMM instances stays up-to-date by manually removing those unavailable servers via PMM instances.

    Easier access to your Percona Support Specialist¶

    If you are a Percona customer, you can now find the contact details of your dedicated Percona Support Specialist on the new clouds Environment Overview tab on the main menu.

    The Percona Contacts section here shows the name and email of the Customer Success Manager assigned to your organization, who can help with any PMM queries. This new tab will soon be populated with more useful information about your PMM environment.

    Advisors¶

    Extended severities for advisor checks and alerts¶

    We have extended and unified the list of severity levels for the notifications coming from Integrated Alerting and Advisor Checks. When you create a new alert rule, you can now choose from a broader range of severity labels: Emergency, Alert, Critical, Error, Warning, Notice, Info, Debug.

    The same severities are now also available for notifications coming from failed checks under Advisor Checks > Failed Checks. We’ve also made a small UX improvement to the way failed checks are grouped by severity in the table.

    Use filters to explore available advisors checks¶

    As we’re constantly adding more advisors for checking the health of your connected databases, you may find it useful to now be able to drill-down through this constantly growing list.

    Use the filters on the Advisors Checks > All Checks page to search advisors by Name, Description, Status or Interval. If you need to share the filtered results with your team members, send them the PMM URL, which saves your search criteria and results.

    DBaaS¶

    Simplified the API such that it requires fewer parameters to run the API.

    With this new implementation, the only mandatory field is the Kubernetes cluster name. All other fields such as resource parameters, image field, params field, and name filed are optional. The API sets these to default values if these fields are not specified.

    Also, the documentation has been enhanced for these APIs.

    Components upgrade¶

    • Upgraded VictoriaMetrics operator to version 0.24.
    • Upgraded the ClickHouse plugin to 2.4.4, which fixes some of the CVEs.
    • With this release, we are upgrading grpc-gateway to version 2.0, which deprecates the error field in error responses. If you are using the PMM API, ensure to replace this with the new message field from the Google Cloud API Error model.
    • Upgraded the mysqld exporter to the upstream version 0.14.0.

    Important bug fixes¶

    • PMM-9981: Fixed excessive space usage for Group replication monitoring. Services with enabled group replication and custom queries now take up less disk space and perform faster. To achieve this, we removed the Transactions Details table from the Group Replication dashboard, as these were based on labels that were generating high-cardinality data.

      If you still have issues with performance in Group Replication dashboard, log into PMM as an admin, and use https://pmm_server_url/prometheus/api/v1/admin/tsdb/delete_series?match[]= to remove all time series for the following metrics:

      • mysql_perf_schema_replication_group_worker_rep_delay_seconds
      • mysql_perf_schema_replication_group_worker_transport_time_seconds
      • mysql_perf_schema_replication_group_worker_time_RL_seconds
      • mysql_perf_schema_replication_group_worker_apply_time_seconds
      • Mysql_perf_schema_replication_group_worker_lag_in_secondds

      For example, to remove all time series for the mysql_perf_schema_replication_group_worker metric use the following URL: https://PMM_SERVER_URL/prometheus/api/v1/admin/tsdb/delete_series?match[]=mysql_perf_schema_replication_group_worker_rep_delay_seconds

    • PMM-9510: Fixed incorrect and duplicate information displayed on the Dashboard for MongoDB Replica Set.

    New Features¶

    • PMM-10133: New User Onboarding: Added a guided tour that highlights the main PMM components on your first onboarding journey.

    • PMM-10059: Advisors: Extended and unified list of severity levels for the notifications coming from Integrated Alerting and Advisor Checks.

    • PMM-7110: You can now obtain profiling data with the pprof tool that helps analyze CPU, Memory usage, heap size, and thread count for your PMM components.

    • PMM-8660: Percona customers can now find the contact details of their dedicated Percona Support Specialist on the new Environment Overview tab on the main menu.

    • PMM-7925: [Technical Preview]: Starting with PMM 2.29.0, you can now deploy your PMM instances using Podman, which is considered far more secure as it does not require root access.

    • PMM-9613: [Technical Preview]: You can now scale and deploy your PMM instances faster using the Kubernetes clusters.

    • PMM-9919: We have added some additional metrics to Mongodb exporters to monitor the time it takes to collect data for different collectors that would allow us to identify the monitoring cost of various collectors by MongoDB exporters.

    Improvements¶

    • PMM-9766: Advisors: Added filters on the Advisors Checks > All Checks page to narrow the list of available advisor checks.

    • PMM-7491: Alerting: We’ve redefined the Filters option under Integrated Alerting > Alert Rules > New Rule to simplify the way you target specific services or nodes for your alert rules.

    • Instead of typing an exact filter pattern, you can now intuitively create a filter by choosing from the available operators and filling in the predefined fields. So instead of typing: service_name=name123, just fill in the following fields: !filters

    • PMM-9704: With the implementation of a simplified API for DBaaS, you only have to specify the Kubernetes cluster name. All the other fields are optional, and the API will set the default values for these fields if not specified.

    • PMM-8222: DBaaS: Enhanced the documentation for the API.

    • PMM-9611: PMM now warns you if your current domain is different than the one specified in the Grafana .INI configuration file. Since this can generate incorrect short URLs when sharing the link to a PMM dashboard, make sure to correct this mismatch if you see a warning on the Share Panel > Link page.

    • PMM-7326: You now have more control over the logs you want to view with the –log-level parameter. With this enhancement, you can experience more pronounced logging with the flexibility to choose options such as warning, error, and fatal.

    • PMM-8566: For enhanced security, you can now specify the custom Basic Auth password for agents when adding a Node.

    • PMM-9362: PMM Admins can now disconnect servers from Percona Platform even if they are not logged in with a Percona Account Percona Account.

    • PMM-6592: PMM now displays the ports used by the exporters in the output of the pmm- admin list and status commands, which are crucial while debugging.

    • PMM-7110: You can now use the pprof parameter in the pmm-admin summary command to obtain profiling data from the PMM server, thereby enabling you to generate reports in textual and graphical formats to visualize and analyze data.

    • PMM-7186: The pmm-admin summary command now retrieves a list of targets scraped by Victoriametrics on the client-side.

    • PMM-8308: To enhance the troubleshooting experience, in addition to the information summary and archive, you can now view the paths for all the exporters managed by the pmm-agent in the diagnostic data.

    • PMM-9650: Created a new experimental dashboard for PXC Cluster Summary to make it simple and intuitive.

    • PMM-10039: VictoriaMetrics operator has been upgraded to 0.24.

    • PMM-10083: Upgraded the ClickHouse plugin to 2.4.4, which fixes some of the CVEs.

    • PMM-10103: Added RHEL 9 support for PMM client.

    • PMM-10155: Access QAN from the main menu instead of the PMM dashboard for better reach and visibility.

    • PMM-2038: Starting with PMM 2.29.0, we have upgraded the mysqld exporter to the upstream version.

    • PMM-9913: PMM removes all the unnecessary temporary files created while adding a monitoring service, which might impact your PMM server’s performance if not deleted.

    • PMM-10067: Updated the version of Percona Toolkit to 3.4.0.

    Bugs Fixed¶

    • PMM-10127: Alerting: Fixed issue where changing the page under Integrated Alerting > Alerts would not update the list of results.

    • PMM-10110: DBaas: Fixed an issue where an incorrect operator version was installed.

    • PMM-9965: DBaas: Fixed an issue where re-registering a K8s cluster returned an error.

    • PMM-7143: DBaaS: Fixed an issue where proper node metrics were not exposed for database instances created with DBaaS.

    • PMM-8677: DBaaS: Fixed the names of the operators used in PMM on the DBaaS UI to reflect their official names rather than short forms.

    • PMM-9998: Fixed an issue where ‘Unknown column…’ errors are thrown when monitoring MariaDB from the Debian package (10.2, 10.3, 10.4, 10.5).

    • PMM-10144: Fixed an issue where if an already existing service was added via CLI, incorrect output was being displayed.

    • PMM-9320: Fixed an issue where it was impossible to add MongoDB to PMM when the password contained “+.”

    • PMM-9909: Fixed an issue where the redirection from Home Dashboard Stats Panel to Node Summary did not work.

    • PMM-10049: Removed unnecessary error messages from the pmm-agent log.

    • PMM-8819: Fixed an issue where the metric data displayed in the table was not appropriately aligned.

    • PMM-10087: PMM would show an “Internal server error” for custom alert rules created with a “ia=1” label. This issue is now fixed.

    • PMM-7462: Fixed an issue where you can update the PMM settings via the UI if they are not provided as an Environment variable.

    • PMM-9510: Fixed incorrect and duplicate information displayed on the Dashboard for MongoDB Replica Set.

    • PMM-9910: Fixed an issue where upgrading PMM from 2.26.0 to 2.27.0 via the UI failed due to a GRPC error.

    • PMM-9981: Enormous space usage and slow queries for Group replication monitoring

    • PMM-10069: Fixed a typo in the tooltip for InnoDB Random Read Ahead.

    • PMM-10161: Removed unnecessary breadcrumb navigation panel from all dashboards.

    Contact us

    For free technical help, visit the Percona Community Forum.

    To report bugs or submit feature requests, open a JIRA ticket.

    For paid support and managed or consulting services , contact Percona Sales.


    Last update: 2023-09-22
    Percona LLC, © 2023
    Made with Material for MkDocs

    Cookie consent

    We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better. Read more about Percona Cookie Policy.