2.27.0 (#725)

* Pmm 9452 change admin user password3 (#705) * PMM-9452 test push * PMM-9452 change the password for admin user * Update docs/faq.md Co-authored-by: Nikita Beletskii <[email protected]> * Update docs/faq.md Co-authored-by: Nikita Beletskii <[email protected]> Co-authored-by: Puneet Kala <[email protected]> Co-authored-by: Nikita Beletskii <[email protected]> * Reworded IA topic and Added info about Silencing All alerts (#715) * Reworded IA topic and Added info about Silencing All alerts * Update alerting.md * Update alerting.md * Update docs/using/alerting.md Co-authored-by: rasika-chivate <[email protected]> * Update docs/using/alerting.md Co-authored-by: fabio-silva <[email protected]> * Update docs/using/alerting.md Co-authored-by: fabio-silva <[email protected]> * Update docs/using/alerting.md Co-authored-by: rasika-chivate <[email protected]> * Update docs/using/alerting.md Co-authored-by: rasika-chivate <[email protected]> * Update docs/using/alerting.md Co-authored-by: fabio-silva <[email protected]> * Update alerting.md * Update docs/using/alerting.md Co-authored-by: rasika-chivate <[email protected]> * Update alerting.md * Update alerting.md * Update docs/using/alerting.md Co-authored-by: fabio-silva <[email protected]> * Update docs/using/alerting.md Co-authored-by: fabio-silva <[email protected]> * Update docs/using/alerting.md Co-authored-by: fabio-silva <[email protected]> * Update alerting.md * Update docs/using/alerting.md Co-authored-by: fabio-silva <[email protected]> Co-authored-by: rasika-chivate <[email protected]> Co-authored-by: fabio-silva <[email protected]> * PMM-9542 change default password (#713) * PMM-9542 change default password * Update faq.md * PMM-5831 non default listen port (#712) * PMM-5831 non-default port * Update faq.md * Update faq.md * Update faq.md * Update pmm-admin.md * Update pmm-admin.md * Update faq.md * PMM-8434 new variable for pmm public address (#730) * PMM-8434 new variable for pmm public address * Update docker.md * Update docker.md * Update docker.md * PMM-9713 change victoriametrics parameters (#735) * PMM-9713 change victoriametrics parameters * Update victoria-metrics.md * Update docs/details/victoria-metrics.md Co-authored-by: Carlos Salguero <[email protected]> * Update victoria-metrics.md Co-authored-by: Carlos Salguero <[email protected]> * Version changes and config changes for PMM 2.27.0 (#761) * PMM-9690 Release Notes (#726) * PMM-9690 Release Notes * Update 2.27.0.md * Update 2.27.0.md * Update 2.27.0.md * Update index.md * Update 2.27.0.md * Update 2.27.0.md * Update 2.27.0.md * Update 2.27.0.md * Update 2.27.0.md * Update docs/release-notes/2.27.0.md Co-authored-by: Denys Kondratenko <[email protected]> * Update 2.27.0.md * Update 2.27.0.md * Update 2.27.0.md Implemented feedback from Roma * Update 2.27.0.md * Update docs/release-notes/2.27.0.md Co-authored-by: Roma Novikov <[email protected]> * Update 2.27.0.md * Update docs/release-notes/2.27.0.md Co-authored-by: Roma Novikov <[email protected]> * Update docs/release-notes/2.27.0.md Co-authored-by: Roma Novikov <[email protected]> * Update docs/release-notes/2.27.0.md Co-authored-by: Roma Novikov <[email protected]> * Update docs/release-notes/2.27.0.md Co-authored-by: Roma Novikov <[email protected]> * Update docs/release-notes/2.27.0.md Co-authored-by: Roma Novikov <[email protected]> * Update docs/release-notes/2.27.0.md Co-authored-by: Roma Novikov <[email protected]> * updated the RN * Update 2.27.0.md Added feature prefixes for Server Management items * Update 2.27.0.md * Update 2.27.0.md * Update 2.27.0.md * Update 2.27.0.md * Update 2.27.0.md * Update 2.27.0.md * Update 2.27.0.md * implemented feedback * implemented feedback * Update 2.27.0.md * fixed links and updated indentation * Update docs/release-notes/2.27.0.md Co-authored-by: Denys Kondratenko <[email protected]> * Update docs/release-notes/2.27.0.md Co-authored-by: Denys Kondratenko <[email protected]> * Update docs/release-notes/2.27.0.md Co-authored-by: Denys Kondratenko <[email protected]> * fixed indentation * indentation * test indentation output * test output format * test output format * test output * test output * fix output * indentation * indentation * bolded lists * implemented Roma's feedback * fixed whitespace * Update 2.27.0.md * Update 2.27.0.md * Update 2.27.0.md * Update 2.27.0.md * Update 2.27.0.md Co-authored-by: Denys Kondratenko <[email protected]> Co-authored-by: Catalina Adam <[email protected]> Co-authored-by: Roma Novikov <[email protected]> Co-authored-by: catalina-adam <[email protected]> * Update mkdocs-base.yml Co-authored-by: Denys Kondratenko <[email protected]> * Update 2.27.0.md fixed incorrect .md links * Update mkdocs-base.yml Co-authored-by: Puneet Kala <[email protected]> Co-authored-by: Nikita Beletskii <[email protected]> Co-authored-by: Catalina Adam <[email protected]> Co-authored-by: fabio-silva <[email protected]> Co-authored-by: Carlos Salguero <[email protected]> Co-authored-by: Alex Tymchuk <[email protected]> Co-authored-by: Denys Kondratenko <[email protected]> Co-authored-by: Roma Novikov <[email protected]> Co-authored-by: catalina-adam <[email protected]>
percona · Apr 14, 2022 · 3e7af99 · 3e7af99
1 parent 83f713b
commit 3e7af99
Show file tree

Hide file tree

Showing 7 changed files with 192 additions and 5 deletions.
diff --git a/docs/details/victoria-metrics.md b/docs/details/victoria-metrics.md
@@ -33,6 +33,27 @@ As a result of the move to VictoriaMetrics some direct Prometheus paths are no l
 | `/prometheus/status`            | Some information at `/prometheus/metrics`. High cardinality metrics information at `/prometheus/api/v1/status/tsdb`.
 | `/prometheus/targets`           | `/victoriametrics/targets`
 
+
+
+## Environment variables
+
+
+PMM predefines certain flags that allow users to set all other [VictoriaMetrics parameters](https://docs.victoriametrics.com/#list-of-command-line-flags) as environment variables:
+
+The environment variable must be prepended with `VM_`.
+
+**Example**
+
+To set downsampling, use the `downsampling.period` parameter as follows:
+
+```
+-e VM_downsampling_period=20d:10m,120d:2h
+```
+
+This instructs VictoriaMetrics to [deduplicate](https://docs.victoriametrics.com/#deduplication) samples older than 20 days with 10 mins intervals and samples older than 120 days with two-hour intervals.
+
+
+
 ## Troubleshooting
 
 To troubleshoot issues, see the VictoriaMetrics [troubleshooting documentation](https://victoriametrics.github.io/#troubleshooting).

diff --git a/docs/release-notes/2.27.0.md b/docs/release-notes/2.27.0.md
@@ -0,0 +1,161 @@
+# Percona Monitoring and Management 2.27.0
+
+<table class="docutils field-list" frame="void" rules="none">
+  <colgroup>
+    <col class="field-name">
+    <col class="field-body">
+  </colgroup>
+  <tbody valign="top">
+    <tr class="field-odd field">
+    <th class="field-name">Date:</th>
+    <td class="field-body">April 14, 2022</td>
+    </tr>
+    <tr class="field-even field">
+      <th class="field-name">Installation:</th>
+      <td class="field-body">
+        <a class="reference external" href="https://www.percona.com/software/pmm/quickstart">Installing Percona Monitoring and Management</a></td>
+    </tr>
+  </tbody>
+</table>
+
+Percona Monitoring and Management (PMM) is a free and open-source platform for managing and monitoring MySQL, MongoDB, and PostgreSQL performance.
+
+!!! caution alert alert-warning "Important"
+    We recommend using the latest version of the PMM instance. This ensures that you access the latest features of the underlying components, such as VictoriaMetrics, with all the bug fixes in place. One of the critical features of VictoriaMetrics is [stream parsing mode](https://docs.victoriametrics.com/vmagent.html#stream-parsing-mode), which enhances the performance of PMM and saves memory when scraping targets expose millions of metrics.
+
+## Release Highlights
+
+### PMM and Percona Portal Integration
+
+- **Enhanced UX for connecting PMM server to Percona Portal**
+
+    To leverage Percona Platform's recent support for federated identity, PMM now uses access-token authorization for connecting PMM instances to Percona Platform. 
+
+    This replaces the former username/password authentication used in PMM 2.26.0 and older versions.
+
+    For more information, see [Integrate PMM with Percona Platform](https://www.percona.com/doc/percona-monitoring-and-management/2.x/how-to/integrate-platform.html). 
+
+-  **Access to account information for Percona customers**
+
+      When you connect your PMM instances to Percona Platform as a Percona customer, you can now check all your Percona Platform account information on the new **Entitlements** and **Support Tickets** tab on the main menu.      
+
+    For more information, see [Check your account information](https://www.percona.com/doc/percona-monitoring-and-management/2.x/how-to/account-info.html) in the online Help.
+
+### Advisors
+
+- **Broader database health assessments with Advisors**
+
+    With this release, we are renaming Security Checks to Advisors and grouping them according to the functionality and recommendations they provide. To reflect these changes, the old **Security Threat Tool** option is now called **Advisors**.
+
+    In addition, we have added new checks for MySQL and MongoDB.
+     To check the list of checks and the tier for which they are available, see [Advisor checks for PMM](https://docs.percona.com/percona-platform/checks.html) in the Percona Platform online Help.
+
+- **New Paid tier and special Advisor checks for customers**
+
+    In addition to Registered Checks, Percona customers who connect PMM to Pecona Platform now also have access to Paid Advisor checks, which offer more advanced database health information.
+
+    For more information, see [Working with Advisor checks](https://www.percona.com/doc/percona-monitoring-and-management/2.x/details/how-to/advisors.html).
+
+- Advisor checks have been extended with two new query types: *GetDiagnosticData* and *replSetGetStatus*.
+
+- Improved the documentation around [developing checks](https://www.percona.com/doc/percona-monitoring-and-management/2.x/details/checks/index.html).
+
+
+### DBaaS
+
+Simplified experience in registering EKS cluster with kubeconfig generated by eksctl.
+
+### Components upgrade
+  - **Grafana**: PMM 2.27.0 has now migrated to Grafana 8.3.5. This version of Grafana is loaded with a gamut of exciting features. For more information, see [What's new in Grafana v8.0](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v8-0/).
+  - **VictoriaMetrics**: VictoriaMetrics has been upgraded to 1.72.0.
+
+
+
+## New Features
+
+- [PMM-9718](https://jira.percona.com/browse/PMM-9718): PMM and Percona Portal Integration: Federated connections to Percona Platform.
+
+- [PMM-9305](https://jira.percona.com/browse/PMM-9305), [PMM-8661](https://jira.percona.com/browse/PMM-8661): PMM and Percona Portal Integration: Visibility over Percona Platform Entitlements and Support Tickets.
+
+- [PMM-9473](https://jira.percona.com/browse/PMM-9473): Advisors: Additional abilities for MongoDB Advisor Checks.
+
+- [PMM-8800](https://jira.percona.com/browse/PMM-8800): DBaaS: With PMM, you can now have a simplified experience in registering your EKS cluster with kubeconfig generated by eksctl. Copy-paste the configuration by selecting Using Amazon Elastic Kubernetes Service (EKS) checkbox, and your K8s cluster is registered. For more information, see [Documentation](https://www.percona.com/doc/percona-monitoring-and-management/2.x/using/dbaas.html#kubernetes-clusters).
+
+- [PMM-8434](https://jira.percona.com/browse/PMM-8434): Support for passing PMM Server Public Address as an environment variable while starting the PMM server. For more information, see [Documentation](https://www.percona.com/doc/percona-monitoring-and-management/2.x/setting-up/server/docker.html#environment-variables).
+
+## Improvements
+
+- [PMM-9319](https://jira.percona.com/browse/PMM-9319): PMM and Percona Portal Integration: Synchronized Platform and PMM roles: We have updated PMM permissions to ensure that Administrators of Percona Portal organizations are also granted Admin role in PMM. - 
+
+- [PMM-9339](https://jira.percona.com/browse/PMM-9339): Integrated Alerting: The Use TLS option in webhook settings has been renamed to Show TLS setting to better reflect its functionality.
+
+- [PMM-9182](https://jira.percona.com/browse/PMM-9182): Integrated Alerting: Added **Silence All** option for when you want to stop notifications from all alerting rules at once.
+
+- [PMM-9164](https://jira.percona.com/browse/PMM-9182): Integrated Alerting: You can now use an existing rule as a source for new ones instead of using a template.
+
+- [PMM-9635](https://jira.percona.com/browse/PMM-9635): Advisors: Extended security checks to Advisors to cover broader database health checks.
+
+- [PMM-9148](https://jira.percona.com/browse/PMM-9148): QAN: You can now share a link for Query Analytics at the click of a button with the *Copy Link*.
+
+- [PMM-8045](https://jira.percona.com/browse/PMM-8045): DBaaS: With this version of PMM, we have added a warning about the deletion of API keys so that the user is forewarned before deleting the API key.
+
+- [PMM-9452](https://jira.percona.com/browse/PMM-9452): With this release of PMM, we have implemented a simplified password change method for the default admin user using the command line parameter `change-admin-password`.
+
+- [PMM-9542](https://jira.percona.com/browse/PMM-9542): PMM now predefines certain flags that allow users to set all other [VictoriaMetrics parameters](https://docs.victoriametrics.com/#list-of-command-line-flags) as environment variables. For more information see [Documentation](https://www.percona.com/doc/percona-monitoring-and-management/2.x/details/victoria-metrics.html#environment-variables).
+
+- [PMM-8794](https://jira.percona.com/browse/PMM-8794): For consistency, we have implemented a unified 24 hours time format for backup management.
+
+- [PMM-9306](https://jira.percona.com/browse/PMM-9306): VictoriaMetrics has been upgraded to 1.72.0. 
+
+- [PMM-8412](https://jira.percona.com/browse/PMM-8412): Grafana has been upgraded to 8.x.
+
+- [PMM-9648](https://jira.percona.com/browse/PMM-9648): With PMM 2.27.0 migrating to Grafana 8.0, the Singlestat Panel has been deprecated and replaced with Stat Panel in Grafana for an enhanced user experience.
+
+
+## Bugs Fixed
+
+- [PMM-9797](https://jira.percona.com/browse/PMM-9797): Fixed an issue where the data on the Home Dashboard was represented incorrectly on the Stat Panel, which could potentially confuse the user.
+
+- [PMM-9783](https://jira.percona.com/browse/PMM-9783): Fixed an issue where QAN failed to work after an upgrade.
+
+- [PMM-9757](https://jira.percona.com/browse/PMM-9757): Fixed an issue where the metrics for MongoDB were not being exposed when the database connection was getting lost.
+
+- [PMM-9603](https://jira.percona.com/browse/PMM-9603): PMM and Percona Portal Integration: Fixed “Insufficient access rights” error that was displayed  for admin user after connecting  PMM server connect to Percona Portal.
+
+- [PMM-9323](https://jira.percona.com/browse/PMM-9323): PMM and Percona Portal Integration: Ensured PMM no longer downloads checks and templates from Percona Portal when the Telemetry option is disabled in the PMM Advanced Settings.
+
+- [PMM-8986](https://jira.percona.com/browse/PMM-8986): Advisors: Fixed an issue where the Advisors check on the PMM servers monitoring a large number of database services was causing a timeout. 
+
+- [PMM-9570](https://jira.percona.com/browse/PMM-9570): DBaaS: Create DB Cluster dialog box was closing automatically while trying to create  a database cluster and had to be opened twice. This issue has been fixed now.
+
+- [PMM-9496](https://jira.percona.com/browse/PMM-9496): DBaaS: Fixed an issue where the host and database were not being monitored in DBaas.
+
+- [PMM-9783](https://jira.percona.com/browse/PMM-9783): QAN: Fixed an issue where QAN failed to work after an upgrade.
+
+- [PMM-9661](https://jira.percona.com/browse/PMM-9661): QAN: Fixed an issue where QAN layout breaks while resizing the window.
+
+- [PMM-9797](https://jira.percona.com/browse/PMM-9797): Dashboard: Fixed an issue where the data on the Home Dashboard was represented incorrectly on the Stat Panel, which could potentially confuse the user.
+
+- [PMM-9757](https://jira.percona.com/browse/PMM-9757): Fixed an issue where the metrics for MongoDB were not being exposed when the database connection was getting lost.
+
+
+- [PMM-9671](https://jira.percona.com/browse/PMM-9671): Fixed an issue where an upgrade to 2.26.0 failed as PMM crashed.
+
+
+- [PMM-9413](https://jira.percona.com/browse/PMM-9413): Fixed an issue where the PMM management daemon was getting deadlocked when a PMM agent was getting connected with a duplicate `agent_id`.
+
+- [PMM-9015](https://jira.percona.com/browse/PMM-9015): Fixed an issue where PMM does not display when PostgreSQL is down, thus failing to capture the metrics for PostgreSQL.
+
+
+- [PMM-8203](https://jira.percona.com/browse/PMM-8203): Fixed an issue where the `pmm-agent.log` is cluttered with unnecessary errors when MariaDB database versions 10.2, 10.3, 10.4, and 10.5 are added for monitoring.
+
+- [PMM-5831](https://jira.percona.com/browse/PMM-5831): Fixed an issue where `pmm-admin` uses the default value of ‘listen port’ rather than picking up the value from the agent configuration file.
+
+
+- Fixed the following CVE’s:
+
+    - [PMM-9726](https://jira.percona.com/browse/PMM-9726): Fixed a critical CVE that was affecting some versions of Go.
+    - [PMM-9722](https://jira.percona.com/browse/PMM-9722): Fixed a CVE for ClickHouse DBMS.
+    - [PMM-9327](https://jira.percona.com/browse/PMM-9327): Fixed a vulnerability in the Network Security Services (NSS) package.
+    - [PMM-9502](https://jira.percona.com/browse/PMM-9502): Fixed multiple JavaScript Common Vulnerabilities and Exposures (CVE) for PMM AMI setup.
+
diff --git a/docs/release-notes/index.md b/docs/release-notes/index.md
@@ -1,5 +1,6 @@
 # Release Notes
 
+- [Percona Monitoring and Management 2.27.0](2.27.0.md)
 - [Percona Monitoring and Management 2.26.0](2.26.0.md)
 - [Percona Monitoring and Management 2.25.0](2.25.0.md)
 - [Percona Monitoring and Management 2.24.0](2.24.0.md)

diff --git a/docs/setting-up/server/docker.md b/docs/setting-up/server/docker.md
@@ -285,6 +285,8 @@ Use the following Docker container environment variables (with `-e var=value`) t
 | `ENABLE_DBAAS`             | Enable DBaaS features.
 | `PMM_DEBUG`                | Enables a more verbose log level.
 | `PMM_TRACE`                | Enables a more verbose log level including trace-back information.
+| `PMM_PUBLIC_ADDRESS`       | External IP address or the DNS name on which PMM server is running.
+
 
 ### Ignored variables
 

diff --git a/docs/using/alerting.md b/docs/using/alerting.md
@@ -21,6 +21,7 @@ Before creating alert rules:
 2. Set up an Email (SMTP) or Slack sender settings for receiving alerts.
 3. Specify the Email/Slack/Webhooks/PagerDuty settings and channels to notify.
 
+
 ### Enable Integrated Alerting
 
 1. Select **Configuration > Settings > Advanced Settings**.

diff --git a/mkdocs-base.yml b/mkdocs-base.yml
@@ -92,6 +92,7 @@ extra: # Used in main.html template and can't be externalized
 # Common navigation for percona.com, render.com and PDF
 nav:
 
+
     - Welcome: index.md
     - Setting up:
           - setting-up/index.md
@@ -221,7 +222,7 @@ nav:
     - faq.md
     - Release Notes:
           - release-notes/index.md
-
+          - "PMM 2.27.0": release-notes/2.27.0.md
           - "PMM 2.26.0": release-notes/2.26.0.md
           - "PMM 2.25.0": release-notes/2.25.0.md
           - "PMM 2.24.0": release-notes/2.24.0.md
@@ -256,4 +257,4 @@ nav:
           - "PMM 2.2.0": release-notes/2.2.0.md
           - "PMM 2.1.0": release-notes/2.1.0.md
           - "PMM 2.0.1": release-notes/2.0.1.md
-          - "PMM 2.0.0": release-notes/2.0.0.md
+          - "PMM 2.0.0": release-notes/2.0.0.md
diff --git a/variables.yml b/variables.yml
@@ -1,9 +1,9 @@
 # PMM Version for HTML
 # See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path
 
-release: '2.26.0'
-version: '2.26'
-release_date: 2022-02-08
+release: '2.27.0'
+version: '2.27'
+release_date: 2022-04-14
 
 # SVG icons. Use in markdown as {{icon.<name>}}
 # For the Percona image icon (encoded inline SVG), see https://css-tricks.com/using-svg/