percona · patrickbirch · May 1, 2025
diff --git a/docs/index-contents.md b/docs/index-contents.md
@@ -19,13 +19,16 @@
   - [Binary logs and replication improvements](binlogging-replication-improvements.md)
   - [Binary tarball file names available based on the Percona Server for MySQL version](binary-tarball-names.md)
   - [Build APT packages](build-apt-packages.md)
+  - [Build from RPM packages](build-rpm-packages.md)
+  - [Clone plugin limitations](clone-plugin-limitations.md)
+  - [Clone plugin overview](clone-plugin-overview.md)
   - [Compare keyring components and keyring plugins](components-keyrings-comparison.md)
   - [Compare the data masking component to the data masking plugin](data-masking-comparison.md)
   - [Compile Percona Server for MySQL 8.0 from source](compile-percona-server.md)
   - [Compressed columns with dictionaries](compressed-columns.md)
   - [Copyright and licensing information](copyright-and-licensing-information.md)
   - [Data at Rest Encryption](data-at-rest-encryption.md)
-  - [Data masking component functions](data-masking-function-list.md)
+  - [Data masking component functions and variables](data-masking-function-list.md)
   - [Data masking overview](data-masking-overview.md)
   - [Data masking plugin functions](data-masking-plugin-functions.md)
   - [Deprecated in MySQL 8.0](upgrade-changes-deprecated.md)
@@ -43,7 +46,7 @@
   - [Encrypt temporary files](encrypting-temporary-files.md)
   - [Encrypt the undo tablespace](encrypting-undo-tablespace.md)
   - [Encrypting the Redo Log data](encrypting-redo-log.md)
-  - [Encryption functions](encryption-functions.md)
+  - [Encryption user-defined functions](encryption-functions.md)
   - [Enforcing storage engine](enforce-engine.md)
   - [Expanded fast index creation](innodb-expanded-fast-index-creation.md)
   - [Extended mysqlbinlog](extended-mysqlbinlog.md)
@@ -95,6 +98,7 @@
   - [Limiting the disk space used by binary log files](binlog-space.md)
   - [List of features available in Percona Server for MySQL releases](ps-versions-comparison.md)
   - [List of variables introduced in Percona Server for MySQL 8.0](ps-variables.md)
+  - [Load the Clone plugin](load-clone-plugin.md)
   - [Manage group replication flow control](group-replication-flow-control.md)
   - [Manage the Audit Log Filter files](manage-audit-log-filter.md)
   - [Migrate and remove the TokuDB storage engine](removing-tokudb.md)
@@ -133,8 +137,8 @@
   - [Rotate the master key](rotating-master-key.md)
   - [Run Percona Server for MySQL](yum-run.md)
   - [Run Percona Server for MySQL 8.0 after APT repository installation](apt-run.md)
-  - [Run Percona Server for MySQL in a Docker Container](docker.md)
   - [Run Percona Server for MySQL in a Docker container](quickstart-docker.md)
+  - [Run Percona Server for MySQL in a Docker Container](docker.md)
   - [The secure_log_path variable](secure-log-path-variable.md)
   - [Security & account management changes in MySQL 8.0](upgrade-changes-secure.md)
   - [SEQUENCE_TABLE(n) function](sequence-table.md)
@@ -160,8 +164,7 @@
   - [TokuDB status variables](tokudb-status-variables.md)
   - [TokuDB troubleshooting](tokudb-troubleshooting.md)
   - [TokuDB variables](tokudb-variables.md)
-  - [Too many connections warning](log-connection-error.md)
-  - [Topic index](topic-index.md)
+  - [Too Many Connections warning in the MySQL Error Log](too-many-connections-mysql-warning.md.md)
   - [Trademark policy](trademark-policy.md)
   - [Trigger updates](trigger-updates.md)
   - [Understand version numbers](server-version-numbers.md)
@@ -179,9 +182,11 @@
   - [Upgrade using Standalone Packages](upgrade-standalone-packages.md)
   - [Upgrade using the Percona repositories](upgrade-percona-repos.md)
   - [Use an APT repository to install Percona Server for MySQL 8.0](apt-repo.md)
+  - [Use Docker Compose and named volumes](docker-compose.md)
   - [Use Percona Monitoring and Management (PMM) Advisors](advisors.md)
   - [Use percona-release](percona-release.md)
   - [Use the Amazon Key Management Service (AWS KMS)](using-amz-kms.md)
+  - [Use the Clone plugin](clone-plugin-usage.md)
   - [Use the keyring component or keyring plugin](using-keyring-plugin.md)
   - [Use TokuDB](using-tokudb.md)
   - [User statistics](user-stats.md)

diff --git a/docs/log-connection-error.md b/docs/log-connection-error.md
diff --git a/docs/too-many-connections-mysql-warning.md.md b/docs/too-many-connections-mysql-warning.md.md
@@ -0,0 +1,19 @@
+# Too Many Connections warning in the MySQL Error Log
+
+When the [log_error_verbosity](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_log_error_verbosity) system variable is set to `2` or higher, the server generates a `Too many connections` warning in the error log.
+
+## Benefits
+
+This warning provides the following benefits:
+
+| Benefit | Description |
+| --- | --- |
+| Monitoring server load | The "Too many connections" warning provides a clear indication that the database server is experiencing a high volume of incoming connections, which can be a sign of increased server load or potential performance issues. |
+| Proactive troubleshooting | By monitoring the error log for this warning, developers and DBAs can quickly identify when the server is reaching its connection limit and take appropriate actions, such as scaling up resources or optimizing connection management. |
+| Capacity planning | The frequency and patterns of "Too many connections" warnings can help database server teams plan for future infrastructure needs, ensuring that the server can handle the expected workload without performance degradation. |
+| Identifying connection leaks | Persistent "Too many connections" warnings may indicate a problem with connection management, such as connections not being properly closed or released. This can help identify and address potential connection leaks. |
+| Compliance and auditing | The error log, including the "Too many connections" warnings, can be valuable for compliance and auditing purposes, providing a record of server behavior and potential issues. |
+
+## Version specific information
+
+In version 8.0.12-1, the "Too many connections" warning feature was ported from Percona Server for MySQL 5.7.
diff --git a/mkdocs-base.yml b/mkdocs-base.yml
@@ -376,7 +376,7 @@ nav:
       - advisors.md
       - innodb-corrupt-table-action.md
       - libcoredumper.md
-      - log-connection-error.md
+      - too-many-connections-mysql-warning.md.md
       - stacktrace.md
       - thread-based-profiling.md
   - Storage engines: