From 851cec98b260f163819efa46dce7394355a147d2 Mon Sep 17 00:00:00 2001
From: Masaori Koshiba <masaori@apache.org>
Date: Mon, 10 Jun 2019 11:08:54 +0900
Subject: [PATCH] Doc: Add documentation for HTTP/2 statistics

---
 .../statistics/core/http-connection.en.rst    | 63 ++++++++++++++++++-
 .../statistics/core/http-transaction.en.rst   | 25 ++++++++
 2 files changed, 85 insertions(+), 3 deletions(-)

diff --git a/doc/admin-guide/monitoring/statistics/core/http-connection.en.rst b/doc/admin-guide/monitoring/statistics/core/http-connection.en.rst
index dc55cc3ae04..411881fa104 100644
--- a/doc/admin-guide/monitoring/statistics/core/http-connection.en.rst
+++ b/doc/admin-guide/monitoring/statistics/core/http-connection.en.rst
@@ -138,12 +138,69 @@ HTTP Connection
 
    This tracks the number of origin connections denied due to being over the :ts:cv:`proxy.config.http.per_server.connection.max` limit.
 
-.. ts:stat:: global proxy.process.http2.current_active_client_connections integer
+
+HTTP/2
+------
+
+
+.. ts:stat:: global proxy.process.http2.total_client_connections integer
+   :type: counter
+
+   Represents the total number of HTTP/2 connections from client to the |TS|.
+
+.. ts:stat:: global proxy.process.http2.current_client_connections integer
    :type: gauge
 
    Represents the current number of HTTP/2 connections from client to the |TS|.
 
-.. ts:stat:: global proxy.process.http2.current_client_streams integer
+.. ts:stat:: global proxy.process.http2.current_active_client_connections integer
    :type: gauge
 
-   Represents the current number of HTTP/2 streams from client to the |TS|.
+   Represents the current number of HTTP/2 active connections from client to the |TS|.
+
+.. ts:stat:: global proxy.process.http2.connection_errors integer
+   :type: counter
+
+   Represents the total number of HTTP/2 connections errors.
+
+.. ts:stat:: global proxy.process.http2.session_die_default integer
+   :type: counter
+
+   Represents the total number of closed HTTP/2 connections with
+   ``VC_EVENT_NONE`` event.
+
+.. ts:stat:: global proxy.process.http2.session_die_active integer
+   :type: counter
+
+   Represents the total number of closed HTTP/2 connections with
+   ``VC_EVENT_ACTIVE_TIMEOUT`` event.
+
+.. ts:stat:: global proxy.process.http2.session_die_inactive integer
+   :type: counter
+
+   Represents the total number of closed HTTP/2 connections with
+   ``VC_EVENT_INACTIVITY_TIMEOUT`` event.
+
+.. ts:stat:: global proxy.process.http2.session_die_eos integer
+   :type: counter
+
+   Represents the total number of closed HTTP/2 connections with
+   ``VC_EVENT_EOS`` event.
+
+.. ts:stat:: global proxy.process.http2.session_die_error integer
+   :type: counter
+
+   Represents the total number of closed HTTP/2 connections with
+   ``VC_EVENT_ERROR`` event.
+
+.. ts:stat:: global proxy.process.http2.session_die_other integer
+   :type: counter
+
+   Represents the total number of closed HTTP/2 connections with
+   unknown event.
+
+.. ts:stat:: global proxy.process.http2.session_die_high_error_rate integer
+   :type: counter
+
+   Represents the total number of closed HTTP/2 connections with high
+   error rate which is configured by :ts:cv:`proxy.config.http2.stream_error_rate_threshold`.
diff --git a/doc/admin-guide/monitoring/statistics/core/http-transaction.en.rst b/doc/admin-guide/monitoring/statistics/core/http-transaction.en.rst
index fd5772bb764..07a6e60a0d8 100644
--- a/doc/admin-guide/monitoring/statistics/core/http-transaction.en.rst
+++ b/doc/admin-guide/monitoring/statistics/core/http-transaction.en.rst
@@ -150,3 +150,28 @@ HTTP Transaction
    :units: seconds
    :ungathered:
 
+
+HTTP/2
+------
+
+
+.. ts:stat:: global proxy.process.http2.total_client_streams integer
+   :type: counter
+
+   Represents the total number of HTTP/2 streams from client to the |TS|.
+
+.. ts:stat:: global proxy.process.http2.current_client_streams integer
+   :type: gauge
+
+   Represents the current number of HTTP/2 streams from client to the |TS|.
+
+.. ts:stat:: global proxy.process.http2.total_transactions_time integer
+   :type: counter
+   :units: seconds
+
+   Represents the total transaction time of HTTP/2 streams from client to the |TS|.
+
+.. ts:stat:: global proxy.process.http2.stream_errors integer
+   :type: counter
+
+   Represents the total number of HTTP/2 stream errors.