diff --git a/product_docs/docs/lasso/4/configuration.mdx b/product_docs/docs/lasso/4/configuration.mdx index 2e2981624c0..5bcb4be31ab 100644 --- a/product_docs/docs/lasso/4/configuration.mdx +++ b/product_docs/docs/lasso/4/configuration.mdx @@ -15,6 +15,13 @@ order, and uses the first match: 3. `$HOME/.edb-lasso.conf` 4. `/etc/edb-lasso.conf` +Alternatively, you can run Lasso with the `--config-file` option to +specify a configuration file not in the list above, for example: + +``` +lasso --config-file /path/to/file.conf +``` + A template file for the configuration file looks like this: ``` @@ -83,6 +90,7 @@ A template file for the configuration file looks like this: [harp] ; path to config.yml, if using a non-default one ; configuration= + ; proxy_configuration= [pgd-proxy] ; path to pgd-proxy-config.yml, if using a non-default one diff --git a/product_docs/docs/lasso/4/describe.mdx b/product_docs/docs/lasso/4/describe.mdx index 113979f8bf6..9fe30741864 100644 --- a/product_docs/docs/lasso/4/describe.mdx +++ b/product_docs/docs/lasso/4/describe.mdx @@ -257,6 +257,19 @@ Hardware info through `lspci`. **Security impact:** Low — No known security impact. +### /etc/hosts configuration (`linux_hosts_configuration`) + +Hosts configuration in `/etc/hosts`. + +**Report output:** + + * File `/linux/hosts.data`: Contents of `/etc/hosts` + +**Depth:** Surface + +**Security impact:** Low — +No known security impact. + ### HTTP(s) proxies in use for package downloads (`linux_http_proxy_configuration`) Gathers information about HTTP(s) proxies in use for package @@ -1235,6 +1248,19 @@ EDB Postgres Advanced Server resource group names and limits. **Security impact:** Low — No known security impact. +### Current pg_hba_file_rules contents (`postgresql_hba_file_rules`) + +Summary of client authentication file contents. + +**Report output:** + + * File `postgresql/pg_hba_file_rules.out` + +**Depth:** Surface + +**Security impact:** Low — +No known security impact. + ### postgresql_logdirfiles (`postgresql_logdirfiles`) Log file names in PostgreSQL log directory. @@ -1486,6 +1512,19 @@ Replication connections (from `pg_stat_replication`). **Security impact:** Low — No known security impact. +### Simple LRU (least recently used) cache statistics (`postgresql_stat_slru`) + +Stats from `pg_stat_slru`. + +**Report output:** + + * File `postgresql/pg_stat_slru.out` + +**Depth:** Surface + +**Security Impact:** Low — +No known security impact. + ### Server subscription statistics (`postgresql_subscription_statistics`) Statistics of subscriptions. @@ -1929,6 +1968,20 @@ Information about partitioned tables (using declarative partitioning). **Security impact:** Low — No known security impact. +### Database child partition tables (`postgresql_db_partitions`) + +Information about child partition tables (using declarative +partitioning). + +**Report output:** + + * File `partitions.out` + +**Depth:** Shallow + +**Security Impact:** Low — +No known security impact. + ### Database PEM pem.agent table tuples (`postgresql_db_pem_agent`) Data from metatable `pem.agent`. @@ -2293,6 +2346,33 @@ List of tables in the database. **Security impact:** Low — No known security impact. +### Tables close to wraparound (`postgresql_db_tables_wraparound`) + +Collect the list of worst offender tables in terms of transaction +wraparound. + +**Report output:** + + * File `tables_wraparound.out` + +**Depth:** Shallow + +**Security impact:** Low* — +No known security impact. + +### Database triggers (`postgresql_db_triggers`) + +Triggers in the database. + +**Report output:** + + * File `triggers.out` + +**Depth:** Shallow + +**Security Impact:** Low — +No known security impact. + ### Database types (`postgresql_db_types`) Types in the database. @@ -2717,6 +2797,20 @@ List blocking locks. **Security Impact:** Low — No known security impact. +### Current checkpointer stats (`postgresql_checkpointer`) + +Statistics about the checkpointer process's activity (from +`pg_stat_checkpointer`). + +**Report output:** + + * File `postgresql/checkpointer.out` + +**Depth:** Surface + +**Security impact:** Low — +No known security impact. + ### BDR worker_errors (`postgresql_db_bdr_worker_errors`) List all `bdr.worker_errors` entries in `error_time ASC` order. diff --git a/product_docs/docs/lasso/4/install.mdx b/product_docs/docs/lasso/4/install.mdx index 33e1e2f17c4..65087f1c8d2 100644 --- a/product_docs/docs/lasso/4/install.mdx +++ b/product_docs/docs/lasso/4/install.mdx @@ -91,6 +91,13 @@ options. (It uses the first match.) - `$HOME/.edb-lasso.conf` - `/etc/edb-lasso.conf` +Alternatively, you can run Lasso with the `--config-file` option to +specify a configuration file not in the list above, for example: + +``` +lasso --config-file /path/to/file.conf +``` + The minimum configuration file looks like this: ``` diff --git a/product_docs/docs/lasso/4/release-notes.mdx b/product_docs/docs/lasso/4/release-notes.mdx index 02324dea230..f3e6790591e 100644 --- a/product_docs/docs/lasso/4/release-notes.mdx +++ b/product_docs/docs/lasso/4/release-notes.mdx @@ -2,6 +2,30 @@ title: Release notes --- + +## Lasso - Version 4.18.0 + +Released: 24 Jan 2025 + +Lasso Version 4.18.0 includes the following enhancements and bug fixes: + +| Type | Description | Addresses | +|------------------------|-------------|-----------| +| Feature | Support for PostgreSQL 17 | DC-1037 | +| Feature | New `--config-file` option for the Lasso configuration file in non-default path | DC-1026 | +| Feature | Collect the list of worst offender tables in terms of transaction wraparound | DC-220 | +| Feature | Collect information about child partition tables | DC-469 | +| Feature | Collect information about triggers | DC-440 | +| Feature | Collect summary of client authentication file contents (`pg_hba_file_rules`) | DC-125 | +| Feature | Collect statistics about the checkpointer process (new PG17+ view `pg_stat_checkpointer`) | DC-1030 | +| Feature | Collect the Simple LRU (least recently used) cache statistics (`pg_stat_slru`) | DC=144 | +| Feature | Collect the contents of the `/etc/hosts` file | DC-1028 | +| Improvement | Enforce UTC timezone and ISO datestyle in query outputs | DC-6 | +| Bug Fixes | Fix log path collector erroring out with `No such file or directory: /proc//fd/1` | DC-1041 | +| Bug Fixes | Fix Lasso not gathering the `efm cluster-status` when using `--efm-configuration` to a non-default EFM configuration file path | DC-1027 | +| Deprecation Notes | Dropped support for CentOS 7, SLES 12, Debian 10 and PostgreSQL 12 | DC-1037 | + + ## Lasso - Version 4.17.0 Released: 12 Sep 2024 diff --git a/product_docs/docs/lasso/4/usage.mdx b/product_docs/docs/lasso/4/usage.mdx index 69445a01b06..d53929152b5 100644 --- a/product_docs/docs/lasso/4/usage.mdx +++ b/product_docs/docs/lasso/4/usage.mdx @@ -11,7 +11,8 @@ You can also pass the connection parameters, among other options, as command line arguments: ``` -usage: lasso [-h] [-H HOST_NAME] [-p PORT] [--password PASSWORD] +usage: lasso [-h] [--config-file CONFIG_FILE] + [-H HOST_NAME] [-p PORT] [--password PASSWORD] [--lock-timeout LOCK_TIMEOUT] [--statement-timeout STATEMENT_TIMEOUT] [--sampling-start SAMPLING_START] [--sampling-end SAMPLING_END] @@ -28,6 +29,7 @@ usage: lasso [-h] [-H HOST_NAME] [-p PORT] [--password PASSWORD] [--xdb-subserver-configuration XDB_SUBSERVER_CONFIGURATION] [--pgbouncer-configuration PGBOUNCER_CONFIGURATION] [--harp-configuration HARP_CONFIGURATION] + [--harp-proxy-configuration HARP_PROXY_CONFIGURATION] [--etcd-configuration ETCD_CONFIGURATION] [--pgd-proxy-configuration PGD_PROXY_CONFIGURATION] [--patroni-configuration PATRONI_CONFIGURATION] @@ -42,6 +44,8 @@ positional arguments: optional arguments: -h, --help show this help message and exit + --config-file CONFIG_FILE + Path to Lasso configuration file, if using non-default path. -H HOST_NAME, --host-name HOST_NAME Database host name or socket directory (default local socket) @@ -101,6 +105,8 @@ optional arguments: --harp-configuration HARP_CONFIGURATION Path to the config.yml file, if using a non-default path + --harp-proxy-configuration HARP_PROXY_CONFIGURATION + Path to the config.yml or proxy-config.yml file for HARP Proxy, if using a non-default path --etcd-configuration ETCD_CONFIGURATION Path to the etcd.conf file, if using a non-default path