Skip to content

Commit 427e5c7

Browse files
authored
Merge pull request #547 from percona/ps-10091
PS-10091 [DOCS] - Add links to troubleshooting 8.4
2 parents 6224cf4 + 66c00d2 commit 427e5c7

File tree

6 files changed

+97
-32
lines changed

6 files changed

+97
-32
lines changed

docs/advisors.md

Lines changed: 14 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,20 @@
11
# Use Percona Monitoring and Management (PMM) Advisors
22

3-
[Percona Monitoring and Management (PMM)](https://www.percona.com/software/database-tools/percona-monitoring-and-management) provides several categories of Advisors. Each Advisor contains a set of automated checks. These checks investigate your database settings for a specific range of possible issues.
3+
[Percona Monitoring and Management (PMM)](https://www.percona.com/software/database-
4+
tools/percona-monitoring-and-management) provides several categories of Advisors.
5+
Each Advisor contains a set of automated checks. These checks investigate your
6+
database settings for a specific range of possible issues.
47

5-
[The Percona Platform](https://www.percona.com/software/percona-platform) hosts the Advisors.
8+
The PMM Server automatically downloads the Advisors if the `Advisors` and
9+
`Telemetry` options are enabled in `Configuration > Settings > Advanced Settings`.
10+
Both options are enabled by default.
611

7-
The PMM Server automatically downloads the Advisors if the `Advisors` and `Telemetry` options are enabled in `Configuration > Settings > Advanced Settings`. Both options are enabled by default.
12+
!!! note "Need Additional Guidance?"
13+
If you encounter complex advisor recommendations or require expert
14+
interpretation, [Percona Support](https://www.percona.com/services/support)
15+
offers professional assistance to help you optimize your database
16+
configuration and resolve any identified issues.
817

918
!!! admonition "See also"
10-
11-
[PMM documentation - Advisor checks](https://docs.percona.com/percona-platform/advisors.html)
19+
[PMM documentation - Advisor checks](https://docs.percona.com/percona-platform/
20+
advisors.html)

docs/innodb-corrupt-table-action.md

Lines changed: 30 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,33 @@
11
# Handle corrupted tables
22

33
When a server subsystem tries to access a corrupted table,
4-
the server may crash.
5-
If this outcome is not desirable when a corrupted table is encountered,
6-
set the new system innodb_corrupt_table_action variable
7-
to a value which allows the ongoing operation to continue
4+
the server may crash. If this outcome is not desirable when a corrupted
5+
table is encountered, set the new system innodb_corrupt_table_action
6+
variable to a value which allows the ongoing operation to continue
87
without crashing the server.
98

109
The server error log registers attempts to access corrupted table pages.
1110

1211
### Interacting with the innodb_force_recovery variable
1312

14-
The innodb_corrupt_table_action variable
15-
may work in conjunction with the innodb_force_recovery variable
16-
which considerably reduces
17-
the effect of *InnoDB* subsystems
18-
running in the background.
13+
The innodb_corrupt_table_action variable may work in conjunction with
14+
the innodb_force_recovery variable which considerably reduces the effect
15+
of *InnoDB* subsystems running in the background.
1916

20-
If the innodb_force_recovery option is <4, corrupted pages are lost and the server may continue to run due to the innodb_corrupt_table_action variable having a non-default value.
17+
If the innodb_force_recovery option is <4, corrupted pages are lost and
18+
the server may continue to run due to the innodb_corrupt_table_action
19+
variable having a non-default value.
2120

22-
For more information about the innodb_force_recovery variable, see [Forcing InnoDB Recovery] from the MySQL Reference Manual.
21+
!!! warning "Complex Database Recovery Scenarios"
22+
Navigating table corruption and recovery can be challenging.
23+
[Percona Support](https://www.percona.com/services/support) offers
24+
expert guidance for complex database recovery and optimization
25+
strategies.
2326

24-
This feature adds a system variable.
27+
For more information about the innodb_force_recovery variable, see
28+
[Forcing InnoDB Recovery] from the MySQL Reference Manual.
2529

30+
This feature adds a system variable.
2631

2732
## System variables
2833

@@ -38,10 +43,19 @@ This feature adds a system variable.
3843
| Default | assert |
3944
| Range | assert, warn, salvage |
4045

41-
* Enabling `innodb_file_per_table` and using the `assert` value creates an assertion failure which causes *XtraDB* to intentionally crash the server. This action is expected when detecting corrupted data in a single-table tablespace.
46+
* Enabling `innodb_file_per_table` and using the `assert` value creates
47+
an assertion failure which causes *XtraDB* to intentionally crash the
48+
server. This action is expected when detecting corrupted data in a
49+
single-table tablespace.
4250

43-
* Enabling `innodb_file_per_table` and using the `warn` value causes *XtraDB* to pass the table corruption as `corrupt table` instead of crashing the server. Detecting the file as corrupt also disables the file I/O for that data file, except for the deletion operation.
51+
* Enabling `innodb_file_per_table` and using the `warn` value causes
52+
*XtraDB* to pass the table corruption as `corrupt table` instead of
53+
crashing the server. Detecting the file as corrupt also disables the
54+
file I/O for that data file, except for the deletion operation.
4455

45-
* Enabling `innodb_file_per_table` and using the `salvage` value causes *XtraDB* to allow read access to the corrupted tablespace but ignores any corrupted pages.
56+
* Enabling `innodb_file_per_table` and using the `salvage` value causes
57+
*XtraDB* to allow read access to the corrupted tablespace but ignores
58+
any corrupted pages.
4659

47-
[Forcing InnoDB Recovery]: https://dev.mysql.com/doc/refman/{{vers}}/en/forcing-innodb-recovery.html
60+
[Forcing InnoDB Recovery]: https://dev.mysql.com/doc/refman/{{vers}}/en/
61+
forcing-innodb-recovery.html

docs/libcoredumper.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,11 @@ A core dump file is the documented moment of a computer when either the computer
66
The `libcoredumper` is a free and Open Source fork of `google-coredumper`,
77
enhanced to work on newer Linux versions, and GCC and CLANG.
88

9+
!!! tip "Need Help Interpreting Stack Traces?"
10+
[Percona Support](https://www.percona.com/services/support) offers
11+
expert debugging and performance analysis to help you understand
12+
complex stack trace diagnostics.
13+
914
### Enabling the `libcoredumper`
1015

1116
Enable core dumps for troubleshooting purposes.

docs/log-connection-error.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,14 @@
11
# Too many connections warning
22

3-
If the [log_error_verbosity] system variable is set to `2` or higher, this feature generates the `Too many connections` warning in the log.
3+
If the [log_error_verbosity] system variable is set to `2` or higher, this
4+
feature generates the `Too many connections` warning in the log.
5+
6+
!!! tip "Troubleshooting Connection Issues"
7+
For comprehensive guidance on managing database connections and
8+
performance, [Percona Support](https://www.percona.com/services/support)
9+
can provide expert assistance in diagnosing and resolving connection
10+
management challenges.
11+
12+
[log_error_verbosity]: https://dev.mysql.com/doc/refman/{{vers}}/en/server-system-
13+
variables.html#sysvar_log_error_verbosity
414

5-
[log_error_verbosity]: https://dev.mysql.com/doc/refman/{{vers}}/en/server-system-variables.html#sysvar_log_error_verbosity

docs/stacktrace.md

Lines changed: 19 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,24 @@
1-
<!-- stacktrace: -->
21
# Stack trace
32

4-
Developers use the stack trace in the debug process, either an interactive investigation or during the post-mortem. No configuration is required to generate a stack trace.
3+
Developers use the stack trace in the debug process, either an interactive
4+
investigation or during the post-mortem. No configuration is required to
5+
generate a stack trace.
56

67
Stack trace adds the following:
78

8-
| Name | Description |
9-
|--------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
10-
| Prints binary BuildID | The Strip utility removes unneeded sections and debugging information to reduce the size. This method is standard with containers where the size of the image is essential. The BuildID lets you resolve the stack trace when the Strip utility removes the binary symbols table. |
11-
| Print the server version information | The version information establishes the starting point for analysis. Some applications, such as MySQL, only print this information to a log on startup, and when the crash occurs, the size of the log may be large, rotated, or truncated. |
9+
| Name | Description |
10+
|--------------------------------------|------------------------------------------------------------------|
11+
| Prints binary BuildID | The Strip utility removes unneeded sections and debugging |
12+
| | information to reduce the size. This method is standard with |
13+
| | containers where the image size is essential. The BuildID lets |
14+
| | you resolve the stack trace when the Strip utility removes the |
15+
| | binary symbols table. |
16+
| Print the server version information | The version information establishes the starting point for |
17+
| | analysis. Some applications, such as MySQL, only print this |
18+
| | information to a log on startup, and when the crash occurs, the |
19+
| | log may be large, rotated, or truncated. |
20+
21+
!!! tip "Need Help Interpreting Stack Traces?"
22+
[Percona Support](https://www.percona.com/services/support) offers
23+
expert debugging and performance analysis to help you understand
24+
complex stack trace diagnostics.

docs/thread-based-profiling.md

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,22 @@
11
# Thread based profiling
22

3-
Percona Server for MySQL now uses thread based profiling by default, instead of process based profiling. This was implemented because with process based profiling, threads on the server, other than the one being profiled, can affect the profiling information.
3+
Percona Server for MySQL now uses thread based profiling by default,
4+
instead of process based profiling. This was implemented because with
5+
process based profiling, threads on the server, other than the one being
6+
profiled, can affect the profiling information.
47

5-
Thread based profiling is using the information provided by the kernel [getrusage](https://kernel.org/doc/man-pages/online/pages/man2/getrusage.2.html) function. Since the 2.6.26 kernel version, thread based resource usage is available with the **RUSAGE_THREAD**. This means that the thread based profiling will be used if you’re running the 2.6.26 kernel or newer, or if the **RUSAGE_THREAD** has been ported back.
8+
Thread based profiling is using the information provided by the kernel
9+
[getrusage](https://kernel.org/doc/man-pages/online/pages/man2/getrusage.2.html)
10+
function. Since the 2.6.26 kernel version, thread based resource usage
11+
is available with the **RUSAGE_THREAD**. This means that the thread based
12+
profiling will be used if you're running the 2.6.26 kernel or newer, or
13+
if the **RUSAGE_THREAD** has been ported back.
14+
15+
This feature is enabled by default if your system supports it, in other
16+
cases it uses process based profiling.
17+
18+
!!! note "Performance Profiling Challenges?"
19+
For advanced performance tuning and profiling strategies,
20+
[Percona Support](https://www.percona.com/services/support) provides
21+
expert consultation to optimize your database performance.
622

7-
This feature is enabled by default if your system supports it, in other cases it uses process based profiling.

0 commit comments

Comments
 (0)