Skip to content

docs: Document InnoDBStalledPrimary VTOrc analysis code #2124

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
promptless wants to merge 2 commits into
base: prod
Choose a base branch
from
+1 −0
Draft

docs: Document InnoDBStalledPrimary VTOrc analysis code #2124

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f32a7e2
Add InnoDBStalledPrimary to VTOrc recovery table
promptless[bot] May 23, 2026
480639b
Merge branch 'prod' into promptless/vtorc-innodb-stalled-primary
promptless[bot] May 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions content/en/docs/25.0/user-guides/configuration-basic/vtorc.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ It detects any configuration problems in the cluster and fixes them. Here is the
| `ClusterHasNoPrimary` | VTOrc detects when a shard doesn't have any primary tablet elected | VTOrc runs PlannedReparentShard to elect a new primary |
| `DeadPrimary` | VTOrc detects when the primary tablet is dead | VTOrc runs EmergencyReparentShard to elect a different primary |
| `IncapacitatedPrimary` | VTOrc detects when the primary tablet is consistently failing health checks but is still network-reachable | VTOrc runs PlannedReparentShard, falling back to EmergencyReparentShard if that fails |
| `InnoDBStalledPrimary` | VTOrc detects when the primary's MySQL is stalled on an InnoDB semaphore wait (mysqld is alive but writes are not committing). Requires MySQL 8.0+ and SELECT privilege on `performance_schema.error_log` for the `dba` user. | VTOrc runs EmergencyReparentShard to elect a different primary |
Copy link
Copy Markdown
Contributor Author

@promptless promptless Bot May 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added InnoDBStalledPrimary recovery action based on PR #20169 which implements the InnoDBStalledPrimary analysis code, the HasRecentInnoDBLongSemaphoreWait function in go/vt/mysqlctl/replication.go, and the recovery wiring in go/vt/vtorc/logic/topology_recovery.go.

Source: vitessio/vitess#20169

| `PrimaryIsReadOnly`, `PrimarySemiSyncMustBeSet`, `PrimarySemiSyncMustNotBeSet` | VTOrc detects when the primary tablet has configuration issues like being read-only, semi-sync being set or not being set | VTOrc fixes the configurations on the primary. |
| `NotConnectedToPrimary`, `ConnectedToWrongPrimary`, `ReplicationStopped`, `ReplicaIsWritable`, `ReplicaSemiSyncMustBeSet`, `ReplicaSemiSyncMustNotBeSet` | VTOrc detects when a replica has configuration issues like not being connected to the primary, connected to the wrong primary, replication stopped, replica being writable, semi-sync being set or not being set | VTOrc fixes the configurations on the replica. |
| `StaleTopoPrimary` | VTOrc detects when a tablet still has type PRIMARY in the topology but a newer primary has already been elected. This can happen if a topology update fails during an emergency reparent operation. | VTOrc demotes the stale primary to a read-only replica, updates its type to REPLICA in the topology, and configures it to replicate from the current primary. |
Expand Down