From e10af5d2634b5e361f57315b3008b51bd5bec128 Mon Sep 17 00:00:00 2001
From: Tim Burke <tim.burke@gmail.com>
Date: Thu, 23 Jul 2020 21:46:18 -0700
Subject: [PATCH] docs: Clarify request_time in storage logs

It does *not* include transfer time; it's just the time until response
is started.

Change-Id: I67c5c37c8c669e1e2de2cbfca8bcec02dc98659f
---
 doc/source/logs.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/source/logs.rst b/doc/source/logs.rst
index f0c4f98265..8f53dfd82a 100644
--- a/doc/source/logs.rst
+++ b/doc/source/logs.rst
@@ -177,7 +177,8 @@ user_agent          The value of the HTTP User-Agent header. Swift services
                     the process ID, such as ``"proxy-server <pid of the
                     proxy>"`` or ``"object-updater <pid of the object
                     updater>"``.
-request_time        The duration of the request.
+request_time        The time between request received and response started.
+                    **Note**: This includes transfer time on PUT, but not GET.
 additional_info     Additional useful information.
 server_pid          The process id of the server
 policy_index        The value of the storage policy index.