[trafficserver] 14/19: Doc: Add documentation for HTTP/2 statistics

[zw...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

zwoop pushed a commit to branch 8.1.x
in repository https://gitbox.apache.org/repos/asf/trafficserver.git

commit e3ba3a0bbb6803f54e8ccd2ed60831897167a8fc
Author: Masaori Koshiba <ma...@apache.org>
AuthorDate: Mon Jun 10 11:08:54 2019 +0900

    Doc: Add documentation for HTTP/2 statistics
    
    (cherry picked from commit 532fa0d7b96e100b43d801192f1f0458ffa7722e)
    
    Conflicts:
    	doc/admin-guide/monitoring/statistics/core/http-connection.en.rst
---
 .../statistics/core/http-connection.en.rst         | 64 +++++++++++++++++++++-
 .../statistics/core/http-transaction.en.rst        | 25 +++++++++
 2 files changed, 88 insertions(+), 1 deletion(-)

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 736850e..46d9db9 100644
--- a/doc/admin-guide/monitoring/statistics/core/http-connection.en.rst
+++ b/doc/admin-guide/monitoring/statistics/core/http-connection.en.rst
@@ -136,7 +136,69 @@ HTTP Connection
 
 This tracks the number of origin connections denied due to being over the :ts:cv:`proxy.config.http.origin_max_connections` 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_active_client_connections integer
+   :type: gauge
+
+   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 fd5772b..07a6e60 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.