Merge pull request #62179 from apinnick/CNV-30692-vmcrcerrors-runbook

CNV- 30692: new runbook

Author: apinnick

modules/virt-runbook-virtualmachinecrcerrors.adoc

@@ -0,0 +1,79 @@
+// Do not edit this module. It is generated with a script.
+// Do not reuse this module. The anchor IDs do not contain a context statement.
+// Module included in the following assemblies:
+//
+// * virt/monitoring/virt-runbooks.adoc
+
+:_content-type: REFERENCE
+[id="virt-runbook-VirtualMachineCRCErrors"]
+= VirtualMachineCRCErrors
+
+[discrete]
+[id="meaning-virtualmachinecrcerrors"]
+== Meaning
+
+This alert fires when the storage class is incorrectly configured.
+A system-wide, shared dummy page causes CRC errors when data is
+written and read across different processes or threads.
+
+[discrete]
+[id="impact-virtualmachinecrcerrors"]
+== Impact
+
+A large number of CRC errors might cause the cluster to display
+severe performance degradation.
+
+[discrete]
+[id="diagnosis-virtualmachinecrcerrors"]
+== Diagnosis
+
+. Get the volume name from a virtual machine:
++
+[source,terminal]
+----
+$ oc get vm <vm_name> -o jsonpath='{.spec.template.spec.volumes}'
+----
+
+. Get the storage class name from the volume:
++
+[source,terminal]
+----
+$ oc get pvc <volume> -o jsonpath='{.spec.storageClassName}'
+----
+
+. Get the storage class configuration:
++
+[source,terminal]
+----
+$ oc get sc <storage_class> -o yaml
+----
+
+. Check the storage class configuration for the `krbd:rxbounce` map option.
+
+[discrete]
+[id="mitigation-virtualmachinecrcerrors"]
+== Mitigation
+
+Add the `krbd:rxbounce` map option to the storage class configuration:
+
+[source,terminal]
+----
+apiVersion: storage.k8s.io/v1
+kind: StorageClass
+metadata:
+  name: example-storage-class
+parameters:
+  # ...
+  mounter: rbd
+  mapOptions: "krbd:rxbounce"
+provisioner: openshift-storage.rbd.csi.ceph.com
+# ...
+----
+
+The `krbd:rxbounce` option creates a bounce buffer to receive data. The default
+behavior is for the destination buffer to receive data directly. A bounce buffer
+is required if the destination buffer is unstable.
+
+If you cannot resolve the issue, log in to the
+link:https://access.redhat.com[Customer Portal] and open a support case,
+attaching the artifacts gathered during the diagnosis procedure.

virt/monitoring/virt-runbooks.adoc

@@ -109,5 +109,6 @@ include::modules/virt-runbook-virtoperatorresterrorsburst.adoc[leveloffset=+1]
 
 include::modules/virt-runbook-virtoperatorresterrorshigh.adoc[leveloffset=+1]
 
-include::modules/virt-runbook-vmcannotbeevicted.adoc[leveloffset=+1]
+include::modules/virt-runbook-virtualmachinecrcerrors.adoc[leveloffset=+1]
 
+include::modules/virt-runbook-vmcannotbeevicted.adoc[leveloffset=+1]