ceffede5b1
Distribute README.VDDK in nbdkit-vddk-plugin subpackage resolves: rhbz#2018463, rhbz#2011709
85 lines
2.6 KiB
Diff
85 lines
2.6 KiB
Diff
From e5fc041defb7cb0e275ed5949bbf7406af70043c Mon Sep 17 00:00:00 2001
|
|
From: "Richard W.M. Jones" <rjones@redhat.com>
|
|
Date: Fri, 22 Oct 2021 18:00:27 +0100
|
|
Subject: [PATCH] vddk: Document troubleshooting performance problems
|
|
|
|
Document how to use -D vddk.stats=1 to diagnose performance problems
|
|
with VDDK.
|
|
|
|
(cherry picked from commit e491978c193f49010cc28ad344d0fb3c1b5ede35)
|
|
---
|
|
plugins/vddk/nbdkit-vddk-plugin.pod | 57 +++++++++++++++++++++++++++++
|
|
1 file changed, 57 insertions(+)
|
|
|
|
diff --git a/plugins/vddk/nbdkit-vddk-plugin.pod b/plugins/vddk/nbdkit-vddk-plugin.pod
|
|
index e53d3286..5a426135 100644
|
|
--- a/plugins/vddk/nbdkit-vddk-plugin.pod
|
|
+++ b/plugins/vddk/nbdkit-vddk-plugin.pod
|
|
@@ -475,6 +475,63 @@ and restarting the C<hostd> service:
|
|
|
|
For more information see L<https://bugzilla.redhat.com/1614276>.
|
|
|
|
+=head2 Troubleshooting performance problems
|
|
+
|
|
+VDDK has very uneven performance with some operations being very slow.
|
|
+This plugin has options to allow you to debug performance issues. If
|
|
+your application has a debug or diagnostic setting, add the following
|
|
+nbdkit command line options:
|
|
+
|
|
+ -v -D nbdkit.backend.datapath=0 -D vddk.datapath=0 -D vddk.stats=1
|
|
+
|
|
+C<-v> enables verbose messages and the two datapath options I<disable>
|
|
+the very verbose per-read/-write messages. C<-D vddk.stats=1> enables
|
|
+a summary when nbdkit exits of the cumulative time taken in each VDDK
|
|
+function, the number of times each function was called, and (for read
|
|
+and write) the number of bytes transferred. An example of what those
|
|
+stats look like can be found here:
|
|
+L<https://gitlab.com/nbdkit/nbdkit/-/commit/5c80f0d290db45a679d55baf37ff39bacb8ce7ec>
|
|
+
|
|
+You can interpret the stats as follows:
|
|
+
|
|
+=over 4
|
|
+
|
|
+=item C<Read>
|
|
+
|
|
+The cumulative time spent waiting for VDDK to return from
|
|
+C<VixDiskLib_Read> calls, the number of times this function was
|
|
+called, and the total bytes read. You can use this to determine the
|
|
+read bandwidth to the VMware server.
|
|
+
|
|
+=item C<Write>
|
|
+
|
|
+=item C<Flush>
|
|
+
|
|
+Same as above, but for writing and flushing writes.
|
|
+
|
|
+=item C<QueryAllocatedBlocks>
|
|
+
|
|
+This call is used to query information about the sparseness of the
|
|
+remote disk. It is only available in VDDK E<ge> 6.7. The call is
|
|
+notably very slow in all versions of VMware we have tested.
|
|
+
|
|
+=item C<Open>
|
|
+
|
|
+=item C<Close>
|
|
+
|
|
+=item C<ConnectEx>
|
|
+
|
|
+=item C<Disconnect>
|
|
+
|
|
+=item C<InitEx>
|
|
+
|
|
+=item C<Exit>
|
|
+
|
|
+The cumulative time spent connecting and disconnecting from the VMware
|
|
+server, which can also be very slow.
|
|
+
|
|
+=back
|
|
+
|
|
=head1 SUPPORTED VERSIONS OF VDDK
|
|
|
|
This plugin requires VDDK E<ge> 5.5.5, which in turn means that it
|
|
--
|
|
2.31.1
|
|
|