Skip to content
logo
Percona Monitoring and Management
Configure
Initializing search
    percona/pmm-doc
    percona/pmm-doc
    • Welcome
    • Setting up
      • Server
        • Network
        • Docker
        • Podman
        • Helm
        • Virtual Appliance
        • AWS Marketplace
        • Easy-install script
      • Client
        • MySQL
        • MongoDB
        • PostgreSQL
        • ProxySQL
        • Amazon RDS
        • Microsoft Azure
        • Google Cloud Platform
        • Linux
        • External Services
        • HAProxy
        • Remote instances
    • Get started
      • User Interface
      • Percona Alerting
      • Backup and Restore
        • Prepare a storage location
        • MongoDB backups
          • 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 backups
          • MySQL backup prerequisites
          • Create a MySQL backup
          • Restore a MySQL backup
        • Edit a scheduled backup
        • Delete a backup
      • Roles and permissions
        • Configure access control
        • Labels for access control
        • Create access roles
        • Manage access roles
        • Assign roles to users
        • Use Case
      • Query Analytics
      • Working with Advisors
    • How to
      • Configure
        • Metrics resolution
        • Advanced Settings
          • Data Retention
          • Telemetry
          • Check for updates
          • Advisors
          • Percona Alerting
          • Backup Management
          • Public Address
          • Database as a Service (DBaaS)
          • Microsoft Azure monitoring
        • SSH Key
        • Alertmanager integration
        • Percona Platform
      • Manage users
      • Upgrade
      • Secure
      • Optimize
      • Annotate
      • Share dashboards and panels
      • Extend Metrics
      • Resolve issues
      • Integrate with Percona Platform
        • Check Percona Portal account information
    • Details
      • Architecture
      • UI components
      • PMM components and versions
      • Data handling in PMM
      • Develop Advisor checks
      • PMM Inventory
      • Dashboards
        • Manage dashboards
          • Insight
            • Advanced Data Exploration
            • VictoriaMetrics
            • VictoriaMetrics Agents Overview
          • Environments
            • Environment Summary
          • Kubernetes
            • Kubernetes Pods Status
            • Kubernetes Volumes
          • DBaas
          • OS Dashboards
            • Disk Details
            • Network Details
            • Memory Details
            • Node Temperature Details
            • Nodes Compare
            • Nodes Overview
            • Node Summary
            • NUMA Details
            • Processes Details
          • Prometheus Dashboards
            • Prometheus Exporters Overview
          • MySQL Dashboards
            • 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
          • MongoDB Dashboards
            • 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 Dashboards
            • PostgreSQL Instance Summary
            • PostgreSQL Instances Compare
            • Experimental PostgreSQL Vacuum Monitoring
          • ProxySQL Dashboards
          • HA Dashboards
            • PXC/Galera Cluster Summary
            • Experimental PXC/Galera Cluster Summary
            • PXC/Galera Nodes Compare
            • HAProxy Instance Summary
      • Commands
        • 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
    • Release Notes
      • 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
      • 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

    • Metrics resolution
    • Advanced Settings
      • Data Retention
      • Telemetry
      • Check for updates
      • Advisors
      • Percona Alerting
      • Backup Management
      • Public Address
      • Database as a Service (DBaaS)
      • Microsoft Azure monitoring
    • SSH Key
    • Alertmanager integration
    • Percona Platform

    Configure¶

    The Settings page is where you configure PMM.

    Open the Settings page from the main menu with Configuration → Settings. The page opens with the Metrics Resolution settings tab selected.

    !image

    On the left are the selector tabs:

    • Configure
    • Metrics resolution
    • Advanced Settings
      • Data Retention
      • Telemetry
      • Check for updates
      • Advisors
      • Percona Alerting
      • Backup Management
      • Public Address
      • Database as a Service (DBaaS)
      • Microsoft Azure monitoring
    • SSH Key
    • Alertmanager integration
    • Percona Platform

    Tip

    Click Apply changes to save any changes made here.

    Metrics resolution¶

    Metrics are collected at three intervals representing low, medium and high resolutions.

    The Metrics Resolution settings tab contains a radio button with three fixed presets (Rare, Standard and Frequent) and one editable custom preset (Custom).

    !image

    Each preset is a group of low, medium and high resolutions. The values are in seconds.

    Time intervals and resolutions

    Short time intervals are high resolution metrics. Longer time intervals are low resolution. So:

    • A low-resolution interval increases the time between collection, resulting in low-resolution metrics and lower disk usage.
    • A high-resolution interval decreases the time between collection, resulting in high-resolution metrics and higher disk usage.

    The default values (in seconds) for the fixed presets and their resolution names are:

    Editable? Preset Low Medium High
    No Rare 300 180 60
    No Standard 60 10 5
    No Frequent 30 5 1
    Yes Custom (defaults) 60 10 5

    Values for the Custom preset can be entered as values, or changed with the arrows.

    If there is poor network connectivity between PMM Server and PMM Client, or between PMM Client and the database server being monitored, scraping every second may not be possible when the network latency is greater than 1 second.

    Advanced Settings¶

    !

    Data Retention¶

    Data retention specifies how long data is stored by PMM Server. By default, time-series data is stored for 30 days. You can adjust the data retention time to balance your system’s available disk space with your metrics history requirements.

    Telemetry¶

    The Telemetry switch enables gathering and sending basic anonymous data to Percona, which helps us to determine where to focus the development and what is the uptake for each release of PMM. Specifically, gathering this information helps determine if we need to release patches to legacy versions beyond support, determine when supporting a particular version is no longer necessary, and understand the best frequency of releases.

    PMM Telemetry is based on data collected by various PMM components and stored inside PMM server

    -!!! note alert alert-primary “” When PMM is installed, telemetry is not sent immediately. Before the first telemetry report is generated, PMM provides users with a 24-hour grace period to disable telemetry.

    To see the metrics being collected by telemetry, from the main menu navigate to Configuration → Settings → Advanced Settings → Telemetry and hover over the exclamation mark.

    !image

    We do not gather anything that can identify your system, but consider the following:

    1. The Country Code is evaluated from the submitting IP address before being discarded.

    2. We do create an “instance ID” - a random string generated using UUID v4. This instance ID is generated to distinguish new instances from existing ones, for figuring out instance upgrades.

    The first telemetry reporting of a new PMM Server instance is delayed by 24 hours to allow enough time to disable the service for those that do not wish to share any information.

    The landing page for this service, check.percona.com, explains what this service is.

    Grafana’s anonymous usage statistics is not managed by PMM. To activate it, you must change the PMM Server container configuration after each update.

    As well as via the PMM Settings page, you can also disable telemetry with the -e DISABLE_TELEMETRY=1 option in your docker run statement for the PMM Server.

    For information on the various config parameters for telemetry, see the config file.

    Check for updates¶

    When active, PMM will automatically check for updates and put a notification in the home page Updates dashboard if any are available.

    Advisors¶

    Advisors are sets of checks grouped by functionality that run a range of database health checks on a registered PMM instance.

    The findings are reported on the Advisors > Advisor Insights page, and an overview is displayed on the Home dashboard.

    The Advisors option is enabled by default. Checks are re-fetched and rerun at intervals.

    See Working with Advisor checks.

    Percona Alerting¶

    Enables Percona Alerting and reveals the Percona templated alerts option on the Alerting page.

    Backup Management¶

    Enables Backup Management option and reveals the Backup page from where you can:

    • Create and restore MongoDB and MySQL backups
    • Automate backup scheduling
    • Set retention policies
    • Monitor your backup and restore activity

    Public Address¶

    The address or hostname PMM Server will be accessible at. Click Get from browser to have your browser detect and populate this field automatically.

    Database as a Service (DBaaS)¶

    Caution

    DBaaS functionality is a technical preview that must be turned on with a server feature flag. See DBaaS.

    Enables/disables DBaaS features on this server.

    Important

    Deactivating DBaaS does not suspend or remove running DB clusters.

    Microsoft Azure monitoring¶

    Caution

    This is a technical preview feature.

    Activates Microsoft Azure monitoring.

    SSH Key¶

    This section lets you upload your public SSH key to access the PMM Server via SSH (for example, when accessing PMM Server as a virtual appliance).

    !

    Enter your public key in the SSH Key field and click Apply SSH Key.

    Alertmanager integration¶

    Alertmanager manages alerts, de-duplicating, grouping, and routing them to the appropriate receiver or display component.

    This section lets you configure how VictoriaMetrics integrates with an external Alertmanager.

    Tip

    If possible, use Integrated Alerting instead of Alertmanager.

    • The Alertmanager URL field should contain the URL of the Alertmanager which would serve your PMM alerts.
    • The Prometheus Alerting rules field is used to specify alerting rules in the YAML configuration format.

    Fill in both fields and click the Apply Alertmanager settings button to proceed.

    Percona Platform¶

    This is where you connect your PMM server to your Percona Platform Account.

    To learn how to connect your PMM servers to Percona Platform and leverage Platform services that boost the monitoring capabilities of your PMM installations, see Integrate PMM with Percona Platform.

    Your Percona Platform Account is separate from your PMM User account.

    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-27
    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.