PMM release 2.41.0 (#1157)

* PMM release 2.41.0 * PMM-12375 db ver details inventory services (#1162) * PMM-12375-db-ver-details-inventory-services * Update dashboard-inventory.md * Update dashboard-inventory.md * Update dashboard-inventory.md * Update dashboard-inventory.md * Update docs/details/dashboards/dashboard-inventory.md Co-authored-by: Alex Demidoff <alexander.demidoff@percona.com> * Update dashboard-inventory.md * Update dashboard-inventory.md * Update dashboard-inventory.md * Update advisors.md * Update advisors.md * Update docs/details/dashboards/dashboard-inventory.md Co-authored-by: Alex Demidoff <alexander.demidoff@percona.com> * Update dashboard-inventory.md * Update dashboard-inventory.md * Update dashboard-inventory.md * Update dashboard-inventory.md * Update dashboard-inventory.md --------- Co-authored-by: Alex Demidoff <alexander.demidoff@percona.com> Co-authored-by: Alina Derkach <alina.derkach@percona.com> * PMM Dump info * added link with instructions for SFTP credentials * PMM-12544 : DbaaS warning (#1165) * PMM-12544 * added warning notes * updated links * Feedback from Artem * PMM-12597 * feedback from Nurlan * PMM-11341-autodiscovery-postgres (#1174) * PMM-11341-autodiscovery-postgres * Update postgresql.md * add image for auto-discovery * automatic discovery via CLI * Update postgresql.md * Update postgresql.md * Update postgresql.md * Update postgresql.md * Update postgresql.md * Update postgresql.md * Update postgresql.md * Update postgresql.md * Updated the image * Added images * Update postgresql.md * updated the image * Update postgresql.md * Update postgresql.md * Update postgresql.md * Update docs/setting-up/client/postgresql.md Co-authored-by: Jiří Čtvrtka <62988319+JiriCtvrtka@users.noreply.github.com> * Update postgresql.md * Update postgresql.md * Update postgresql.md --------- Co-authored-by: Jiří Čtvrtka <62988319+JiriCtvrtka@users.noreply.github.com> * PMM-12422-exporters-bind-push-mode (#1168) * PMM-12422-exporters-bind-push-mode * Update pmm-admin.md * Update pmm-agent.md * Update pmm-agent.md * Update pmm-admin.md * Update pmm-agent.md * Update pmm-admin.md * Update docs/details/commands/pmm-agent.md Co-authored-by: Michael Okoko <10512379+idoqo@users.noreply.github.com> * Update docs/details/commands/pmm-admin.md Co-authored-by: Nurlan Moldomurov <nurlan.moldomurov@percona.com> * Update pmm-admin.md * Update pmm-agent.md * changed the falg name as per feedback * Update pmm-agent.md * Update docs/details/commands/pmm-admin.md Co-authored-by: Michael Okoko <10512379+idoqo@users.noreply.github.com> --------- Co-authored-by: Michael Okoko <10512379+idoqo@users.noreply.github.com> Co-authored-by: Nurlan Moldomurov <nurlan.moldomurov@percona.com> * PMM-12476-cluster-view-search (#1176) * PMM-12476-cluster-view-search * Update dashboard-inventory.md * Update dashboard-inventory.md * mentioned the standalone dump utility * RN_2.41.0 trigger the build * Fix the emoji extension * Revert - fix the emoji extension * Release_Notes_2.41.0_base_change (#1179) * PMM-12078 HA in PMM (#1172) * Pmm 12078 HA in PMM * importance of HA * Update HA.md * Procedure to set up PMM in HA mode * Update HA.md * Update mkdocs-base.yml * added HA.md in correct folder * Update HA.md * added step 1 * created step 2 * added step 3 * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update mkdocs-base.yml * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update HA.md * Update docs/get-started/HA.md Co-authored-by: Nurlan Moldomurov <nurlan.moldomurov@percona.com> * added disclaimer for Technical preview * Update HA.md * added a note * Update docs/get-started/HA.md Co-authored-by: Nurlan Moldomurov <nurlan.moldomurov@percona.com> * Update docs/get-started/HA.md Co-authored-by: Nurlan Moldomurov <nurlan.moldomurov@percona.com> * Moved this section into a different folder as per feedback * implemented feedback from nailya * Update HA.md * Update docs/details/HA.md Co-authored-by: Nurlan Moldomurov <nurlan.moldomurov@percona.com> * Update docs/details/HA.md Co-authored-by: Nurlan Moldomurov <nurlan.moldomurov@percona.com> * Update docs/details/HA.md Co-authored-by: Nurlan Moldomurov <nurlan.moldomurov@percona.com> * Update docs/details/HA.md Co-authored-by: Nurlan Moldomurov <nurlan.moldomurov@percona.com> * Update HA.md * implement feedback * Implemented feedback * Update mkdocs-base.yml * Moved HA topic to how-to * Update index.md * Update HA.md * Implemented feedback * Implemented the feedback from Santo --------- Co-authored-by: Nurlan Moldomurov <nurlan.moldomurov@percona.com> * Added RN to this branch * fixed notes * fix note * Implement the feedback from Santo * Update 2.41.0.md * Update 2.41.0.md * Update 2.41.0.md * Update 2.41.0.md * Update 2.41.0.md * Update mkdocs-base.yml * Update query-analytics.md * revert_changes_from-2.41.0 (#1182) * revert_changes_from-2.41.0 * Update 2.41.0.md * formatting * revert changes for PMM-8655 * removed quickstart file --------- Co-authored-by: Catalina A <catalina.adam@percona.com> * Update mkdocs-base.yml * Update variables.yml * Update mkdocs-base.yml * Update 2.41.0.md --------- Co-authored-by: Alex Demidoff <alexander.demidoff@percona.com> Co-authored-by: Alina Derkach <alina.derkach@percona.com> Co-authored-by: Catalina A <catalina.adam@percona.com> Co-authored-by: Catalina A <94133018+catalinaadam@users.noreply.github.com> Co-authored-by: Jiří Čtvrtka <62988319+JiriCtvrtka@users.noreply.github.com> Co-authored-by: Michael Okoko <10512379+idoqo@users.noreply.github.com> Co-authored-by: Nurlan Moldomurov <nurlan.moldomurov@percona.com>
percona · Dec 12, 2023 · d00a88b · d00a88b
1 parent 7087877
commit d00a88b
Show file tree

Hide file tree

Showing 28 changed files with 907 additions and 37 deletions.
diff --git a/docs/_images/PMM_Add_Instance_PostgreSQL.png b/docs/_images/PMM_Add_Instance_PostgreSQL.png
diff --git a/docs/_images/PMM_Add_Instance_PostgreSQL_TLS.png b/docs/_images/PMM_Add_Instance_PostgreSQL_TLS.png
diff --git a/docs/_images/PMM_Add_Instance_PostgreSQL_autodiscovery_custom.png b/docs/_images/PMM_Add_Instance_PostgreSQL_autodiscovery_custom.png
diff --git a/docs/_images/PMM_Add_Instance_PostgreSQL_autodiscovery_disabled.png b/docs/_images/PMM_Add_Instance_PostgreSQL_autodiscovery_disabled.png
diff --git a/docs/_images/PMM_Add_Instance_PostgreSQL_autodiscovery_enabled.png b/docs/_images/PMM_Add_Instance_PostgreSQL_autodiscovery_enabled.png
diff --git a/docs/_images/PMM_Inventory_Service_Selection.png b/docs/_images/PMM_Inventory_Service_Selection.png
diff --git a/docs/_images/PMM_Inventory_cluster_view_filter.png b/docs/_images/PMM_Inventory_cluster_view_filter.png
diff --git a/docs/dbaas/DBaaS_template.md b/docs/dbaas/DBaaS_template.md
@@ -1,5 +1,8 @@
 # Database cluster Templates
 
+!!! caution alert alert-primary "Do not use for mission-critical workloads"
+    DBaaS feature is deprecated. We encourage you to use [Percona Everest](http://per.co.na/pmm-to-everest) instead. Check our [Migration guide](http://per.co.na/pmm-to-everest-guide).
+
 Database clusters can be created from templates using PMM. Database cluster Template allows operators to customize Database Clusters based on their requirements, environments, or infrastructure.
 
 Examples

diff --git a/docs/dbaas/architecture.md b/docs/dbaas/architecture.md
@@ -1,14 +1,12 @@
 # DBaaS architecture
 
-!!! caution alert alert-warning "Caution"
-    DBaaS functionality is currently in [technical preview](../details/glossary.md#technical-preview) and is subject to change.
+!!! caution alert alert-primary "Do not use for mission-critical workloads"
+    DBaaS feature is deprecated. We encourage you to use [Percona Everest](http://per.co.na/pmm-to-everest) instead. Check our [Migration guide](http://per.co.na/pmm-to-everest-guide).
 
-
-DBaaS is built on top of PMM and Kubernetes and the high-level architecture is shown below
+DBaaS is built on top of PMM and Kubernetes and the high-level architecture is shown below:
 
 ![!](../_images/dbaas_arch.jpg)
 
-
 In DBaaS, the role of PMM is as follows:
 
 1. Expose Public REST API

diff --git a/docs/dbaas/backup_restore.md b/docs/dbaas/backup_restore.md
@@ -1,7 +1,7 @@
 # DBaaS backup and restore
 
-!!! caution alert alert-warning "Caution"
-    DBaaS functionality is currently in [technical preview](../details/glossary.md#technical-preview) and is subject to change.
+!!! caution alert alert-primary "Do not use for mission-critical workloads"
+    DBaaS feature is deprecated. We encourage you to use [Percona Everest](http://per.co.na/pmm-to-everest) instead. Check our [Migration guide](http://per.co.na/pmm-to-everest-guide).
 
 You can add a backup schedule while creating DB clusters in DBaaS. This feature is a fusion of backup management and DBaaS in PMM. Currently, DBaaS only supports scheduled backups, which can only be enabled when a database cluster is created.
 

diff --git a/docs/dbaas/databases.md b/docs/dbaas/databases.md
@@ -1,7 +1,7 @@
 ## DB clusters
 
-!!! caution alert alert-warning "Caution"
-    DBaaS functionality is currently in [technical preview](../details/glossary.md#technical-preview) and is subject to change.
+!!! caution alert alert-primary "Do not use for mission-critical workloads"
+    DBaaS feature is deprecated. We encourage you to use [Percona Everest](http://per.co.na/pmm-to-everest) instead. Check our [Migration guide](http://per.co.na/pmm-to-everest-guide).
 
 ### Add a DB Cluster
 

diff --git a/docs/dbaas/get-started.md b/docs/dbaas/get-started.md
@@ -1,7 +1,7 @@
 # Getting started with DBaaS
 
-!!! caution alert alert-warning "Caution"
-    DBaaS functionality is currently in [technical preview](../details/glossary.md#technical-preview) and is subject to change. Only AWS EKS, Minikube and CIVO clusters are supported.
+!!! caution alert alert-primary "Do not use for mission-critical workloads"
+    DBaaS feature is deprecated. We encourage you to use [Percona Everest](http://per.co.na/pmm-to-everest) instead. Check our [Migration guide](http://per.co.na/pmm-to-everest-guide).
 
 The DBaaS dashboard is where you add, remove, and operate on Kubernetes and database clusters.
 

diff --git a/docs/dbaas/index.md b/docs/dbaas/index.md
@@ -1,14 +1,13 @@
 # Introduction to Database as a service (DBaaS)
 
+!!! caution alert alert-primary "Do not use for mission-critical workloads"
+    - DBaaS feature is deprecated. We encourage you to use [Percona Everest](http://per.co.na/pmm-to-everest) instead. Check our [Migration guide](http://per.co.na/pmm-to-everest-guide).
+    - DBaaS feature is available for PMM Admin users.
+
 Database as a service (DBaaS) feature of Percona Monitoring and Management (PMM) is an open source solution to run MySQL and MongoDB clusters on Kubernetes.
 
 It allows you to utilize the benefits of Kubernetes and Percona's operators to run and manage database clusters.
 
-!!! caution alert alert-primary "Do not use for mission critical workloads"
-    DBaaS feature is available for PMM Admin users
-    DBaaS functionality is currently in [technical preview](../details/glossary.md#technical-preview) and is subject to change.
-
-
 ## Start here
 
 - [Architecture and how DBaaS works](architecture.html)

diff --git a/docs/dbaas/setting-up.md b/docs/dbaas/setting-up.md
@@ -1,7 +1,7 @@
 # Setting up DBaaS
 
-!!! caution alert alert-warning "Caution"
-    DBaaS functionality is currently in [technical preview](../details/glossary.md#technical-preview) and is subject to change.
+!!! caution alert alert-primary "Do not use for mission-critical workloads"
+    DBaaS feature is deprecated. We encourage you to use [Percona Everest](http://per.co.na/pmm-to-everest) instead. Check our [Migration guide](http://per.co.na/pmm-to-everest-guide).
 
 
 To use the Database as a Service (DBaaS) solution in PMM there are a few things that need to be setup first including a suitable Kubernetes Cluster.  If you've already got a kubernetes cluster you can jump ahead and [enable DBaaS in PMM](../dbaas/get-started.html).

diff --git a/docs/dbaas/troubleshoot-kubernetes.md b/docs/dbaas/troubleshoot-kubernetes.md
@@ -1,5 +1,9 @@
 ## Troubleshooting Kubernetes provisioning
 
+!!! caution alert alert-primary "Do not use for mission-critical workloads"
+    DBaaS feature is deprecated. We encourage you to use [Percona Everest](http://per.co.na/pmm-to-everest) instead. Check our [Migration guide](http://per.co.na/pmm-to-everest-guide).
+
+
 There are two things that might go wrong during the provisioning:
 
 1. OLM installation

diff --git a/docs/details/commands/pmm-admin.md b/docs/details/commands/pmm-admin.md
@@ -77,6 +77,9 @@ PMM communicates with the PMM Server via a PMM agent process.
 `--group=<group-name>`
 : Group name for external services. Default: `external`
 
+`--expose-exporter` (This flag is availble starting with PMM 2.41.0.)
+: If you enable this flag, any IP address on the local network and anywhere on the internet can access exporter endpoints. If the flag is disabled/not present, exporter endpoints can be accessed only locally. The flag is disabled by default
+
 ## COMMANDS
 
 ### GENERAL COMMANDS

diff --git a/docs/details/commands/pmm-agent.md b/docs/details/commands/pmm-agent.md
@@ -64,6 +64,8 @@ Most options can be set via environment variables (shown in parentheses).
 | `--trace`                              | `PMM_AGENT_TRACE`                   | Enable trace output (implies `--debug`).
 | `-h`, `--help`                         |                                     | Show help (synonym for `pmm-agent help`).
 | `--version`                            |                                     | Show application version, PMM version, time-stamp, git commit hash and branch.
+| `--expose-exporter` (This flag is available starting with PMM 2.41.0.)| | If you enable this flag, any IP address on the local network and anywhere on the internet can access node exporter endpoints. If the flag is disabled, node exporter endpoints can be accessed only locally.
+
 
 ## USAGE AND EXAMPLES OF `paths-base` FLAG
 

diff --git a/docs/details/dashboards/dashboard-inventory.md b/docs/details/dashboards/dashboard-inventory.md
@@ -13,25 +13,39 @@ Inventory objects form a hierarchy with Node at the top, then Service and Agents
 The **Services** tab displays the individual services, the nodes on which they run, and the Agents that help collect the service metrics along with the following information:
 
 
-**Service name** - The name or identifier associated with the service being monitored.
+| **Column Name**| **Description**|
+|--------------|--------------------------------|
+| Service name|The name or identifier associated with the service being monitored.|                                        
+| Node name | Name or identifier associated with a specific node.| 
+| Monitoring status| The **Monitoring** column summarizes the status of all the Agents assigned to the service.             | 
+|  Address         | The IP address or DNS where the service is currently running. |
+|  Port         | The port number on which the service is running. ||
+|  Options |* You can check **QAN** information and the **Dashboard** for each service by clicking on the **<image src="../../_images/dots-three-vertical.ico" width="15px" aria-label="triple dots"/>** icon </br> </br> * You can also check additional information about the service, by clicking on the **<image src="../../_images/arrow-downward.ico" width="15px" aria-label="downward arrow"/>** icon. This expands the service entry to show reference information like service labels and IDs.|
 
-**Node Name** - Name or identifier associated with a specific node. 
 
-**Monitoring status** - The **Monitoring** column summarizes the status of all the Agents assigned to the service.
+![!image](../../_images/PMM_Inventory_Service_Selection.png)
 
-**Address** - The IP address or DNS where the service is currently running.
+#### Attributes
 
-**Port** - The port number on which the service is running.
+These are some of the atributes for a service:
 
-You can check Query Analytics information and the Service Overview Dashboard for each service by clicking on the <image src="../../_images/dots-three-vertical.ico" width="15px" aria-label="triple dots"/> icon in the **Options** column.
+- Each instance of a service gets a `service_type` attribute so one can clearly tell what type of database it is, for instance: `mysql`, `postgresql`, `mongodb`, etc. 
 
-From here you can also check additional information about the service, by clicking on the <image src="../../_images/arrow-downward.ico" width="15px" aria-label="downward arrow"/> icon. This expands the service entry to show reference information like service labels and IDs.
+- Every service is related to a certain node via its `node_id` attribute. This feature allows to support monitoring of multiple instances on a single node, with different service names, e.g. `mysql1-3306`, and `mysql1-3307`.
 
-![!image](../../_images/PMM_Inventory_Service_Selection.png)
+- Starting with PMM 2.41.0, each instance of a service gets a `version` attribute to the response of the endpoint that provides a list of services being monitored by PMM. This makes it easy to visualize the database server version.
+
+    However, following are the imitations:
+
+    - The version is not captured for the internal PostgreSQL database.
+    - The version is only captured when a new service is being added to PMM and the agent installed on the client side is equal to or greater than v2.41.0.
+    - When a database is upgraded, you will not see the database version updated automatically. It will be updated if you remove and then re-add the service.
 
-Each instance of a service gets a `service_type` attribute so one can clearly tell what type of database it is, for instance: `mysql`, `postgresql`, `mongodb`, etc. Every service is related to a certain node via its `node_id` attribute. This feature allows to support multiple instances on a single node, with different service names, e.g. `mysql1-3306`, and `mysql1-3307`.
+#### Agents
 
-Each binary (exporter, agent) running on a client will get an `agent_type` value. Examples:
+Each binary (exporter, agent) running on a client will get an `agent_type` value. 
+
+Example
 
 - `pmm-agent` is at the top of the tree, assigned to PMM Agent itself
 - `node_exporter` is assigned to an agent that extracts the node metrics
@@ -41,6 +55,7 @@ To view the agents running on a service and their health status, click **OK** or
 
 ![!image](../../_images/PMM_Inventory_Service_Agent_Properties.png)
 
+
 #### Node-service relationship
 
 Starting with PMM 2.40.0, you can click on the link in the **Node Name** column to view the node on which a specific service is running and analyze how node-level resource utilization impacts the performance of those services.
@@ -103,6 +118,9 @@ Click the downward arrow to view cluster details, including the services running
 
 ![!image](../../_images/PMM_Inventory_cluster_view_details.png)
 
+Furthermore, you can filter the clusters by criteria such as Cluster name, Status, Service name, Node name, Monitoring, Address, and Port. 
+
+![!image](../../_images/PMM_Inventory_cluster_view_filter.png)
 
 ### Nodes tab
 

diff --git a/docs/get-started/query-analytics.md b/docs/get-started/query-analytics.md
@@ -18,7 +18,7 @@ The dashboard contains three panels:
 - the [Details Panel](#details-panel).
 
 !!! note alert alert-primary ""
-    Query Analytics data retrieval is not instantaneous and can be delayed due to network conditions. In such situations *no data* is reported and a gap appears in the sparkline.
+    Query Analytics data retrieval may experience delays due to network conditions. As a result, a small amount of data (up to 1 hour) will be buffered in the memory and reported when the connection is restored.
 
 ## Filters Panel