docs: move pg_cron job management instructions to generic maintenance section

template/README.md

@@ -1,17 +1,16 @@
 # Zabbix PostgreSQL Partitioning Monitoring
 
-This directory contains an extremely efficient, production-ready Zabbix Native Agent 2 monitoring suite designed to track the health of your actively partitioned PostgreSQL database tables.
+This template relies on Zabbix Agent 2 and its PostgreSQL plugin. It allows you to monitor the health of your partitioned PostgreSQL database tables. It uses a single master item to pull all metrics in bulk over a single database connection, dynamically distributing the numbers to Zabbix using Dependent Items.
+There are three item prototypes:
+1. Future Partitions Buffer: Number of future partitions to be created
+2. Total Size Bytes: Total size of the partitioned table in bytes
+3. Time Since Last Maintenance: Time since the last maintenance script was run
+They allows to monitor all the critical metrics and also they do have a triggers, which will create a problem in case something is wrong with the partitioning. 
 
-This template natively leverages the Zabbix Agent 2 backend. It uses a single, highly-optimized master payload query (`partitions.get_all.sql`) to pull all metrics in bulk over a single database connection, dynamically distributing the numbers to Zabbix using Dependent Items.
-
-### Step-by-Step Setup
-1. Copy the **one** SQL file (`template/partitions.get_all.sql`) into a secure directory on your Agent machine. E.g., `/etc/zabbix/zabbix_agent2.d/postgresql/`.
-2. Secure the local Linux permissions so the Zabbix user can strictly read it:
-   ```bash
-   chown -R zabbix:zabbix /etc/zabbix/zabbix_agent2.d/postgresql
-   chmod 644 /etc/zabbix/zabbix_agent2.d/postgresql/*.sql
-   ```
-3. Open your main `/etc/zabbix/zabbix_agent2.conf` file. Scroll to the absolute bottom and add these exact lines to safely establish your custom query module AND a secure named session (e.g., `AWS_RDS`):
+### Setup
+1. Copy the SQL file (`template/partitions.get_all.sql`) into a directory on your Agent machine. E.g., `/etc/zabbix/zabbix_agent2.d/postgresql/`.
+2. Install  zabbix-agent2-plugin-postgresql package.
+3. Open your Plugin configuration file `/etc/zabbix/zabbix_agent2.d/plugins.d/postgresql.conf` and add these lines to establish your custom query module AND a secure named session (e.g., `AWS_RDS`). Adjust the parameters to match your environment. You can use uri instead of named session if you want. In this case you will need to modify the item keys to use the correct parameters.
    ```ini
    # 1. Enable Loadable Custom Queries (Mandatory in Zabbix 7.4+)
    Plugins.PostgreSQL.CustomQueriesPath=/etc/zabbix/zabbix_agent2.d/postgresql/
@@ -24,12 +23,10 @@ This template natively leverages the Zabbix Agent 2 backend. It uses a single, h
    Plugins.PostgreSQL.Sessions.AWS_RDS.TLSConnect=verify_full
    Plugins.PostgreSQL.Sessions.AWS_RDS.TLSCAFile=/etc/zabbix/global-bundle.pem
    ```
-4. Restart your agent to lock the session and SSL configurations into memory: 
+4. Restart your agent to apply the changes: 
    ```bash
    systemctl restart zabbix-agent2
    ```
-5. Import the `zbx_pg_partitions_monitor_agent2.yaml` template directly into your Zabbix Frontend.
-6. Attach the template to your Host, navigate to its "Macros" tab, and define strictly exactly this **one** macro:
-   * `{$PG.CONNSTRING.AGENT2}`: `AWS_RDS` 
-   
-*(By pointing this macro to the Session name we built in Step 3, you are telling Zabbix to seamlessly abandon all plaintext frontend passwords and rely 100% on the encrypted local session parameters!)*
+5. Import the `zbx_pg_partitions_monitor_agent2.yaml` template into your Zabbix.
+6. Link the template to your Host, navigate to its "Macros" tab, and define the needed macros (in this case it's just named session):
+   * `{$PG.CONNSTRING.AGENT2}`: `AWS_RDS`

template/zbx_pg_partitions_monitor_agent2.yaml

@@ -1,79 +1,105 @@
 zabbix_export:
-  version: '7.0'
+  version: '7.4'
+  template_groups:
+    - uuid: 748ad4d098d447d492bb935c907f652f
+      name: Templates/Databases
   templates:
     - uuid: a1d5f8c3b2e44a7c9d6b1f2e8a3c5b4d
-      template: 'RDS PostgreSQL Partitioning Monitoring Agent 2'
-      name: 'RDS PostgreSQL Partitioning Monitoring (Agent 2)'
-      description: 'Monitors the custom partitions.monitoring view via the native Zabbix Agent 2 PostgreSQL plugin. Optimized using a master data payload.'
+      template: 'PostgreSQL Partitioning by Zabbix Agent 2'
+      name: 'PostgreSQL Partitioning by Zabbix Agent 2'
+      description: 'Monitors the custom partitions.monitoring view via the native Zabbix Agent 2 PostgreSQL plugin. Using a single master to minimize the DB connections and load.'
+      vendor:
+        name: Zabbix Support
+        version: 7.4-0 
       groups:
         - name: Templates/Databases
-      macros:
-        - macro: '{$PG.CONNSTRING.AGENT2}'
-          value: 'AWS_RDS'
-          description: 'Session name or URI of the PostgreSQL instance'
-        - macro: '{$PG.DBNAME}'
-          value: 'zabbix'
       items:
         - uuid: b8c7d6e5f4a34b2c8d2e3f4a5b6c7d8e
           name: 'PostgreSQL: Get Partitioning Data'
-          type: ZABBIX_PASSIVE
           key: 'pgsql.custom.query["{$PG.CONNSTRING.AGENT2}",,,"{$PG.DBNAME}","partitions.get_all"]'
+          history: '0'
           value_type: TEXT
           description: 'Master item that queries all partition statistics in a single bulk JSON sequence.'
+          tags:
+            - tag: component
+              value: raw
       discovery_rules:
         - uuid: b7c2a5d8f1e44b9c8a3f6d2e1c5b4a7d
           name: 'Partitioned Tables Discovery'
           type: DEPENDENT
-          key: 'db.partitions.discovery.dependent'
-          delay: '0'
-          master_item:
-            key: 'pgsql.custom.query["{$PG.CONNSTRING.AGENT2}",,,"{$PG.DBNAME}","partitions.get_all"]'
-          lld_macro_paths:
-            - lld_macro: '{#TABLE_NAME}'
-              path: '$.table_name'
+          key: db.partitions.discovery.dependent
           item_prototypes:
-            - uuid: c4b9e2a5f1d84c7a9f3b6d1e5a2c8b4d
-              name: 'Table {#TABLE_NAME}: Future Partitions Buffer'
-              type: DEPENDENT
-              key: 'db.partitions.future["{#TABLE_NAME}"]'
-              value_type: FLOAT
-              master_item:
-                key: 'pgsql.custom.query["{$PG.CONNSTRING.AGENT2}",,,"{$PG.DBNAME}","partitions.get_all"]'
-              preprocessing:
-                - type: JSONPATH
-                  parameters:
-                    - '$.[?(@.table_name == "{#TABLE_NAME}")].future_partitions.first()'
-              trigger_prototypes:
-                - uuid: d6e3a5c8b2f14d9e8a7b6c5d4e3f2a1b
-                  expression: 'last(/RDS PostgreSQL Partitioning Monitoring Agent 2/db.partitions.future["{#TABLE_NAME}"])<2'
-                  name: 'Table {#TABLE_NAME}: Future partitions buffer is critically low (< 2)'
-                  priority: HIGH
-            - uuid: e8f2a1b3c4d54e6f9a8b7c6d5e4f3a2b
-              name: 'Table {#TABLE_NAME}: Total Size Bytes'
-              type: DEPENDENT
-              key: 'db.partitions.size["{#TABLE_NAME}"]'
-              value_type: FLOAT
-              units: B
-              master_item:
-                key: 'pgsql.custom.query["{$PG.CONNSTRING.AGENT2}",,,"{$PG.DBNAME}","partitions.get_all"]'
-              preprocessing:
-                - type: JSONPATH
-                  parameters:
-                    - '$.[?(@.table_name == "{#TABLE_NAME}")].total_size_bytes.first()'
             - uuid: f1a2b3c4d5e64f7a9b8c7d6e5f4a3b2c
-              name: 'Table {#TABLE_NAME}: Time Since Last Maintenance'
+              name: '{#TABLE_NAME}: Time Since Last Maintenance'
               type: DEPENDENT
               key: 'db.partitions.age["{#TABLE_NAME}"]'
-              value_type: FLOAT
               units: s
-              master_item:
-                key: 'pgsql.custom.query["{$PG.CONNSTRING.AGENT2}",,,"{$PG.DBNAME}","partitions.get_all"]'
               preprocessing:
                 - type: JSONPATH
                   parameters:
                     - '$.[?(@.table_name == "{#TABLE_NAME}")].age_seconds.first()'
+              master_item:
+                key: 'pgsql.custom.query["{$PG.CONNSTRING.AGENT2}",,,"{$PG.DBNAME}","partitions.get_all"]'
+              tags:
+                - tag: metric
+                  value: age
+                - tag: table
+                  value: '{#TABLE_NAME}'
               trigger_prototypes:
                 - uuid: a9b8c7d6e5f44a3b8c1d2e3f4a5b6c7d
-                  expression: 'last(/RDS PostgreSQL Partitioning Monitoring Agent 2/db.partitions.age["{#TABLE_NAME}"])>172800'
+                  expression: 'last(/PostgreSQL Partitioning by Zabbix Agent 2/db.partitions.age["{#TABLE_NAME}"])>{$PARTITIONS.AGE}'
                   name: 'Table {#TABLE_NAME}: Maintenance script has not run successfully in over 48 hours'
                   priority: WARNING
+            - uuid: c4b9e2a5f1d84c7a9f3b6d1e5a2c8b4d
+              name: '{#TABLE_NAME}: Future Partitions Buffer'
+              type: DEPENDENT
+              key: 'db.partitions.future["{#TABLE_NAME}"]'
+              preprocessing:
+                - type: JSONPATH
+                  parameters:
+                    - '$.[?(@.table_name == "{#TABLE_NAME}")].future_partitions.first()'
+              master_item:
+                key: 'pgsql.custom.query["{$PG.CONNSTRING.AGENT2}",,,"{$PG.DBNAME}","partitions.get_all"]'
+              tags:
+                - tag: metric
+                  value: partitions
+                - tag: table
+                  value: '{#TABLE_NAME}'
+              trigger_prototypes:
+                - uuid: d6e3a5c8b2f14d9e8a7b6c5d4e3f2a1b
+                  expression: 'last(/PostgreSQL Partitioning by Zabbix Agent 2/db.partitions.future["{#TABLE_NAME}"])<{$PARTITIONS.LOW}'
+                  name: 'Table {#TABLE_NAME}: Future partitions buffer is critically low (< 2)'
+                  priority: HIGH
+            - uuid: e8f2a1b3c4d54e6f9a8b7c6d5e4f3a2b
+              name: '{#TABLE_NAME}: Total Size Bytes'
+              type: DEPENDENT
+              key: 'db.partitions.size["{#TABLE_NAME}"]'
+              units: B
+              preprocessing:
+                - type: JSONPATH
+                  parameters:
+                    - '$.[?(@.table_name == "{#TABLE_NAME}")].total_size_bytes.first()'
+              master_item:
+                key: 'pgsql.custom.query["{$PG.CONNSTRING.AGENT2}",,,"{$PG.DBNAME}","partitions.get_all"]'
+              tags:
+                - tag: metric
+                  value: size
+                - tag: table
+                  value: '{#TABLE_NAME}'
+          master_item:
+            key: 'pgsql.custom.query["{$PG.CONNSTRING.AGENT2}",,,"{$PG.DBNAME}","partitions.get_all"]'
+          lld_macro_paths:
+            - lld_macro: '{#TABLE_NAME}'
+              path: $.table_name
+      macros:
+        - macro: '{$PARTITIONS.AGE}'
+          value: 24h
+          description: 'The maximum period during which no new partitions may be created'
+        - macro: '{$PARTITIONS.LOW}'
+          value: '2'
+          description: 'The minimum number of partitions that must exist in the future'
+        - macro: '{$PG.CONNSTRING.AGENT2}'
+          value: AWS_RDS
+          description: 'Session name or URI of the PostgreSQL instance'
+        - macro: '{$PG.DBNAME}'
+          value: zabbix