Merge pull request #5245 from wind39/develop

product_docs/docs/lasso/4/describe.mdx

@@ -1440,6 +1440,210 @@ Currently used version of BDR.
 **Security impact:** Low — 
 No known security impact.
 
+### edb_wait_states database settings (`postgresql_db_edb_wait_states_database_settings`)
+
+Shows information on database settings
+
+**Report output:**
+
+  * File `edb_wait_states/database_settings.out`
+
+**Depth:** Shallow
+
+
+**Security Impact:** *Low* — 
+No known security impact.
+
+### edb_wait_states load profile (`postgresql_db_edb_wait_states_load_profile`)
+
+Average load profile of transactions
+
+**Report output:*
+
+  * File `edb_wait_states/load_profile.out`
+
+**Depth:** Shallow
+
+
+**Security Impact:** *Low* — 
+No known security impact.
+
+### edb_wait_states operating system information (`postgresql_db_edb_wait_states_operating_system_information`)
+
+Information about the operating system
+
+**Report output:**
+
+  * File `edb_wait_states/operating_system_information.out`
+
+**Depth:** Shallow
+
+
+**Security Impact:** *Low* — 
+No known security impact.
+
+### edb_wait_states server information — part 1 (`postgresql_db_edb_wait_states_server_information_1`)
+
+Information about the Postgres server — part 1
+
+**Report output:**
+
+  * File `edb_wait_states/server_information_1.out`
+
+**Depth:** Shallow
+
+
+**Security Impact:** *Low* — 
+No known security impact.
+
+### edb_wait_states server information — part 2 (`postgresql_db_edb_wait_states_server_information_2`)
+
+Information about the Postgres server — part 2
+
+**Report output:**
+
+  * File `edb_wait_states/server_information_2.out`
+
+**Depth:** Shallow
+
+
+**Security Impact:** *Low* — 
+No known security impact.
+
+### edb_wait_states shared buffers statistics (`postgresql_db_edb_wait_states_shared_buffers_stats`)
+
+Shows statistics in terms of buffer hits/misses
+
+**Report output:**
+
+  * File `edb_wait_states/shared_buffers_stats.out`
+
+**Depth:** Shallow
+
+
+**Security Impact:** *Low* — 
+No known security impact.
+
+### edb_wait_states temp file statistics (`postgresql_db_edb_wait_states_temp_file_stats`)
+
+Shows statistics about temp files usage
+
+**Report output:**
+
+  * File `edb_wait_states/temp_file_stats.out`
+
+**Depth:** Shallow
+
+
+**Security Impact:** *Low* — 
+No known security impact.
+
+### edb_wait_states top 10 SQL statements by cputime (`postgresql_db_edb_wait_states_top_sql_statements_cputime`)
+
+Which SQL statements are taking more CPU time
+
+**Report output:**
+
+  * File `edb_wait_states/top_sql_statements_cputime.out`
+
+**Depth:** Shallow
+
+
+**Security Impact:** *Low* — 
+No known security impact.
+
+### edb_wait_states top 10 SQL statements by dbtime (`postgresql_db_edb_wait_states_top_sql_statements_dbtime`)
+
+Which SQL statements are taking more database time
+
+**Report output:**
+
+  * File `edb_wait_states/top_sql_statements_dbtime.out`
+
+**Depth:** Shallow
+
+
+**Security Impact:** *Low* — 
+No known security impact.
+
+### edb_wait_states top 10 SQL statements by waittime (`postgresql_db_edb_wait_states_top_sql_statements_waittime`)
+
+Which SQL statements are waiting for more time
+
+**Report output:**
+
+  * File `edb_wait_states/top_sql_statements_waittime.out`
+
+**Depth:** Shallow
+
+
+**Security Impact:** *Low* — 
+No known security impact.
+
+### edb_wait_states top 10 wait events (`postgresql_db_edb_wait_states_top_wait_events`)
+
+Which events are taking more time on the cluster
+
+**Report output:**
+
+  * File `edb_wait_states/top_wait_events.out`
+
+**Depth:** Shallow
+
+
+**Security Impact:** *Low* — 
+No known security impact.
+
+### edb_wait_states transactions statistics (`postgresql_db_edb_wait_states_transaction_stats`)
+
+Shows statistics in terms of commits and rollbacks
+
+**Report output:**
+
+  * File `edb_wait_states/transaction_stats.out`
+
+**Depth:** Shallow
+
+
+**Security Impact:** *Low* — 
+No known security impact.
+
+### edb_wait_states tuple statistics (`postgresql_db_edb_wait_states_tuple_stats`)
+
+Shows statistics in terms tuple reads and writes
+
+**Report output:**
+
+  * File `edb_wait_states/tuple_stats.out`
+
+**Depth:** Shallow
+
+**Security Impact:** *Low* — 
+No known security impact.
+
+### edb_wait_states user sessions (`postgresql_db_edb_wait_states_user_sessions`)
+
+Shows information about user sessions
+
+**Report output:**
+
+  * File `edb_wait_states/user_sessions.out`
+
+**Depth:** Shallow
+
+**Security Impact:** *Low* — 
+No known security impact.
+
+### edb_wait_states WAL statistics (`postgresql_db_edb_wait_states_wal_stats`)
+
+Shows statistics in terms of WAL writes
+
+**Report output:**
+
+  * File `edb_wait_states/wal_stats.out`
+
+**Depth:** Shallow
+
 ### Database extensions (`postgresql_db_extensions`)
 
 List of extensions in the database.
@@ -2120,6 +2324,48 @@ Current EDB Postgres Advanced Server dblink information from `edb_dblink`.
 **Security impact:** Low — 
 No known security impact.
 
+### EPAS specific queue information (`postgresql_epas_queue`)
+
+Current EPAS queue information from `edb_queue`
+
+**Report output:**
+
+  * File `epas_edb_queue.out`
+
+**Depth:** Surface
+
+
+**Security Impact:** *Low* — 
+No known security impact.
+
+### EPAS specific queue callback information (`postgresql_epas_queue_callback`)
+
+Current EPAS queue callback information from `edb_queue_callback`
+
+**Report output:**
+
+  * File `epas_edb_queue_callback.out`
+
+**Depth:** Surface
+
+
+**Security Impact:** *Low* — 
+No known security impact.
+
+### EPAS specific queue table information (`postgresql_epas_queue_table`)
+
+Current EPAS queue table information from `edb_queue_table`
+
+**Report output:**
+
+  * File `epas_edb_queue_table.out`
+
+**Depth:** Surface
+
+
+ **Security Impact:** *Low* — 
+No known security impact.
+
 
 ## Barman (Backup and Recovery Manager)
 ### Barman check (`barman_check`)

product_docs/docs/lasso/4/release-notes.mdx

@@ -2,6 +2,36 @@
 title: Release notes
 ---
 
+## Lasso - Version 4.13.0
+
+Released: 08 Feb 2024
+
+Lasso Version 4.13.0 includes the following enhancements and bug fixes:
+
+| Type           | Description | Addresses |
+|----------------|-------------|-----------|
+| Feature        | Added Lasso packages for SLES 15 | DC-288 |
+| Feature        | Added new `--info` option to display all collector information with revision/version | DC-943 |
+| Feature        | Added support for `edb_queue` | DC-965 |
+| Feature        | Added command-line arguments to specify the range for `edb_wait_states`: `--sampling-start` and `--sampling-end` | DC-951 |
+| Feature        | Now gathers server information from `edb_wait_states` | DC-953 |
+| Feature        | Now gathers operating system information from `edb_wait_states` | DC-954 |
+| Feature        | Now gathers load profile from `edb_wait_states` | DC-955 |
+| Feature        | Now gathers top wait events from `edb_wait_states` | DC-956 |
+| Feature        | Now gathers top SQL statements from `edb_wait_states` | DC-957 |
+| Feature        | Now gathers transaction stats from `edb_wait_states` | DC-958 |
+| Feature        | Now gathers WAL stats from `edb_wait_states` | DC-959 |
+| Feature        | Now gathers shared buffers stats from `edb_wait_states` | DC-960 |
+| Feature        | Now gathers tuple stats from `edb_wait_states` | DC-961 |
+| Feature        | Now gathers temp files stats from `edb_wait_states` | DC-962 |
+| Feature        | Now gathers information about user sessions from `edb_wait_states` | DC-963 |
+| Feature        | Now gathers information about database settings from `edb_wait_states` | DC-964 |
+| Feature        | Added documentation about `edb_wait_states` into the Lasso docs | DC-972 |
+| Bug fix        | Allow `lasso --version` to be executed without a config file and simplify the output  | RT100700, DC-943 |
+| Bug fix        | No longer fetches `/proc` information if running from inside a container | RT101043, DC-968 |
+| Bug fix        | Added `SYS` schema qualifier for the `ALL_PART_*` relations | RT101043, DC-969 |
+
+
 ## Lasso - Version 4.12.0
 
 Released: 09 Jan 2024

product_docs/docs/lasso/4/report-types.mdx

@@ -460,3 +460,34 @@ Despite the argument being called `--system-only`, in this mode,
 Lasso gathers information about all the aforementioned tools
 except PostgreSQL/EDB Postgres Advanced Server and Barman.
 !!!
+
+
+## edb_wait_states report
+
+For each database where the `edb_wait_states` extension is installed, Lasso
+gathers important performance information from this extension and includes
+them into the `postgresql/dbs/DBNAME/edb_wait_states/` folder.
+
+The `edb_wait_states` extension requires defining a sampling range for
+retrieving data, so Lasso exposes 2 arguments for defining the sampling
+range: `--sampling-start` and `--sampling-end`, for example:
+
+```
+    lasso --sampling-start "2024-02-06 13:30:00+0000" --sampling-end "2024-02-06 14:00:00+0000"
+```
+
+In this case the timestamps are in UTC. It's possible to specify a different timezone, for example:
+
+```
+    lasso --sampling-start "2024-02-06 10:30:00-0300" --sampling-end "2024-02-06 11:00:00-0300"
+```
+
+These arguments are ignored if the `edb_wait_states` extension is not
+installed.
+
+If the `edb_wait_states` extension is installed and these arguments are
+omitted, then Lasso considers `--sampling-start` as 1 hour from now and
+`--sampling-end` as now.
+
+For more details about the `edb_wait_states` extension, please check the
+[documentation](https://www.enterprisedb.com/docs/pg_extensions/wait_states/).