From patchwork Tue Mar 13 14:53:42 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alexey Perevalov X-Patchwork-Id: 10279235 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id B10826038F for ; Tue, 13 Mar 2018 15:02:47 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id A22A429082 for ; Tue, 13 Mar 2018 15:02:47 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 9F48129081; Tue, 13 Mar 2018 15:02:47 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.8 required=2.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_HI,T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from lists.gnu.org (lists.gnu.org [208.118.235.17]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 10DC129181 for ; Tue, 13 Mar 2018 15:01:47 +0000 (UTC) Received: from localhost ([::1]:40371 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1evlQw-0001z2-IH for patchwork-qemu-devel@patchwork.kernel.org; Tue, 13 Mar 2018 11:01:46 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:59156) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1evlJW-0003OJ-KZ for qemu-devel@nongnu.org; Tue, 13 Mar 2018 10:54:07 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1evlJT-0001MZ-H1 for qemu-devel@nongnu.org; Tue, 13 Mar 2018 10:54:06 -0400 Received: from mailout1.w1.samsung.com ([210.118.77.11]:45228) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1evlJT-0001MC-As for qemu-devel@nongnu.org; Tue, 13 Mar 2018 10:54:03 -0400 Received: from eucas1p1.samsung.com (unknown [182.198.249.206]) by mailout1.w1.samsung.com (KnoxPortal) with ESMTP id 20180313145401euoutp01c0a8a94bdaf70637af7535e1cc63059e~bgo0XHm3w1954619546euoutp01b; Tue, 13 Mar 2018 14:54:01 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 mailout1.w1.samsung.com 20180313145401euoutp01c0a8a94bdaf70637af7535e1cc63059e~bgo0XHm3w1954619546euoutp01b DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=samsung.com; s=mail20170921; t=1520952841; bh=psayMhto0+HT2nEy3tK/RGoBRU3Gl66/D0dncZracXY=; h=From:To:Cc:Subject:Date:In-reply-to:References:From; b=pHWaMG9A4M8qFk107GXm68XyXBCTMvv7Lc3ZTRdo5X/3+mL2Wy+LpRGmegUK4fZL2 GohEifkHEXRDgQJzA/YbSncFb58bBbscfz6MLTgzmsOC+G4/MdqjKIsfp3udwhhTnI DGrNLFQRgxVsauZz76gxjw7esjFgtv5E+A5kTdg4= Received: from eusmges1new.samsung.com (unknown [203.254.199.242]) by eucas1p1.samsung.com (KnoxPortal) with ESMTP id 20180313145400eucas1p1170fad140abf63b8a01fa47aff3b202c~bgozS6UL40219102191eucas1p1Y; Tue, 13 Mar 2018 14:54:00 +0000 (GMT) Received: from eucas1p1.samsung.com ( [182.198.249.206]) by eusmges1new.samsung.com (EUCPMTA) with SMTP id 7D.8A.05700.806E7AA5; Tue, 13 Mar 2018 14:54:00 +0000 (GMT) Received: from eusmgms2.samsung.com (unknown [182.198.249.180]) by eucas1p2.samsung.com (KnoxPortal) with ESMTP id 20180313145359eucas1p22721e2cbfd518aad83cbb6741ae802ac~bgoyjNTfe2039820398eucas1p2L; Tue, 13 Mar 2018 14:53:59 +0000 (GMT) X-AuditID: cbfec7f2-1c1ff70000011644-6e-5aa7e6088ced Received: from eusync3.samsung.com ( [203.254.199.213]) by eusmgms2.samsung.com (EUCPMTA) with SMTP id 89.3C.04183.706E7AA5; Tue, 13 Mar 2018 14:53:59 +0000 (GMT) Received: from aperevalov-ubuntu.rnd.samsung.ru ([106.109.129.199]) by eusync3.samsung.com (Oracle Communications Messaging Server 7.0.5.31.0 64bit (built May 5 2014)) with ESMTPA id <0P5J00AR2APOJ400@eusync3.samsung.com>; Tue, 13 Mar 2018 14:53:59 +0000 (GMT) From: Alexey Perevalov To: qemu-devel@nongnu.org, dgilbert@redhat.com Date: Tue, 13 Mar 2018 17:53:42 +0300 Message-id: <1520952824-3172-5-git-send-email-a.perevalov@samsung.com> X-Mailer: git-send-email 2.7.4 In-reply-to: <1520952824-3172-1-git-send-email-a.perevalov@samsung.com> X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFtrOIsWRmVeSWpSXmKPExsWy7djPc7ocz5ZHGfzez2Ux9+55FouVk5cw WfRuu8ducWLTQWaLTw1SFlv2f2O3ON67g8XizpY+JovTNzezO3B6HHixkN3jybXNTB7v911l 8+jbsooxgCWKyyYlNSezLLVI3y6BK6N1U3zBV+6KdZ97WRoY/3N2MXJySAiYSLxdcJK9i5GL Q0hgBaPE7We/oJzPjBLbmv4wdjFygFV9OQ8VX8Yoser+NGYIp5tJYtObJ2BFbAIGEvvu2YKY IgJ6EhOuRoKUMAtsZJTYeec9C8g2YQFniUcblrGB2CwCqhIPVx1kBbF5BdwkdhyfxwRxkZzE zXOdzCBzOAXcJVZ0lYDMkRDoYZO4tf8O1D0uEjd/BUKUC0u8Or6FHcKWkbg8uZsFor6dUeLu xqusEM4ERol1k48xQ1TZS5y6eRVsGbMAn8SkbdOZIYbySnS0CUGUeEjsvD2TBcJ2lOg9dJcN 4t9ZjBIffnxjm8AotYCRYRWjeGppcW56arFhXmq5XnFibnFpXrpecn7uJkZgdJ7+d/zTDsav l5IOMQpwMCrx8DJcWB4lxJpYVlyZe4hRgoNZSYQ35wFQiDclsbIqtSg/vqg0J7X4EKM0B4uS OG+cRl2UkEB6YklqdmpqQWoRTJaJg1OqgTGz99wG1TpjwTdvtnhxnzv9irP2/NkdSue2tB74 k7Dy87v+S3pJhqX1x5T/Py6Neu19lLfT+V9al2qGgvkfS3nGs4WhaYUe1hfPX0x82LNqueUR hdkP9cRvrpO4fLX0TC/PSzMrbyvH2VqW0icsJ/d9fbU+/ZvFcjF2zuUT79dla19x235kWqES S3FGoqEWc1FxIgDmrja7ygIAAA== X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFupgluLIzCtJLcpLzFFi42I5/e/4VV32Z8ujDB4vVbeYe/c8i8XKyUuY LHq33WO3OLHpILPFpwYpiy37v7FbHO/dwWJxZ0sfk8Xpm5vZHTg9DrxYyO7x5NpmJo/3+66y efRtWcUYwBLFZZOSmpNZllqkb5fAldG6Kb7gK3fFus+9LA2M/zm7GDk4JARMJL6cZ+9i5OIQ EljCKHHmyg8WCKeXSeJVWy8rSBGbgIHEvnu2IKaIgJ7EhKuRICXMAhsZJX7NuAtUwskhLOAs 8WjDMjYQm0VAVeLhqoNgcV4BN4kdx+cxgdgSAnISN891MoPM4RRwl1jRVQISFgIq2TnrL/sE Rp4FjAyrGEVSS4tz03OLjfSKE3OLS/PS9ZLzczcxAsNn27GfW3Ywdr0LPsQowMGoxMPLcGF5 lBBrYllxZe4hRgkOZiUR3pwHQCHelMTKqtSi/Pii0pzU4kOM0hwsSuK85w0qo4QE0hNLUrNT UwtSi2CyTBycUg2MdYLdJr9rRU1XXXjEYpN/r0G2JLTHrib+hmeN3WUbi282tb/6eG32XIp6 ti3ct29vXvqn4qe9fNNdlyul3d0Ql9B/9afjrIlTRLzvsYhtla8/JKu/sMLUVFeHK1ekMuxv 8n6xA8sUlwjzeTbOZVwtNFM/7McXRv2IuJSv+5dIT9E777lW7pUSS3FGoqEWc1FxIgBFAuY5 GwIAAA== X-CMS-MailID: 20180313145359eucas1p22721e2cbfd518aad83cbb6741ae802ac X-Msg-Generator: CA CMS-TYPE: 201P X-CMS-RootMailID: 20180313145359eucas1p22721e2cbfd518aad83cbb6741ae802ac X-RootMTR: 20180313145359eucas1p22721e2cbfd518aad83cbb6741ae802ac References: <1520952824-3172-1-git-send-email-a.perevalov@samsung.com> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy] X-Received-From: 210.118.77.11 Subject: [Qemu-devel] [PATCH v1 4/6] migration: postcopy_blocktime documentation X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: lvivier@redhat.com, v.kuramshin@samsung.com, quintela@redhat.com, ash.billore@samsung.com, Alexey Perevalov , peterx@redhat.com, f4bug@amsat.org Errors-To: qemu-devel-bounces+patchwork-qemu-devel=patchwork.kernel.org@nongnu.org Sender: "Qemu-devel" X-Virus-Scanned: ClamAV using ClamSMTP Reviewed-by: Dr. David Alan Gilbert Signed-off-by: Alexey Perevalov Reviewed-by: Juan Quintela Signed-off-by: Juan Quintela --- docs/devel/migration.rst | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/devel/migration.rst b/docs/devel/migration.rst index 9d1b765..18cd952 100644 --- a/docs/devel/migration.rst +++ b/docs/devel/migration.rst @@ -401,6 +401,20 @@ will now cause the transition from precopy to postcopy. It can be issued immediately after migration is started or any time later on. Issuing it after the end of a migration is harmless. +Blocktime is a postcopy live migration metric, intended to show how +long the vCPU was in state of interruptable sleep due to pagefault. +That metric is calculated both for all vCPUs as overlapped value, and +separately for each vCPU. These values are calculated on destination +side. To enable postcopy blocktime calculation, enter following +command on destination monitor: + +``migrate_set_capability postcopy-blocktime on`` + +Postcopy blocktime can be retrieved by query-migrate qmp command. +postcopy-blocktime value of qmp command will show overlapped blocking +time for all vCPU, postcopy-vcpu-blocktime will show list of blocking +time per vCPU. + .. note:: During the postcopy phase, the bandwidth limits set using ``migrate_set_speed`` is ignored (to avoid delaying requested pages that