PSQLADM-566 - Release notes for ProxySQL - PSQLADM 3.0.1

docs/3.0.1.md

@@ -0,0 +1,38 @@
+# Percona build of ProxySQL 3.0.1 and ProxySQL admin tools (2025-06-12)
+
+--8<--- "rn-block-top.md"
+
+
+
+## Release highlights
+
+This release introduces the Percona build of ProxySQL 3.0.1, incorporating the latest upstream features and improvements. This version includes all enhancements and bug fixes from upstream [ProxySQL 3.0.1].
+
+* Dual-password support: Enables use of two passwords for seamless rotation.  
+
+* Enhanced logging (from v2.7.2): Real-time query/event logging using a circular buffer and SQLite. View logs in `stats_mysql_query_events`, `history_mysql_query_events`, and Prometheus.  
+
+* Prepared statement logging (#4895, #4922): Logs actual parameter values. Supports binary and JSON. Controlled by `mysql-eventslog_stmt_parameters` (disabled by default).  
+
+* New event: `PROXYSQL_METADATA` (#4922): Logged when a new binary log file is created. Includes version metadata.  
+
+* DNS cache improvements (#4745): Spreads out resolution attempts to avoid bursts and queue congestion.
+
+!!! note
+
+    [ProxySQL 3.0.1 contains a PostgreSQL module in beta.](https://github.com/sysown/proxysql/releases) The Percona build of ProxySQL is only tested with Percona Server for MySQL.
+
+## No changes
+
+The [ProxySQL Admin tool](proxysql-admin-tool-v2-config.md) and the [pxc_scheduler_handler tool](psh-overview.md) within Percona's Build of ProxySQL 3.0.1 have not been updated and are the same as in the previous Percona release.
+
+## Known issues
+
+--8<--- "note-8.4.md"
+
+## Additional resources
+--8<--- "rn-ar.md"
+
+
+
+[ProxySQL 3.0.1]: https://github.com/sysown/proxysql/releases/tag/v3.0.1

docs/release-notes.md

@@ -1,5 +1,7 @@
 # ProxySQL, ProxySQL-admin, and percona-scheduler-admin release notes index
 
+[ProxySQL 3.0.1 and ProxySQL admin tools (2025-06-12)](3.0.1.md)
+
 [ProxySQL 2.7.3 and ProxySQL admin tools (2025-04-21)](2.7.3.md)
 
 [ProxySQL 2.7.1-1 and ProxySQL admin tools (2024-11-20)](2.7.1-1.md)

mkdocs-base.yml

@@ -147,6 +147,8 @@ nav:
   - get-help.md
   - Release notes:
       - Release notes index: release-notes.md
+
+      - 3.0.1.md
       - 2.7.3.md
       - 2.7.1-1.md
       - 2.7.1.md

snippets/rn-block-top.md

@@ -6,6 +6,6 @@
 
 You can [download the original ProxySQL from GitHub](https://github.com/sysown/proxysql/releases). The [ProxySQL documentation](https://proxysql.com/documentation/) provides information on installing and running ProxySQL.
 
-The [ProxySQL Admin (proxysql-admin)](proxysql-admin-tool-v2-config.md) tool simplifies the configuration of Percona XtraDB Cluster nodes with ProxySQL.  [ProxySQL Admin 2](proxysql-admin-tool-functions.md) supports Percona XtraDB Cluster without custom scripts.
+The [ProxySQL Admin (proxysql-admin)](proxysql-admin-tool-v2-config.md) tool simplifies the configuration of Percona XtraDB Cluster nodes with ProxySQL.  [ProxySQL Admin](proxysql-admin-tool-functions.md) supports Percona XtraDB Cluster without custom scripts.
 
 The [pxc_scheduler_handler](psh-overview.md) tool can automatically perform a failover due to node failures, service degradation, or maintenance. This tool has features and capabilities that differ from the ProxySQL admin tool, so you should not use options from one tool in the other, as that may cause unintended results.

variables.yml

@@ -1,6 +1,6 @@
 # variables for HTML output
 
-release: "2.7.3"
-version: "2.x.x"
-release_date: "April , 2025"
-title_date: "2025-04-"
+release: "3.0.1"
+version: "3.x"
+release_date: "June 12, 2025"
+title_date: "2025-06-"