From ecf789dbfcf5df1f278ef493a9f5111d2412de9a Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Thu, 9 May 2024 20:02:37 +0530 Subject: [PATCH 01/18] PEM - 9.6 Release branch Added new alert templates as per https://github.com/EnterpriseDB/pem/pull/389 https://github.com/EnterpriseDB/pem/pull/388 Started drafting release notes --- .../docs/pem/9/monitoring_performance/alerts.mdx | 4 ++++ .../docs/pem/9/pem_rel_notes/960_rel_notes.mdx | 13 +++++++++++++ 2 files changed, 17 insertions(+) create mode 100644 product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx diff --git a/product_docs/docs/pem/9/monitoring_performance/alerts.mdx b/product_docs/docs/pem/9/monitoring_performance/alerts.mdx index fe65de39ee0..9e48b30d486 100644 --- a/product_docs/docs/pem/9/monitoring_performance/alerts.mdx +++ b/product_docs/docs/pem/9/monitoring_performance/alerts.mdx @@ -323,7 +323,11 @@ The tables that follow list the system-defined alert templates that you can use | PGD Group Raft Consensus | PGD group raft consensus not working | bdr_monitor_group_raft | | PGD Group Raft Leader ID not matching | PGD group raft leader id not matching | bdr_group_raft_details | | PGD Group versions check | PGD/pglogical version mismatched in PGD group | bdr_monitor_group_raft | +| PGD worker error detected | PGD worker error detected reported for PGD node | | | | Transaction ID exhaustion (wraparound) | Check for Transaction ID exhaustion (wraparound) | | +| Inactive replication slots | Check for slots which are inactive for a particular server | | | +| Conflicting replication slots | Check for slots which are conflicting for a particular server | | | +| Multixact ID exhaustion (wraparound) | Check for Multixact ID exhaustion (wraparound) | | | ### Templates applicable on database diff --git a/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx b/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx new file mode 100644 index 00000000000..efd067cce61 --- /dev/null +++ b/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx @@ -0,0 +1,13 @@ +--- +title: "Postgres Enterprise Manager 9.6.0 release notes" +navTitle: Version 9.6.0 +--- + +Released: 15 May 2024 + +New features, enhancements, bug fixes, and other changes in PEM 9.6.0 include: + +| Type | Description | +| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | +| Enhancement | Added an option to enable the probes using pemworker utility. | +| Enhancement | \ No newline at end of file From ceaec1ab01fda893f1f994c591f9ee688850ff6a Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Tue, 14 May 2024 16:45:52 +0530 Subject: [PATCH 02/18] Added release notes --- .../docs/pem/9/pem_rel_notes/960_rel_notes.mdx | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx b/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx index efd067cce61..834ba72c300 100644 --- a/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx +++ b/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx @@ -7,7 +7,14 @@ Released: 15 May 2024 New features, enhancements, bug fixes, and other changes in PEM 9.6.0 include: -| Type | Description | -| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | -| Enhancement | Added an option to enable the probes using pemworker utility. | -| Enhancement | \ No newline at end of file +| Type | Description | +|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Enhancement | Added an option to enable the probes using the pemworker utility. | +| Enhancement | Fixed an issue to include the error message in the email of the PEM agent job output. The default character limit for error output is 1000, which can be configured now using `job_notification_error_limit` parameter in the server configuration. | +| Enhancement | Added two alert templates — `Inactive replication slots` and `Conflicting replication slots` and added a probe — `Replication slots`. | +| Bug fix | Fixed an issue where audit manager was setting `edb_audit_statement` parameter to '' instead on 'none' when log statement parameter was left empty in the GUI resulting in failure of server restart. | +| Bug fix | Updated the default parameter for configuring PEM to use the `Fully Qualified Domain Name (FQDN)` hostname while agent registration. | +| Bug fix | Fixed an issue with error `NoneType` has no `len()` when alerts were listed on the alert dashboard. | +| Bug fix | Fixed an issue for team role feature for the PEM agents. | +| Bug fix | Fixed an issue with SQL query for the PEM agent registration. Added the public schema name in the table prefix to execute the SQL query successfully even if schema name is not in the search path. | +| Big fix | Updated the alert template `Table size in server/database/schema` with more detailed SQL query. | \ No newline at end of file From 132c7e00181195d7160ea662018c9716713698ad Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Tue, 14 May 2024 17:56:34 +0530 Subject: [PATCH 03/18] Added two probes as per [DOCS-499](https://enterprisedb.atlassian.net/issues/DOCS-499) --- product_docs/docs/pem/9/monitoring_performance/probes.mdx | 3 +++ product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx | 2 +- 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/product_docs/docs/pem/9/monitoring_performance/probes.mdx b/product_docs/docs/pem/9/monitoring_performance/probes.mdx index 3ca86ddfc55..191bf888df5 100644 --- a/product_docs/docs/pem/9/monitoring_performance/probes.mdx +++ b/product_docs/docs/pem/9/monitoring_performance/probes.mdx @@ -73,6 +73,9 @@ Unless otherwise noted, Postgres Enterprise Manager enables the following probes | User Information | A list of the current users. The stored information includes:
The user name
The user type (superuser or non-superuser)
The server to which the user is connected | Server | | WAL Archive Status | Status of the WAL archive. The stored information includes:
The number of WAL archives done
The number of WAL archives pending
The last archive time
The number of WAL archives failed
The time of the last failure | Server | | xDB Replication | Lag data for clusters replicated using xDB replication. | Database | +| Multixact ID Exhaustion (Wraparound) | Information about the maximum transaction ID. The stored information includes:
The name of the database
The oldest current maximum XID. | Server | +| Replication Slots | Information about the replication slots. The stored information includes:
A unique, cluster-wide identifier for the replication slot
The base name of the shared object containing the output plugin this logical slot is using, or null for physical slots
The slot type - physical or logical
The OID of the database this slot is associated with, or null. Only logical slots have an associated database
The name of the database this slot is associated with, or null. Only logical slots have an associated database
Active field is True if this slot is currently actively being used
The oldest transaction that this slot needs the database to retain. VACUUM cannot remove tuples deleted by any later transaction
The oldest transaction affecting the system catalogs that this slot needs the database to retain. VACUUM cannot remove catalog tuples deleted by any later transaction
The address (LSN) of oldest WAL which still might be required by the consumer of this slot and thus won't be automatically removed during checkpoints | Server | + diff --git a/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx b/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx index 834ba72c300..ff5a94d256d 100644 --- a/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx +++ b/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx @@ -11,7 +11,7 @@ New features, enhancements, bug fixes, and other changes in PEM 9.6.0 include: |--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Enhancement | Added an option to enable the probes using the pemworker utility. | | Enhancement | Fixed an issue to include the error message in the email of the PEM agent job output. The default character limit for error output is 1000, which can be configured now using `job_notification_error_limit` parameter in the server configuration. | -| Enhancement | Added two alert templates — `Inactive replication slots` and `Conflicting replication slots` and added a probe — `Replication slots`. | +| Enhancement | Added two alert templates — `Inactive replication slots` and `Conflicting replication slots` and added two probes — `Replication slots` and `Multixact ID Exhaustion (Wraparound)`. | | Bug fix | Fixed an issue where audit manager was setting `edb_audit_statement` parameter to '' instead on 'none' when log statement parameter was left empty in the GUI resulting in failure of server restart. | | Bug fix | Updated the default parameter for configuring PEM to use the `Fully Qualified Domain Name (FQDN)` hostname while agent registration. | | Bug fix | Fixed an issue with error `NoneType` has no `len()` when alerts were listed on the alert dashboard. | From 668653e995ee75ba616804cc56419d59b0cb6d8e Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Tue, 14 May 2024 18:29:50 +0530 Subject: [PATCH 04/18] Added capacity manager JSON report as per [DOCS-500](https://enterprisedb.atlassian.net/issues/DOCS-500) --- .../docs/pem/9/monitoring_performance/capacity_manager.mdx | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/product_docs/docs/pem/9/monitoring_performance/capacity_manager.mdx b/product_docs/docs/pem/9/monitoring_performance/capacity_manager.mdx index b9cf5b8f09b..7ea593bcd89 100644 --- a/product_docs/docs/pem/9/monitoring_performance/capacity_manager.mdx +++ b/product_docs/docs/pem/9/monitoring_performance/capacity_manager.mdx @@ -71,10 +71,11 @@ Use the **Report destination** options to set where to display or save the repor - Select **New tab** to display the report on a new tab in the PEM client. You must select **New tab** to display the first generation of a Capacity Manager report. For subsequent reports, you can select **Previous tab**. - Select **Previous tab** to reuse a previously opened tab when displaying the report. - Select **Download the report as a file** and specify a file name to write the report to the specified file. +- Select **Report Type?** as **HTML** or **JSON** type from version 9.6 and later. After you specify the report boundaries and select the type and destination of the Capacity Manager report, select **Generate** to create the report. -Reports saved to file are stored as HTML. You can review a Capacity Manager report with any web browser that supports scalable vector graphics (SVG). Browsers that don't support SVG can't display a Capacity Manager graph and might include unwanted characters. +You can review a Capacity Manager report of HTML type with any web browser that supports scalable vector graphics (SVG). Browsers that don't support SVG can't display a Capacity Manager graph and might include unwanted characters. ## Capacity Manager templates From 97ad82694eda13426ea62fca6d0bf04b914558b8 Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Tue, 14 May 2024 18:48:47 +0530 Subject: [PATCH 05/18] Added a note for FQDN as per [DOCS-498](https://enterprisedb.atlassian.net/issues/DOCS-498) --- product_docs/docs/pem/9/registering_agent.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/product_docs/docs/pem/9/registering_agent.mdx b/product_docs/docs/pem/9/registering_agent.mdx index 8e43d3c4ca7..9514716c069 100644 --- a/product_docs/docs/pem/9/registering_agent.mdx +++ b/product_docs/docs/pem/9/registering_agent.mdx @@ -64,7 +64,9 @@ set PEM_SERVER_PASSWORD=edb | `--enable-snmp` | Enable the `enable-snmp parameter` to allow the PEM agent to send the SNMP traps on behalf of the PEM server. The default value is `False`. | | `-o` | Specifies whether you want to override the configuration file options. | - +!!!Note +If you provide `--display-name` option while registering an agent, it gets registered using the provided display name. If you don't provide the display name, it gets registered using the `Fully qualified domain name (FQDN)`. If FQDN is not set, it gets registered using the hostname. +!!! !!! Note Allowing the agent to restart the database server If you use any feature of PEM that requires a database server restart by the PEM agent (such as Audit Manager, Log Manager, or the Tuning Wizard), then you must set the value of `allow_server_restart` to `true` in the `agent.cfg` file or restart the server manually for changes to take effect. From 5d1df381552b8fae834777c8981831b4252d5809 Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Wed, 15 May 2024 11:48:33 +0530 Subject: [PATCH 06/18] Added enable/disable probe using pemworker as per [DOCS-477](https://enterprisedb.atlassian.net/issues/DOCS-477) --- .../pem/9/monitoring_performance/probes.mdx | 46 +++++++++++++++++++ 1 file changed, 46 insertions(+) diff --git a/product_docs/docs/pem/9/monitoring_performance/probes.mdx b/product_docs/docs/pem/9/monitoring_performance/probes.mdx index 191bf888df5..08cd6461d88 100644 --- a/product_docs/docs/pem/9/monitoring_performance/probes.mdx +++ b/product_docs/docs/pem/9/monitoring_performance/probes.mdx @@ -259,6 +259,52 @@ If you specify a parent node in the **Copy Probe Configuration** tree, PEM copie After you select the target object or objects, select **Configure Probes** to copy the probe definitions to the location selected in the dialog box. +## Managing probes using pemworker + +You can enable and disable a probe using the pemworker utility from version 9.6 and later. + +### Examples + +**On Linux** + +This example shows how to disable a probe using the probe display name: + +```shell +export PEM_SERVER_PASSSWORD=edb +./pemworker --pem-user enterprisedb --disable-probe --probe-display-name "cpu usage" +__OUTPUT__ +Wed Mar 27 01:43:40 2024 INFO: Probe status updated for agent (id: 1) +``` + +This example shows how to enable a probe using the probe display name: + +```shell +export PEM_SERVER_PASSSWORD=edb +./pemworker --pem-user enterprisedb --enable-probe --probe-display-name "database size" +__OUTPUT__ +Wed Mar 27 02:02:20 2024 INFO: Probe status updated for server (id: 1) +``` + +**On Windows** + +This example shows how to disable a probe using the probe display name: + +```shell +set PEM_SERVER_PASSWORD=edb +./pemworker.exe DISABLE-PROBE --pem-user postgres --probe-display-name "CPU usage" +__OUTPUT__ +INFO: Probe status updated for agent (id: 1) +``` + +This example shows how to enable a probe using the probe display name: + +```shell +set PEM_SERVER_PASSWORD=edb +./pemworker.exe ENABLE-PROBE --pem-user postgres --probe-display-name "CPU usage" +__OUTPUT__ +INFO: Probe status updated for agent (id: 1) +``` + ## PEM probes – reference A probe is a scheduled task that retrieves information about the database objects that are being monitored by the PEM agent. PEM uses the collected information to build the graphs displayed on each dashboard. The **Manage Probes** tab (accessed from the **Management** menu) allows you to modify the data collection schedule and the length of time that PEM retains information returned by a specific probe. From d638e424db9e57e362b8b4d2c321accfd465c1db Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Wed, 15 May 2024 12:09:05 +0530 Subject: [PATCH 07/18] Added Debian 11 and 12 dependencies --- product_docs/docs/pem/9/installing/dependencies.mdx | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/product_docs/docs/pem/9/installing/dependencies.mdx b/product_docs/docs/pem/9/installing/dependencies.mdx index b5901098530..1356647ae5a 100644 --- a/product_docs/docs/pem/9/installing/dependencies.mdx +++ b/product_docs/docs/pem/9/installing/dependencies.mdx @@ -46,6 +46,8 @@ Python 3 and mod_wsgi (a Python module for Apache HTTPD) are required for PEM Se | Ubuntu 20 | amd64 | `edb-python310/edb-python310-mod-wsgi` | 3.10 | `/usr/libexec/edb-python310/bin/python3` | | Ubuntu 22 | amd64 | `python310//libapache2-mod-wsgi-py3` | 3.10 | `/usr/bin/python3` | | Debian 10 | amd64 | `edb-python310/edb-python310-mod-wsgi` | 3.10 | `/usr/libexec/edb-python310/bin/python3` | +| Debian 11 | amd64 | `edb-python310/edb-python310-mod-wsgi` | 3.10 | `/usr/libexec/edb-python310/bin/python3` | +| Debian 12 | amd64/arm64 | `python311/libapache2-mod-wsgi-py3` | 3.11 | `/usr/bin/python3` | ## OpenSSL @@ -70,6 +72,8 @@ The PEM Server and Agent require OpenSSL. | Ubuntu 20 | amd64 | `openssl-1.1.1f` | | Ubuntu 22 | amd64 | `openssl-3.0.2` | | Debian 10 | amd64 | `openssl-1.1.1n` | +| Debian 11 | amd64 | `openssl-1.1.1w` | +| Debian 12 | amd64/arm64 | `openssl-3.0.11` | ## Libcurl @@ -94,6 +98,8 @@ The PEM Agent requires libcurl. | Ubuntu 20 | amd64 | `libcurl4-7.68.0` | | Ubuntu 22 | amd64 | `libcurl4-7.81.0` | | Debian 10 | amd64 | `libcurl4-7.64.0` | +| Debian 11 | amd64 | `libcurl4-7.74.0` | +| Debian 12 | amd64/arm64 | `libcurl4-7.88.1` | ## SNMP++ @@ -118,6 +124,8 @@ The PEM Agent requires SNMP++. | Ubuntu 20 | amd64 | `edb-snmp++-3.4.10` | | Ubuntu 22 | amd64 | `edb-snmp++-3.4.10` | | Debian 10 | amd64 | `edb-snmp++-3.4.10` | +| Debian 11 | amd64 | `edb-snmp++-3.4.10` | +| Debian 12 | amd64/arm64 | `edb-snmp++-3.4.10` | ## Boost libraries @@ -141,4 +149,6 @@ The PEM Agent requires the Boost libraries. | | s390x | `libboost_regex1_66_1-1.66.0` | | Ubuntu 20 | amd64 | `libboost-system1.71.0-1.71.0` | | Ubuntu 22 | amd64 | `libboost-system1.74.0-1.74.0` | -| Debian 10 | amd64 | `libboost-system1.67.0-1.67.0` | \ No newline at end of file +| Debian 10 | amd64 | `libboost-system1.67.0-1.67.0` | +| Debian 11 | amd64 | `libboost-system1.74.0-1.74.0` | +| Debian 12 | amd64/arm64 | `libboost-system1.74.0-1.74.0` | \ No newline at end of file From 3c3d6a306961dcf8d22dc44fcd673fed662b5746 Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Wed, 15 May 2024 12:43:17 +0530 Subject: [PATCH 08/18] Updated content as per review comments from Shubham and Shubam --- product_docs/docs/pem/9/monitoring_performance/probes.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/product_docs/docs/pem/9/monitoring_performance/probes.mdx b/product_docs/docs/pem/9/monitoring_performance/probes.mdx index 08cd6461d88..a01489d449c 100644 --- a/product_docs/docs/pem/9/monitoring_performance/probes.mdx +++ b/product_docs/docs/pem/9/monitoring_performance/probes.mdx @@ -73,7 +73,7 @@ Unless otherwise noted, Postgres Enterprise Manager enables the following probes | User Information | A list of the current users. The stored information includes:
The user name
The user type (superuser or non-superuser)
The server to which the user is connected | Server | | WAL Archive Status | Status of the WAL archive. The stored information includes:
The number of WAL archives done
The number of WAL archives pending
The last archive time
The number of WAL archives failed
The time of the last failure | Server | | xDB Replication | Lag data for clusters replicated using xDB replication. | Database | -| Multixact ID Exhaustion (Wraparound) | Information about the maximum transaction ID. The stored information includes:
The name of the database
The oldest current maximum XID. | Server | +| Multixact ID Exhaustion (Wraparound) | Information about the maximum transaction ID. The stored information includes:
The name of the database
The oldest current Multixact ID in the database
Percentage towards wraparound
Percentage towards emergency autovacuum | Server | | Replication Slots | Information about the replication slots. The stored information includes:
A unique, cluster-wide identifier for the replication slot
The base name of the shared object containing the output plugin this logical slot is using, or null for physical slots
The slot type - physical or logical
The OID of the database this slot is associated with, or null. Only logical slots have an associated database
The name of the database this slot is associated with, or null. Only logical slots have an associated database
Active field is True if this slot is currently actively being used
The oldest transaction that this slot needs the database to retain. VACUUM cannot remove tuples deleted by any later transaction
The oldest transaction affecting the system catalogs that this slot needs the database to retain. VACUUM cannot remove catalog tuples deleted by any later transaction
The address (LSN) of oldest WAL which still might be required by the consumer of this slot and thus won't be automatically removed during checkpoints | Server | @@ -261,7 +261,7 @@ After you select the target object or objects, select **Configure Probes** to co ## Managing probes using pemworker -You can enable and disable a probe using the pemworker utility from version 9.6 and later. +From version 9.6 and later, you can enable and disable a probe using the pemworker utility using `--probe-display-name`, `--probe-internal-name`, or `--probe-id` option. ### Examples From a7e2a04b1719a67e6b4003a7a3b0817b32457350 Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Wed, 15 May 2024 12:45:06 +0530 Subject: [PATCH 09/18] Update probes.mdx --- product_docs/docs/pem/9/monitoring_performance/probes.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/product_docs/docs/pem/9/monitoring_performance/probes.mdx b/product_docs/docs/pem/9/monitoring_performance/probes.mdx index a01489d449c..dc3f8020240 100644 --- a/product_docs/docs/pem/9/monitoring_performance/probes.mdx +++ b/product_docs/docs/pem/9/monitoring_performance/probes.mdx @@ -73,7 +73,7 @@ Unless otherwise noted, Postgres Enterprise Manager enables the following probes | User Information | A list of the current users. The stored information includes:
The user name
The user type (superuser or non-superuser)
The server to which the user is connected | Server | | WAL Archive Status | Status of the WAL archive. The stored information includes:
The number of WAL archives done
The number of WAL archives pending
The last archive time
The number of WAL archives failed
The time of the last failure | Server | | xDB Replication | Lag data for clusters replicated using xDB replication. | Database | -| Multixact ID Exhaustion (Wraparound) | Information about the maximum transaction ID. The stored information includes:
The name of the database
The oldest current Multixact ID in the database
Percentage towards wraparound
Percentage towards emergency autovacuum | Server | +| Multixact ID Exhaustion (Wraparound) | Information about the multixact transaction ID. The stored information includes:
The name of the database
The oldest current Multixact ID in the database
Percentage towards wraparound
Percentage towards emergency autovacuum | Server | | Replication Slots | Information about the replication slots. The stored information includes:
A unique, cluster-wide identifier for the replication slot
The base name of the shared object containing the output plugin this logical slot is using, or null for physical slots
The slot type - physical or logical
The OID of the database this slot is associated with, or null. Only logical slots have an associated database
The name of the database this slot is associated with, or null. Only logical slots have an associated database
Active field is True if this slot is currently actively being used
The oldest transaction that this slot needs the database to retain. VACUUM cannot remove tuples deleted by any later transaction
The oldest transaction affecting the system catalogs that this slot needs the database to retain. VACUUM cannot remove catalog tuples deleted by any later transaction
The address (LSN) of oldest WAL which still might be required by the consumer of this slot and thus won't be automatically removed during checkpoints | Server | From 525923da0cc289aeed116019d3506c735eb9902d Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Wed, 15 May 2024 12:47:32 +0530 Subject: [PATCH 10/18] Update probes.mdx --- product_docs/docs/pem/9/monitoring_performance/probes.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/product_docs/docs/pem/9/monitoring_performance/probes.mdx b/product_docs/docs/pem/9/monitoring_performance/probes.mdx index dc3f8020240..94d89da26cd 100644 --- a/product_docs/docs/pem/9/monitoring_performance/probes.mdx +++ b/product_docs/docs/pem/9/monitoring_performance/probes.mdx @@ -73,7 +73,7 @@ Unless otherwise noted, Postgres Enterprise Manager enables the following probes | User Information | A list of the current users. The stored information includes:
The user name
The user type (superuser or non-superuser)
The server to which the user is connected | Server | | WAL Archive Status | Status of the WAL archive. The stored information includes:
The number of WAL archives done
The number of WAL archives pending
The last archive time
The number of WAL archives failed
The time of the last failure | Server | | xDB Replication | Lag data for clusters replicated using xDB replication. | Database | -| Multixact ID Exhaustion (Wraparound) | Information about the multixact transaction ID. The stored information includes:
The name of the database
The oldest current Multixact ID in the database
Percentage towards wraparound
Percentage towards emergency autovacuum | Server | +| Multixact ID Exhaustion (Wraparound) | Information about the multixact ID. The stored information includes:
The name of the database
The oldest current Multixact ID in the database
Percentage towards wraparound
Percentage towards emergency autovacuum | Server | | Replication Slots | Information about the replication slots. The stored information includes:
A unique, cluster-wide identifier for the replication slot
The base name of the shared object containing the output plugin this logical slot is using, or null for physical slots
The slot type - physical or logical
The OID of the database this slot is associated with, or null. Only logical slots have an associated database
The name of the database this slot is associated with, or null. Only logical slots have an associated database
Active field is True if this slot is currently actively being used
The oldest transaction that this slot needs the database to retain. VACUUM cannot remove tuples deleted by any later transaction
The oldest transaction affecting the system catalogs that this slot needs the database to retain. VACUUM cannot remove catalog tuples deleted by any later transaction
The address (LSN) of oldest WAL which still might be required by the consumer of this slot and thus won't be automatically removed during checkpoints | Server | From f9148ed5f2d31b5a65ec419c318f925109a6ff5e Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Wed, 15 May 2024 15:31:44 +0530 Subject: [PATCH 11/18] Update product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx Co-authored-by: Simon Notley <43099400+sonotley@users.noreply.github.com> --- product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx b/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx index ff5a94d256d..53724a51550 100644 --- a/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx +++ b/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx @@ -9,7 +9,7 @@ New features, enhancements, bug fixes, and other changes in PEM 9.6.0 include: | Type | Description | |--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| Enhancement | Added an option to enable the probes using the pemworker utility. | +| Enhancement | Added an option to enable probes using the pemworker utility. | | Enhancement | Fixed an issue to include the error message in the email of the PEM agent job output. The default character limit for error output is 1000, which can be configured now using `job_notification_error_limit` parameter in the server configuration. | | Enhancement | Added two alert templates — `Inactive replication slots` and `Conflicting replication slots` and added two probes — `Replication slots` and `Multixact ID Exhaustion (Wraparound)`. | | Bug fix | Fixed an issue where audit manager was setting `edb_audit_statement` parameter to '' instead on 'none' when log statement parameter was left empty in the GUI resulting in failure of server restart. | From fa803ab402aea8b2e6cfe165d7ff4048c45a9bf7 Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Wed, 15 May 2024 15:32:09 +0530 Subject: [PATCH 12/18] Update product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx Co-authored-by: Simon Notley <43099400+sonotley@users.noreply.github.com> --- product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx b/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx index 53724a51550..19ebd59aabc 100644 --- a/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx +++ b/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx @@ -10,7 +10,7 @@ New features, enhancements, bug fixes, and other changes in PEM 9.6.0 include: | Type | Description | |--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Enhancement | Added an option to enable probes using the pemworker utility. | -| Enhancement | Fixed an issue to include the error message in the email of the PEM agent job output. The default character limit for error output is 1000, which can be configured now using `job_notification_error_limit` parameter in the server configuration. | +| Enhancement | PEM now includes the error message in email notifications of a failed job. The default character limit for error output is 1000, which can be configured now using `job_notification_error_limit` parameter in the server configuration. | | Enhancement | Added two alert templates — `Inactive replication slots` and `Conflicting replication slots` and added two probes — `Replication slots` and `Multixact ID Exhaustion (Wraparound)`. | | Bug fix | Fixed an issue where audit manager was setting `edb_audit_statement` parameter to '' instead on 'none' when log statement parameter was left empty in the GUI resulting in failure of server restart. | | Bug fix | Updated the default parameter for configuring PEM to use the `Fully Qualified Domain Name (FQDN)` hostname while agent registration. | From 850c89f1ce56c51a2b44817d41d5d4ce585e7705 Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Wed, 15 May 2024 15:32:23 +0530 Subject: [PATCH 13/18] Update product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx Co-authored-by: Simon Notley <43099400+sonotley@users.noreply.github.com> --- product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx b/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx index 19ebd59aabc..56a58b4e9f9 100644 --- a/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx +++ b/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx @@ -12,7 +12,7 @@ New features, enhancements, bug fixes, and other changes in PEM 9.6.0 include: | Enhancement | Added an option to enable probes using the pemworker utility. | | Enhancement | PEM now includes the error message in email notifications of a failed job. The default character limit for error output is 1000, which can be configured now using `job_notification_error_limit` parameter in the server configuration. | | Enhancement | Added two alert templates — `Inactive replication slots` and `Conflicting replication slots` and added two probes — `Replication slots` and `Multixact ID Exhaustion (Wraparound)`. | -| Bug fix | Fixed an issue where audit manager was setting `edb_audit_statement` parameter to '' instead on 'none' when log statement parameter was left empty in the GUI resulting in failure of server restart. | +| Bug fix | Fixed an issue where audit manager was setting `edb_audit_statement` parameter to '' instead of 'none' when log statement parameter was left empty in the GUI resulting in failure of server restart. | | Bug fix | Updated the default parameter for configuring PEM to use the `Fully Qualified Domain Name (FQDN)` hostname while agent registration. | | Bug fix | Fixed an issue with error `NoneType` has no `len()` when alerts were listed on the alert dashboard. | | Bug fix | Fixed an issue for team role feature for the PEM agents. | From 2d8548cddfc9d41cc29efac7b840213aac63e7ca Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Wed, 15 May 2024 15:32:37 +0530 Subject: [PATCH 14/18] Update product_docs/docs/pem/9/monitoring_performance/probes.mdx Co-authored-by: Simon Notley <43099400+sonotley@users.noreply.github.com> --- product_docs/docs/pem/9/monitoring_performance/probes.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/product_docs/docs/pem/9/monitoring_performance/probes.mdx b/product_docs/docs/pem/9/monitoring_performance/probes.mdx index 94d89da26cd..1a948244a7c 100644 --- a/product_docs/docs/pem/9/monitoring_performance/probes.mdx +++ b/product_docs/docs/pem/9/monitoring_performance/probes.mdx @@ -270,7 +270,7 @@ From version 9.6 and later, you can enable and disable a probe using the pemwork This example shows how to disable a probe using the probe display name: ```shell -export PEM_SERVER_PASSSWORD=edb +export PEM_SERVER_PASSWORD=edb ./pemworker --pem-user enterprisedb --disable-probe --probe-display-name "cpu usage" __OUTPUT__ Wed Mar 27 01:43:40 2024 INFO: Probe status updated for agent (id: 1) From 8b98bfe84cd947a2a5326507f96641313baefa9b Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Wed, 15 May 2024 15:32:47 +0530 Subject: [PATCH 15/18] Update product_docs/docs/pem/9/monitoring_performance/probes.mdx Co-authored-by: Simon Notley <43099400+sonotley@users.noreply.github.com> --- product_docs/docs/pem/9/monitoring_performance/probes.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/product_docs/docs/pem/9/monitoring_performance/probes.mdx b/product_docs/docs/pem/9/monitoring_performance/probes.mdx index 1a948244a7c..7c871e3e6bb 100644 --- a/product_docs/docs/pem/9/monitoring_performance/probes.mdx +++ b/product_docs/docs/pem/9/monitoring_performance/probes.mdx @@ -279,7 +279,7 @@ Wed Mar 27 01:43:40 2024 INFO: Probe status updated for agent (id: 1) This example shows how to enable a probe using the probe display name: ```shell -export PEM_SERVER_PASSSWORD=edb +export PEM_SERVER_PASSWORD=edb ./pemworker --pem-user enterprisedb --enable-probe --probe-display-name "database size" __OUTPUT__ Wed Mar 27 02:02:20 2024 INFO: Probe status updated for server (id: 1) From 3f988030ef9ee736e110cfed5b0a700e27cacfd7 Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Wed, 15 May 2024 15:33:06 +0530 Subject: [PATCH 16/18] Update product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx Co-authored-by: Simon Notley <43099400+sonotley@users.noreply.github.com> --- product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx b/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx index 56a58b4e9f9..bbd58365b8e 100644 --- a/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx +++ b/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx @@ -14,7 +14,7 @@ New features, enhancements, bug fixes, and other changes in PEM 9.6.0 include: | Enhancement | Added two alert templates — `Inactive replication slots` and `Conflicting replication slots` and added two probes — `Replication slots` and `Multixact ID Exhaustion (Wraparound)`. | | Bug fix | Fixed an issue where audit manager was setting `edb_audit_statement` parameter to '' instead of 'none' when log statement parameter was left empty in the GUI resulting in failure of server restart. | | Bug fix | Updated the default parameter for configuring PEM to use the `Fully Qualified Domain Name (FQDN)` hostname while agent registration. | -| Bug fix | Fixed an issue with error `NoneType` has no `len()` when alerts were listed on the alert dashboard. | +| Bug fix | Fixed an issue whereby an error "`NoneType` has no `len()`" would occur when alerts were listed on the alert dashboard. | | Bug fix | Fixed an issue for team role feature for the PEM agents. | | Bug fix | Fixed an issue with SQL query for the PEM agent registration. Added the public schema name in the table prefix to execute the SQL query successfully even if schema name is not in the search path. | | Big fix | Updated the alert template `Table size in server/database/schema` with more detailed SQL query. | \ No newline at end of file From eaae0c152a7e2961ea01ea320dc8e68f6cd5e80b Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Wed, 15 May 2024 15:34:09 +0530 Subject: [PATCH 17/18] Update product_docs/docs/pem/9/monitoring_performance/probes.mdx Co-authored-by: Simon Notley <43099400+sonotley@users.noreply.github.com> --- product_docs/docs/pem/9/monitoring_performance/probes.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/product_docs/docs/pem/9/monitoring_performance/probes.mdx b/product_docs/docs/pem/9/monitoring_performance/probes.mdx index 7c871e3e6bb..af5d1e37b6d 100644 --- a/product_docs/docs/pem/9/monitoring_performance/probes.mdx +++ b/product_docs/docs/pem/9/monitoring_performance/probes.mdx @@ -261,7 +261,7 @@ After you select the target object or objects, select **Configure Probes** to co ## Managing probes using pemworker -From version 9.6 and later, you can enable and disable a probe using the pemworker utility using `--probe-display-name`, `--probe-internal-name`, or `--probe-id` option. +From version 9.6, you can enable and disable a probe using the pemworker utility using `--probe-display-name`, `--probe-internal-name`, or `--probe-id` option. ### Examples From 2a0395afd8d477abb33ac6c86a4a50fb2fab2c29 Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Wed, 15 May 2024 16:10:17 +0530 Subject: [PATCH 18/18] Updated content as per review comments from Simon --- .../pem/9/pem_rel_notes/960_rel_notes.mdx | 20 +++++++++---------- product_docs/docs/pem/9/registering_agent.mdx | 6 +----- 2 files changed, 11 insertions(+), 15 deletions(-) diff --git a/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx b/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx index bbd58365b8e..006c3e6fbf1 100644 --- a/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx +++ b/product_docs/docs/pem/9/pem_rel_notes/960_rel_notes.mdx @@ -7,14 +7,14 @@ Released: 15 May 2024 New features, enhancements, bug fixes, and other changes in PEM 9.6.0 include: -| Type | Description | -|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| Enhancement | Added an option to enable probes using the pemworker utility. | +| Type | Description | +|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Enhancement | Added an option to enable probes using the pemworker utility. | | Enhancement | PEM now includes the error message in email notifications of a failed job. The default character limit for error output is 1000, which can be configured now using `job_notification_error_limit` parameter in the server configuration. | -| Enhancement | Added two alert templates — `Inactive replication slots` and `Conflicting replication slots` and added two probes — `Replication slots` and `Multixact ID Exhaustion (Wraparound)`. | -| Bug fix | Fixed an issue where audit manager was setting `edb_audit_statement` parameter to '' instead of 'none' when log statement parameter was left empty in the GUI resulting in failure of server restart. | -| Bug fix | Updated the default parameter for configuring PEM to use the `Fully Qualified Domain Name (FQDN)` hostname while agent registration. | -| Bug fix | Fixed an issue whereby an error "`NoneType` has no `len()`" would occur when alerts were listed on the alert dashboard. | -| Bug fix | Fixed an issue for team role feature for the PEM agents. | -| Bug fix | Fixed an issue with SQL query for the PEM agent registration. Added the public schema name in the table prefix to execute the SQL query successfully even if schema name is not in the search path. | -| Big fix | Updated the alert template `Table size in server/database/schema` with more detailed SQL query. | \ No newline at end of file +| Enhancement | Added two alert templates — `Inactive replication slots` and `Conflicting replication slots` and added two probes — `Replication slots` and `Multixact ID Exhaustion (Wraparound)`. | +| Enhancement | The default display name for a newly registered agent is now the host's fully qualified domain name (FQDN), falling back to the previous default of the hostname if the FQDN is not set. | +| Enhancement | Updated the alert template `Table size in server/database/schema` with more detailed SQL query. | +| Bug fix | Fixed an issue where audit manager was setting `edb_audit_statement` parameter to '' instead of 'none' when log statement parameter was left empty in the GUI resulting in failure of server restart. | +| Bug fix | Fixed an issue whereby an error "`NoneType` has no `len()`" would occur when alerts were listed on the alert dashboard. | +| Bug fix | Fixed an issue where team role was not working with PEM agents as expected. | +| Bug fix | Fixed an issue with SQL query for the PEM agent registration. Added the public schema name in the table prefix to execute the SQL query successfully even if schema name is not in the search path. | diff --git a/product_docs/docs/pem/9/registering_agent.mdx b/product_docs/docs/pem/9/registering_agent.mdx index 9514716c069..8d43fc06a24 100644 --- a/product_docs/docs/pem/9/registering_agent.mdx +++ b/product_docs/docs/pem/9/registering_agent.mdx @@ -51,7 +51,7 @@ set PEM_SERVER_PASSWORD=edb | `--pem-agent-user` | The agent user to connect the PEM server backend database server. | | `--cert-path` | The complete path to the directory where certificates are created. If you don't provide a path, certificates are created in `~/.pem` on Linux and `%APPDATA%/pem` on Windows | | `--config-dir` | The directory path for the configuration file. The default is `/../etc`. | -| `--display-name` | A user-friendly name for the agent to display in the PEM browser tree. The default is the system hostname. | +| `--display-name` | A user-friendly name for the agent to display in the PEM browser tree. In PEM 9.6 and later, the default is the host's fully qualified domain name (FQDN), falling back to the hostname if this is not set. Prior to PEM 9.6, the default is the hostname. | | `--force-registration` | Include the `force_registration` clause to register the agent with the arguments provided. This clause is useful if you're overriding an existing agent configuration. The default value is `Yes`. | | `--group` | The name of the group in which the agent is displayed. | | `--team` | The name of the database role on the PEM backend database server with access to the monitored database server. | @@ -64,10 +64,6 @@ set PEM_SERVER_PASSWORD=edb | `--enable-snmp` | Enable the `enable-snmp parameter` to allow the PEM agent to send the SNMP traps on behalf of the PEM server. The default value is `False`. | | `-o` | Specifies whether you want to override the configuration file options. | -!!!Note -If you provide `--display-name` option while registering an agent, it gets registered using the provided display name. If you don't provide the display name, it gets registered using the `Fully qualified domain name (FQDN)`. If FQDN is not set, it gets registered using the hostname. -!!! - !!! Note Allowing the agent to restart the database server If you use any feature of PEM that requires a database server restart by the PEM agent (such as Audit Manager, Log Manager, or the Tuning Wizard), then you must set the value of `allow_server_restart` to `true` in the `agent.cfg` file or restart the server manually for changes to take effect.