trafficserver-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jpe...@apache.org
Subject [37/51] trafficserver git commit: Documentation reorganization
Date Tue, 03 Nov 2015 06:10:13 GMT
http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce162a6d/doc/admin-guide/monitoring/statistics/core/http-connection.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/monitoring/statistics/core/http-connection.en.rst b/doc/admin-guide/monitoring/statistics/core/http-connection.en.rst
new file mode 100644
index 0000000..3a48966
--- /dev/null
+++ b/doc/admin-guide/monitoring/statistics/core/http-connection.en.rst
@@ -0,0 +1,141 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+
+.. include:: ../../../../common.defs
+
+.. _admin-stats-core-http-connection:
+
+HTTP Connection
+***************
+
+.. ts:stat:: global proxy.node.current_cache_connections integer
+   :type: gauge
+   :ungathered:
+
+.. ts:stat:: global proxy.node.current_client_connections integer
+   :type: gauge
+
+.. ts:stat:: global proxy.node.current_server_connections integer
+   :type: gauge
+
+.. ts:stat:: global proxy.node.http.user_agent_current_connections_count integer
+   :type: gauge
+
+.. ts:stat:: global proxy.node.http.user_agents_total_documents_served integer
+   :type: counter
+
+.. ts:stat:: global proxy.node.http.user_agents_total_transactions_count integer
+   :type: counter
+
+.. ts:stat:: global proxy.node.http.user_agent_total_request_bytes integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.node.http.user_agent_total_response_bytes integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.node.http.user_agent_xacts_per_second float
+   :type: derivative
+
+.. ts:stat:: global proxy.process.http.broken_server_connections integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.completed_requests integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.connect_requests integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.current_active_client_connections integer
+   :type: gauge
+
+.. ts:stat:: global proxy.process.http.current_cache_connections integer
+   :type: gauge
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.current_client_connections integer
+   :type: gauge
+
+.. ts:stat:: global proxy.process.http.current_client_transactions integer
+   :type: gauge
+
+.. ts:stat:: global proxy.process.http.current_server_connections integer
+   :type: gauge
+
+.. ts:stat:: global proxy.process.http.current_server_transactions integer
+   :type: gauge
+
+.. ts:stat:: global proxy.process.http.err_client_abort_count_stat integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.err_client_abort_origin_server_bytes_stat integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.http.err_client_abort_user_agent_bytes_stat integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.http.err_connect_fail_count_stat integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.err_connect_fail_origin_server_bytes_stat integer
+   :type: counter
+   :unit: bytes
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.err_connect_fail_user_agent_bytes_stat integer
+   :type: counter
+   :unit: bytes
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.http_misc_origin_server_bytes_stat integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.http.icp_suggested_lookups integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.incoming_requests integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.incoming_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.https.incoming_requests integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.https.total_client_connections integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.total_client_connections integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.total_client_connections_ipv4 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.total_client_connections_ipv6 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.total_incoming_connections integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.total_server_connections integer
+   :type: counter
+

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce162a6d/doc/admin-guide/monitoring/statistics/core/http-document-size.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/monitoring/statistics/core/http-document-size.en.rst b/doc/admin-guide/monitoring/statistics/core/http-document-size.en.rst
new file mode 100644
index 0000000..fcf5cb9
--- /dev/null
+++ b/doc/admin-guide/monitoring/statistics/core/http-document-size.en.rst
@@ -0,0 +1,79 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+
+.. include:: ../../../../common.defs
+
+.. _admin-stats-core-http-doc-size:
+
+HTTP Document Size
+******************
+
+.. ts:stat:: global proxy.process.http.pushed_document_total_size integer
+   :type: counter
+   :unit: bytes
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.request_document_size_100 integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.request_document_size_10K integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.request_document_size_1K integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.request_document_size_1M integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.request_document_size_3K integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.request_document_size_5K integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.request_document_size_inf integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.response_document_size_100 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.response_document_size_10K integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.response_document_size_1K integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.response_document_size_1M integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.response_document_size_3K integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.response_document_size_5K integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.response_document_size_inf integer
+   :type: counter
+   :ungathered:
+

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce162a6d/doc/admin-guide/monitoring/statistics/core/http-header.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/monitoring/statistics/core/http-header.en.rst b/doc/admin-guide/monitoring/statistics/core/http-header.en.rst
new file mode 100644
index 0000000..ad965ee
--- /dev/null
+++ b/doc/admin-guide/monitoring/statistics/core/http-header.en.rst
@@ -0,0 +1,27 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+
+.. include:: ../../../../common.defs
+
+.. _admin-stats-core-http-header:
+
+HTTP Header
+***********
+
+.. ts:stat:: global proxy.process.http.missing_host_hdr integer
+.. ts:stat:: global proxy.process.http.pushed_response_header_total_size integer
+

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce162a6d/doc/admin-guide/monitoring/statistics/core/http-request-method.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/monitoring/statistics/core/http-request-method.en.rst b/doc/admin-guide/monitoring/statistics/core/http-request-method.en.rst
new file mode 100644
index 0000000..79c787d
--- /dev/null
+++ b/doc/admin-guide/monitoring/statistics/core/http-request-method.en.rst
@@ -0,0 +1,94 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+
+.. include:: ../../../../common.defs
+
+.. _admin-stats-core-http-method:
+
+HTTP Request Method
+*******************
+
+The statistics documented in this section provide counters for the number of
+incoming requests to the |TS| instance, broken down by the HTTP method of the
+request.
+
+.. ts:stat:: global proxy.process.http.delete_requests integer
+   :type: counter
+
+   Represents the total number of HTTP :literal:`DELETE` requests received by
+   the |TS| instance since statistics collection began.
+
+.. ts:stat:: global proxy.process.http.extension_method_requests integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.get_requests integer
+   :type: counter
+
+   Represents the total number of HTTP :literal:`GET` requests received by
+   the |TS| instance since statistics collection began.
+
+.. ts:stat:: global proxy.process.http.head_requests integer
+   :type: counter
+
+   Represents the total number of HTTP :literal:`HEAD` requests received by
+   the |TS| instance since statistics collection began.
+
+.. ts:stat:: global proxy.process.http.invalid_client_requests integer
+   :type: counter
+
+   Represents the total number of requests received by the |TS| instance, since
+   statistics collection began, which did not include a valid HTTP method.
+
+.. ts:stat:: global proxy.process.http.options_requests integer
+   :type: counter
+
+   Represents the total number of HTTP :literal:`OPTIONS` requests received by
+   the |TS| instance since statistics collection began.
+
+.. ts:stat:: global proxy.process.http.outgoing_requests integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.post_requests integer
+   :type: counter
+
+   Represents the total number of HTTP :literal:`POST` requests received by
+   the |TS| instance since statistics collection began.
+
+.. ts:stat:: global proxy.process.http.purge_requests integer
+   :type: counter
+
+   Represents the total number of HTTP :literal:`PURGE` requests received by
+   the |TS| instance since statistics collection began.
+
+.. ts:stat:: global proxy.process.http.push_requests integer
+   :type: counter
+
+   Represents the total number of HTTP :literal:`PUSH` requests received by
+   the |TS| instance since statistics collection began.
+
+.. ts:stat:: global proxy.process.http.put_requests integer
+   :type: counter
+
+   Represents the total number of HTTP :literal:`PUT` requests received by
+   the |TS| instance since statistics collection began.
+
+.. ts:stat:: global proxy.process.http.trace_requests integer
+   :type: counter
+
+   Represents the total number of HTTP :literal:`TRACE` requests received by
+   the |TS| instance since statistics collection began.
+

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce162a6d/doc/admin-guide/monitoring/statistics/core/http-response-code.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/monitoring/statistics/core/http-response-code.en.rst b/doc/admin-guide/monitoring/statistics/core/http-response-code.en.rst
new file mode 100644
index 0000000..5efeada
--- /dev/null
+++ b/doc/admin-guide/monitoring/statistics/core/http-response-code.en.rst
@@ -0,0 +1,165 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+
+.. include:: ../../../../common.defs
+
+.. _admin-stats-core-http-response-code:
+
+HTTP Response Code
+******************
+
+The statistics documented in this section provide counters for the number of
+HTTP responses delivered to user agents by your |TS| instance, grouped by the
+HTTP status code of the response. Please refer to the
+:ref:`appendix-http-status-codes` appendix for more details on what each status
+code means.
+
+.. ts:stat:: global proxy.process.http.100_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.101_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.1xx_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.200_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.201_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.202_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.203_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.204_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.205_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.206_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.2xx_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.300_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.301_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.302_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.303_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.304_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.305_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.307_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.3xx_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.400_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.401_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.402_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.403_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.404_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.405_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.406_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.407_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.408_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.409_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.410_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.411_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.412_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.413_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.414_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.415_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.416_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.4xx_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.500_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.501_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.502_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.503_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.504_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.505_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.5xx_responses integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.total_x_redirect_count integer
+   :type: counter
+

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce162a6d/doc/admin-guide/monitoring/statistics/core/http-transaction.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/monitoring/statistics/core/http-transaction.en.rst b/doc/admin-guide/monitoring/statistics/core/http-transaction.en.rst
new file mode 100644
index 0000000..d2b0685
--- /dev/null
+++ b/doc/admin-guide/monitoring/statistics/core/http-transaction.en.rst
@@ -0,0 +1,347 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+
+.. include:: ../../../../common.defs
+
+.. _admin-stats-core-http-transaction:
+
+HTTP Transaction
+****************
+
+.. ts:stat:: global proxy.node.http.transaction_counts_avg_10s.errors.aborts float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_counts_avg_10s.errors.connect_failed float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_counts_avg_10s.errors.early_hangups float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_counts_avg_10s.errors.empty_hangups float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_counts_avg_10s.errors.other float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_counts_avg_10s.errors.possible_aborts float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_counts_avg_10s.errors.pre_accept_hangups float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_counts_avg_10s.hit_fresh float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_counts_avg_10s.hit_revalidated float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_counts_avg_10s.miss_changed float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_counts_avg_10s.miss_client_no_cache float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_counts_avg_10s.miss_cold float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_counts_avg_10s.miss_not_cacheable float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_counts_avg_10s.other.unclassified float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.errors.aborts float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.errors.aborts_int_pct integer
+   :type: derivative
+   :ungathered:
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.errors.connect_failed float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.errors.connect_failed_int_pct integer
+   :type: derivative
+   :ungathered:
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.errors.early_hangups float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.errors.early_hangups_int_pct integer
+   :type: derivative
+   :ungathered:
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.errors.empty_hangups float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.errors.empty_hangups_int_pct integer
+   :type: derivative
+   :ungathered:
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.errors.other float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.errors.other_int_pct integer
+   :type: derivative
+   :ungathered:
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.errors.possible_aborts float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.errors.possible_aborts_int_pct integer
+   :type: derivative
+   :ungathered:
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.errors.pre_accept_hangups float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.errors.pre_accept_hangups_int_pct integer
+   :type: derivative
+   :ungathered:
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.hit_fresh float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.hit_fresh_int_pct integer
+   :type: derivative
+   :ungathered:
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.hit_revalidated float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.hit_revalidated_int_pct integer
+   :type: derivative
+   :ungathered:
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.miss_changed float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.miss_changed_int_pct integer
+   :type: derivative
+   :ungathered:
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.miss_client_no_cache float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.miss_client_no_cache_int_pct integer
+   :type: derivative
+   :ungathered:
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.miss_cold float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.miss_cold_int_pct integer
+   :type: derivative
+   :ungathered:
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.miss_not_cacheable float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.miss_not_cacheable_int_pct integer
+   :type: derivative
+   :ungathered:
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.other.unclassified float
+   :type: derivative
+
+.. ts:stat:: global proxy.node.http.transaction_frac_avg_10s.other.unclassified_int_pct integer
+   :type: derivative
+   :ungathered:
+
+.. ts:stat:: global proxy.node.http.transaction_msec_avg_10s.errors.aborts integer
+   :type: derivative
+   :unit: milliseconds
+
+.. ts:stat:: global proxy.node.http.transaction_msec_avg_10s.errors.connect_failed integer
+   :type: derivative
+   :unit: milliseconds
+
+.. ts:stat:: global proxy.node.http.transaction_msec_avg_10s.errors.early_hangups integer
+   :type: derivative
+   :unit: milliseconds
+
+.. ts:stat:: global proxy.node.http.transaction_msec_avg_10s.errors.empty_hangups integer
+   :type: derivative
+   :unit: milliseconds
+
+.. ts:stat:: global proxy.node.http.transaction_msec_avg_10s.errors.other integer
+   :type: derivative
+   :unit: milliseconds
+
+.. ts:stat:: global proxy.node.http.transaction_msec_avg_10s.errors.possible_aborts integer
+   :type: derivative
+   :unit: milliseconds
+
+.. ts:stat:: global proxy.node.http.transaction_msec_avg_10s.errors.pre_accept_hangups integer
+   :type: derivative
+   :unit: milliseconds
+
+.. ts:stat:: global proxy.node.http.transaction_msec_avg_10s.hit_fresh integer
+   :type: derivative
+   :unit: milliseconds
+
+.. ts:stat:: global proxy.node.http.transaction_msec_avg_10s.hit_revalidated integer
+   :type: derivative
+   :unit: milliseconds
+
+.. ts:stat:: global proxy.node.http.transaction_msec_avg_10s.miss_changed integer
+   :type: derivative
+   :unit: milliseconds
+
+.. ts:stat:: global proxy.node.http.transaction_msec_avg_10s.miss_client_no_cache integer
+   :type: derivative
+   :unit: milliseconds
+
+.. ts:stat:: global proxy.node.http.transaction_msec_avg_10s.miss_cold integer
+   :type: derivative
+   :unit: milliseconds
+
+.. ts:stat:: global proxy.node.http.transaction_msec_avg_10s.miss_not_cacheable integer
+   :type: derivative
+   :unit: milliseconds
+
+.. ts:stat:: global proxy.node.http.transaction_msec_avg_10s.other.unclassified integer
+   :type: derivative
+   :unit: milliseconds
+
+.. ts:stat:: global proxy.process.http.avg_transactions_per_client_connection float
+   :type: derivative
+
+.. ts:stat:: global proxy.process.http.avg_transactions_per_server_connection float
+   :type: derivative
+
+.. ts:stat:: global proxy.process.http.total_transactions_time integer
+   :type: counter
+   :unit: seconds
+
+.. ts:stat:: global proxy.process.http.transaction_counts.errors.aborts integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.transaction_counts.errors.connect_failed integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_counts.errors.early_hangups integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_counts.errors.empty_hangups integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_counts.errors.other integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.transaction_counts.errors.possible_aborts integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_counts.errors.pre_accept_hangups integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_counts.hit_fresh integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.transaction_counts.hit_fresh.process integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.transaction_counts.hit_revalidated integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.transaction_counts.miss_changed integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.transaction_counts.miss_client_no_cache integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_counts.miss_cold integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.transaction_counts.miss_not_cacheable integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.http.transaction_counts.other.unclassified integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_totaltime.errors.aborts float
+   :type: counter
+   :unit: seconds
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_totaltime.errors.connect_failed float
+   :type: counter
+   :unit: seconds
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_totaltime.errors.other float
+   :type: counter
+   :unit: seconds
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_totaltime.errors.possible_aborts float
+   :type: counter
+   :unit: seconds
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_totaltime.errors.pre_accept_hangups float
+   :type: counter
+   :unit: seconds
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_totaltime.hit_fresh float
+   :type: counter
+   :unit: seconds
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_totaltime.hit_fresh.process float
+   :type: counter
+   :unit: seconds
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_totaltime.hit_revalidated float
+   :type: counter
+   :unit: seconds
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_totaltime.miss_changed float
+   :type: counter
+   :unit: seconds
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_totaltime.miss_client_no_cache float
+   :type: counter
+   :unit: seconds
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_totaltime.miss_cold float
+   :type: counter
+   :unit: seconds
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_totaltime.miss_not_cacheable float
+   :type: counter
+   :unit: seconds
+   :ungathered:
+
+.. ts:stat:: global proxy.process.http.transaction_totaltime.other.unclassified float
+   :type: counter
+   :unit: seconds
+   :ungathered:
+

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce162a6d/doc/admin-guide/monitoring/statistics/core/log.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/monitoring/statistics/core/log.en.rst b/doc/admin-guide/monitoring/statistics/core/log.en.rst
new file mode 100644
index 0000000..cd5a9be
--- /dev/null
+++ b/doc/admin-guide/monitoring/statistics/core/log.en.rst
@@ -0,0 +1,250 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+
+.. include:: ../../../../common.defs
+
+.. _admin-stats-core-log:
+
+Logging
+*******
+
+.. ts:stat:: global proxy.node.log.bytes_flush_to_disk integer
+   :type: counter
+   :unit: bytes
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.bytes_lost_before_flush_to_disk integer
+   :type: counter
+   :unit: bytes
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.bytes_lost_before_preproc integer
+   :type: counter
+   :unit: bytes
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.bytes_lost_before_sent_to_network integer
+   :type: counter
+   :unit: bytes
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.bytes_lost_before_written_to_disk integer
+   :type: counter
+   :unit: bytes
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.bytes_received_from_network_avg_10s integer
+   :type: counter
+   :unit: bytes
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.bytes_received_from_network integer
+   :type: counter
+   :unit: bytes
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.bytes_sent_to_network_avg_10s integer
+   :type: counter
+   :unit: bytes
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.bytes_sent_to_network integer
+   :type: counter
+   :unit: bytes
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.bytes_written_to_disk integer
+   :type: counter
+   :unit: bytes
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.event_log_access_aggr integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.event_log_access_fail integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.event_log_access_full integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.event_log_access_ok integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.event_log_access_skip integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.event_log_error_aggr integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.event_log_error_fail integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.event_log_error_full integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.event_log_error_ok integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.event_log_error_skip integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.num_flush_to_disk integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.num_lost_before_flush_to_disk integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.num_lost_before_sent_to_network integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.num_received_from_network integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.node.log.num_sent_to_network integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.log.bytes_flush_to_disk integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.log.bytes_lost_before_flush_to_disk integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.log.bytes_lost_before_preproc integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.log.bytes_lost_before_sent_to_network integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.log.bytes_lost_before_written_to_disk integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.log.bytes_received_from_network integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.log.bytes_sent_to_network integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.log.bytes_written_to_disk integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.log.event_log_access_aggr integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.log.event_log_access_fail integer
+   :type: counter
+
+   Indicates the number of times |TS| has encountered a failure while attempting
+   to log an event to the access logs facility.
+
+.. ts:stat:: global proxy.process.log.event_log_access_full integer
+   :type: counter
+
+   Indicates the number of times |TS| has been unable to log an event to the
+   access logs facility due to insufficient space.
+
+.. ts:stat:: global proxy.process.log.event_log_access_ok integer
+   :type: counter
+
+   Indicates the number of times |TS| has successfully logged an event to the
+   access logs facility.
+
+.. ts:stat:: global proxy.process.log.event_log_access_skip integer
+   :type: counter
+
+   Indicates the number of times |TS| has skipped logging an event to the access
+   logs facility.
+
+.. ts:stat:: global proxy.process.log.event_log_error_aggr integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.log.event_log_error_fail integer
+   :type: counter
+
+   Indicates the number of times |TS| has encountered a failure while attempting
+   to log an event to the error logs facility.
+
+.. ts:stat:: global proxy.process.log.event_log_error_full integer
+   :type: counter
+
+   Indicates the number of times |TS| has been unable to log an event to the
+   error logs facility due to insufficient space.
+
+.. ts:stat:: global proxy.process.log.event_log_error_ok integer
+   :type: counter
+
+   Indicates the number of times |TS| has successfully logged an event to the
+   error logs facility.
+
+.. ts:stat:: global proxy.process.log.event_log_error_skip integer
+   :type: counter
+
+   Indicates the number of times |TS| has skipped logging an event to the error
+   logs facility.
+
+.. ts:stat:: global proxy.process.log.log_files_open integer
+   :type: gauge
+
+   Indicates the number of log files currently open by |TS|.
+
+.. ts:stat:: global proxy.process.log.log_files_space_used integer
+   :type: gauge
+   :unit: bytes
+
+   Indicates the number of bytes currently in use by |TS| log files.
+
+.. ts:stat:: global proxy.process.log.num_flush_to_disk integer
+   :type: counter
+
+   The number of events |TS| has flushed to log files on disk, since statistics
+   collection began.
+
+.. ts:stat:: global proxy.process.log.num_lost_before_flush_to_disk integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.log.num_lost_before_sent_to_network integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.log.num_received_from_network integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.log.num_sent_to_network integer
+   :type: counter
+
+

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce162a6d/doc/admin-guide/monitoring/statistics/core/misc.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/monitoring/statistics/core/misc.en.rst b/doc/admin-guide/monitoring/statistics/core/misc.en.rst
new file mode 100644
index 0000000..81cd3db
--- /dev/null
+++ b/doc/admin-guide/monitoring/statistics/core/misc.en.rst
@@ -0,0 +1,27 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+
+.. include:: ../../../../common.defs
+
+.. _admin-stats-core-misc:
+
+Miscellaneous
+*************
+
+.. ts:stat:: global proxy.process.http.misc_count_stat integer
+.. ts:stat:: global proxy.process.http.misc_user_agent_bytes_stat integer
+

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce162a6d/doc/admin-guide/monitoring/statistics/core/network-io.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/monitoring/statistics/core/network-io.en.rst b/doc/admin-guide/monitoring/statistics/core/network-io.en.rst
new file mode 100644
index 0000000..7fe900b
--- /dev/null
+++ b/doc/admin-guide/monitoring/statistics/core/network-io.en.rst
@@ -0,0 +1,77 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+
+.. include:: ../../../../common.defs
+
+.. _admin-stats-core-network-io:
+
+Network I/O
+***********
+
+.. ts:stat:: global proxy.process.net.accepts_currently_open integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.net.calls_to_readfromnet_afterpoll integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.net.calls_to_readfromnet integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.net.calls_to_read integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.net.calls_to_read_nodata integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.net.calls_to_write integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.net.calls_to_write_nodata integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.net.calls_to_writetonet_afterpoll integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.net.calls_to_writetonet integer
+   :type: counter
+   :ungathered:
+
+.. ts:stat:: global proxy.process.net.connections_currently_open integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.net.default_inactivity_timeout_applied integer
+.. ts:stat:: global proxy.process.net.dynamic_keep_alive_timeout_in_count integer
+.. ts:stat:: global proxy.process.net.dynamic_keep_alive_timeout_in_total integer
+.. ts:stat:: global proxy.process.net.inactivity_cop_lock_acquire_failure integer
+.. ts:stat:: global proxy.process.net.net_handler_run integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.net.read_bytes integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.net.write_bytes integer
+   :type: counter
+   :unit: bytes
+

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce162a6d/doc/admin-guide/monitoring/statistics/core/origin.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/monitoring/statistics/core/origin.en.rst b/doc/admin-guide/monitoring/statistics/core/origin.en.rst
new file mode 100644
index 0000000..ecac007
--- /dev/null
+++ b/doc/admin-guide/monitoring/statistics/core/origin.en.rst
@@ -0,0 +1,91 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+
+.. include:: ../../../../common.defs
+
+.. _admin-stats-core-origin:
+
+Origin Server
+*************
+
+.. ts:stat:: global proxy.node.http.origin_server_current_connections_count integer
+   :type: counter
+
+.. ts:stat:: global proxy.node.http.origin_server_total_request_bytes integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.node.http.origin_server_total_response_bytes integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.node.http.origin_server_total_transactions_count integer
+   :type: counter
+
+.. ts:stat:: global proxy.node.origin_server_total_bytes_avg_10s float
+   :type: derivative
+   :unit: bytes
+
+.. ts:stat:: global proxy.node.origin_server_total_bytes integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.http.origin_server_request_document_total_size integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.http.origin_server_request_header_total_size integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.http.origin_server_response_document_total_size integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.http.origin_server_response_header_total_size integer
+   :type: counter
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.http.origin_server_speed_bytes_per_sec_100 integer
+   :type: derivative
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.http.origin_server_speed_bytes_per_sec_100K integer
+   :type: derivative
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.http.origin_server_speed_bytes_per_sec_100M integer
+   :type: derivative
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.http.origin_server_speed_bytes_per_sec_10K integer
+   :type: derivative
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.http.origin_server_speed_bytes_per_sec_10M integer
+   :type: derivative
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.http.origin_server_speed_bytes_per_sec_1K integer
+   :type: derivative
+   :unit: bytes
+
+.. ts:stat:: global proxy.process.http.origin_server_speed_bytes_per_sec_1M integer
+   :type: derivative
+   :unit: bytes
+
+

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce162a6d/doc/admin-guide/monitoring/statistics/core/socks.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/monitoring/statistics/core/socks.en.rst b/doc/admin-guide/monitoring/statistics/core/socks.en.rst
new file mode 100644
index 0000000..fb1adde
--- /dev/null
+++ b/doc/admin-guide/monitoring/statistics/core/socks.en.rst
@@ -0,0 +1,45 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+
+.. include:: ../../../../common.defs
+
+.. _admin-stats-core-socks:
+
+SOCKS
+*****
+
+.. ts:stat:: global proxy.process.socks.connections_currently_open integer
+   :type: gauge
+   :ungathered:
+
+   Provides the number of SOCKS proxy connections currently opened with the
+   running instance of |TS|.
+
+.. ts:stat:: global proxy.process.socks.connections_successful integer
+   :type: counter
+   :ungathered:
+
+   Indicates the number of SOCKS connections to |TS| which have succeeded since
+   statistics collection began.
+
+.. ts:stat:: global proxy.process.socks.connections_unsuccessful integer
+   :type: counter
+   :ungathered:
+
+   Indicates the number of attempted SOCKS connections to |TS| which have failed
+   since statistics collection began.
+

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce162a6d/doc/admin-guide/monitoring/statistics/core/ssl-cipher.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/monitoring/statistics/core/ssl-cipher.en.rst b/doc/admin-guide/monitoring/statistics/core/ssl-cipher.en.rst
new file mode 100644
index 0000000..f919b4a
--- /dev/null
+++ b/doc/admin-guide/monitoring/statistics/core/ssl-cipher.en.rst
@@ -0,0 +1,282 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+
+.. include:: ../../../../common.defs
+
+.. _admin-stats-core-ssl-cipher:
+
+SSL Cipher
+**********
+
+The following statistics provide individual counters for the number of client
+requests which were satisfied using the given SSL cipher.
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.AES128-GCM-SHA256 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.AES128-SHA256 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.AES128-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.AES256-GCM-SHA384 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.AES256-SHA256 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.AES256-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.CAMELLIA128-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.CAMELLIA256-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DES-CBC3-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DES-CBC-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DHE-DSS-AES128-GCM-SHA256 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DHE-DSS-AES128-SHA256 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DHE-DSS-AES128-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DHE-DSS-AES256-GCM-SHA384 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DHE-DSS-AES256-SHA256 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DHE-DSS-AES256-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DHE-DSS-CAMELLIA128-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DHE-DSS-CAMELLIA256-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DHE-DSS-SEED-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DHE-RSA-AES128-GCM-SHA256 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DHE-RSA-AES128-SHA256 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DHE-RSA-AES128-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DHE-RSA-AES256-GCM-SHA384 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DHE-RSA-AES256-SHA256 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DHE-RSA-AES256-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DHE-RSA-CAMELLIA128-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DHE-RSA-CAMELLIA256-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.DHE-RSA-SEED-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDH-ECDSA-AES128-GCM-SHA256 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDH-ECDSA-AES128-SHA256 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDH-ECDSA-AES128-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDH-ECDSA-AES256-GCM-SHA384 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDH-ECDSA-AES256-SHA384 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDH-ECDSA-AES256-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDH-ECDSA-DES-CBC3-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDH-ECDSA-RC4-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDHE-ECDSA-AES128-GCM-SHA256 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDHE-ECDSA-AES128-SHA256 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDHE-ECDSA-AES128-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDHE-ECDSA-AES256-GCM-SHA384 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDHE-ECDSA-AES256-SHA384 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDHE-ECDSA-AES256-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDHE-ECDSA-DES-CBC3-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDHE-ECDSA-RC4-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDHE-RSA-AES128-GCM-SHA256 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDHE-RSA-AES128-SHA256 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDHE-RSA-AES128-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDHE-RSA-AES256-GCM-SHA384 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDHE-RSA-AES256-SHA384 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDHE-RSA-AES256-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDHE-RSA-DES-CBC3-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDHE-RSA-RC4-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDH-RSA-AES128-GCM-SHA256 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDH-RSA-AES128-SHA256 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDH-RSA-AES128-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDH-RSA-AES256-GCM-SHA384 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDH-RSA-AES256-SHA384 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDH-RSA-AES256-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDH-RSA-DES-CBC3-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.ECDH-RSA-RC4-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.EDH-DSS-DES-CBC3-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.EDH-DSS-DES-CBC-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.EDH-RSA-DES-CBC3-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.EDH-RSA-DES-CBC-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.EXP-DES-CBC-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.EXP-EDH-DSS-DES-CBC-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.EXP-EDH-RSA-DES-CBC-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.EXP-RC2-CBC-MD5 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.EXP-RC4-MD5 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.PSK-3DES-EDE-CBC-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.PSK-AES128-CBC-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.PSK-AES256-CBC-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.PSK-RC4-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.RC4-MD5 integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.RC4-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.SEED-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.SRP-3DES-EDE-CBC-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.SRP-AES-128-CBC-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.SRP-AES-256-CBC-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.SRP-DSS-3DES-EDE-CBC-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.SRP-DSS-AES-128-CBC-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.SRP-DSS-AES-256-CBC-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.SRP-RSA-3DES-EDE-CBC-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.SRP-RSA-AES-128-CBC-SHA integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.cipher.user_agent.SRP-RSA-AES-256-CBC-SHA integer
+   :type: counter
+

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce162a6d/doc/admin-guide/monitoring/statistics/core/ssl.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/monitoring/statistics/core/ssl.en.rst b/doc/admin-guide/monitoring/statistics/core/ssl.en.rst
new file mode 100644
index 0000000..1d83dc1
--- /dev/null
+++ b/doc/admin-guide/monitoring/statistics/core/ssl.en.rst
@@ -0,0 +1,221 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+
+.. include:: ../../../../common.defs
+
+.. _admin-stats-core-ssl:
+
+SSL/TLS
+*******
+
+.. ts:stat:: global proxy.process.ssl.origin_server_bad_cert integer
+   :type: counter
+
+   Indicates the number of certificates presented by origin servers which
+   contained invalid information, since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.origin_server_cert_verify_failed integer
+   :type: counter
+
+   The number of origin server SSL certificates presented which failed
+   verification, since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.origin_server_decryption_failed integer
+   :type: counter
+
+   The number of SSL connections to origin servers which returned data that
+   could not be properly decrypted, since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.origin_server_expired_cert integer
+   :type: counter
+
+   The number of SSL connections to origin servers for which expired origin
+   certificates were presented, since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.origin_server_other_errors integer
+   :type: counter
+
+   The number of SSL connections to origin servers which encountered otherwise
+   uncategorized errors, since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.origin_server_revoked_cert integer
+   :type: counter
+
+   The number of SSL connections to origin servers during which a revoked
+   certificate was presented by the origin, since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.origin_server_unknown_ca integer
+   :type: counter
+
+   The number of SSL connections to origin servers during which the origin
+   presented a certificate signed by an unrecognized Certificate Authority,
+   since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.origin_server_unknown_cert integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.origin_server_wrong_version integer
+   :type: counter
+
+   The number of SSL connections to origin servers which were terminated due to
+   unsupported SSL/TLS protocol versions, since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.ssl_error_read_eos integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.ssl_error_ssl integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.ssl_error_syscall integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.ssl_error_want_read integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.ssl_error_want_write integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.ssl_error_want_x509_lookup integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.ssl_error_zero_return integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.ssl_session_cache_eviction integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.ssl_session_cache_hit integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.ssl_session_cache_lock_contention integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.ssl_session_cache_miss integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.ssl_session_cache_new_session integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.ssl_sni_name_set_failure integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.total_handshake_time integer
+   :type: counter
+   :unit: milliseconds
+
+   The total amount of time spent performing SSL/TLS handshakes for new sessions
+   since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.total_success_handshake_count integer
+   :type: counter
+
+   The total number of SSL/TLS handshakes successfully performed since
+   statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.total_ticket_keys_renewed integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.total_tickets_created integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.total_tickets_not_found integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.total_tickets_renewed integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.total_tickets_verified integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.total_tickets_verified_old_key integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.user_agent_bad_cert integer
+   :type: counter
+
+   Incoming client SSL connections which have presented invalid data in lieu of
+   a client certificate, since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.user_agent_cert_verify_failed integer
+   :type: counter
+
+   Incoming client SSL connections which presented a client certificate that did
+   not pass verification, since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.user_agent_decryption_failed integer
+   :type: counter
+
+   Incoming client SSL connections which failed to be properly decrypted, since
+   statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.user_agent_expired_cert integer
+   :type: counter
+
+   Incoming client SSL connections which presented a client certificate that had
+   already expired, since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.user_agent_other_errors integer
+   :type: counter
+
+   Incoming client SSL connections which experienced otherwise uncategorized
+   errors, since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.user_agent_revoked_cert integer
+   :type: counter
+
+   Incoming client SSL connections which presented a client certificate that had
+   been revoked, since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.user_agent_session_hit integer
+   :type: counter
+
+   Incoming client SSL connections which successfully used a previously
+   negotiated session, since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.user_agent_session_miss integer
+   :type: counter
+
+   Incoming client SSL connections which unsuccessfully attempted to use a
+   previously negotiated session, since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.user_agent_sessions integer
+   :type: counter
+
+   A counter indicating the number of SSL sessions negotiated for incoming
+   client connections, since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.user_agent_session_timeout integer
+   :type: counter
+
+   Incoming client SSL connections which terminated with an expired session,
+   since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.user_agent_unknown_ca integer
+   :type: counter
+
+   Incoming client SSL connections which presented a client certificate signed
+   by an unrecognized Certificate Authority, since statistics collection began.
+
+.. ts:stat:: global proxy.process.ssl.user_agent_unknown_cert integer
+   :type: counter
+
+.. ts:stat:: global proxy.process.ssl.user_agent_wrong_version integer
+   :type: counter
+
+   Incoming client SSL connections terminated due to an unsupported or disabled
+   version of SSL/TLS, since staistics collection began.
+

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce162a6d/doc/admin-guide/monitoring/statistics/core/websocket.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/monitoring/statistics/core/websocket.en.rst b/doc/admin-guide/monitoring/statistics/core/websocket.en.rst
new file mode 100644
index 0000000..a29694e
--- /dev/null
+++ b/doc/admin-guide/monitoring/statistics/core/websocket.en.rst
@@ -0,0 +1,31 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+
+.. include:: ../../../../common.defs
+
+.. _admin-stats-core-websocket:
+
+WebSocket
+*********
+
+.. ts:stat:: global proxy.process.http.websocket.current_active_client_connections integer
+   :type: gauge
+   :ungathered:
+
+   Indicates the number of WebSockets connections to |TS| from clients which are
+   currently active.
+

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce162a6d/doc/admin-guide/monitoring/statistics/index.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/monitoring/statistics/index.en.rst b/doc/admin-guide/monitoring/statistics/index.en.rst
new file mode 100644
index 0000000..f8448de
--- /dev/null
+++ b/doc/admin-guide/monitoring/statistics/index.en.rst
@@ -0,0 +1,37 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+
+.. include:: ../../../common.defs
+
+.. _admin-stats:
+
+Statistics
+**********
+
+Statistics provide a live view into the current state of |TS| and many of the
+plugins which may be usd with it. They can, and generally should be, used as a
+core piece in any performance and operational monitoring infrastructure as they
+expose a much greater detail about the workings of |TS| than can reliably be
+obtained through any other means.
+
+.. toctree::
+   :maxdepth: 2
+
+   accessing.en
+   core-statistics.en
+   plugin-statistics.en
+

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce162a6d/doc/admin-guide/monitoring/statistics/plugin-statistics.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/monitoring/statistics/plugin-statistics.en.rst b/doc/admin-guide/monitoring/statistics/plugin-statistics.en.rst
new file mode 100644
index 0000000..7bf9b57
--- /dev/null
+++ b/doc/admin-guide/monitoring/statistics/plugin-statistics.en.rst
@@ -0,0 +1,24 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+
+.. include:: ../../../common.defs
+
+.. _admin-stats:
+
+Plugin Specific Statistics
+**************************
+

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce162a6d/doc/admin-guide/performance/index.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/performance/index.en.rst b/doc/admin-guide/performance/index.en.rst
new file mode 100644
index 0000000..4344ca9
--- /dev/null
+++ b/doc/admin-guide/performance/index.en.rst
@@ -0,0 +1,292 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+
+.. include:: ../../common.defs
+
+.. _performance-tuning:
+
+Performance Tuning
+******************
+
+|ATS| in its default configuration should perform suitably for running the
+included regression test suite, but will need special attention to both its own
+configuration and the environment in which it runs to perform optimally for
+production usage.
+
+There are numerous options and strategies for tuning the performance of |TS|
+and we attempt to document as many of them as possible in the sections below.
+Because |TS| offers enough flexibility to be useful for many caching and
+proxying scenarios, which tuning strategies will be most effective for any
+given use case may differ, as well as the specific values for various
+configuration options.
+
+.. toctree::
+   :maxdepth: 2
+
+Before You Start
+================
+
+One of the most important aspects of any attempt to optimize the performance
+of a |TS| installation is the ability to measure that installation's
+performance; both prior to and after any changes are made. To that end, it is
+strongly recommended that you establish some means to monitor and record a
+variety of performance metrics: request and response speed, latency, and
+throughput; memory and CPU utilization; and storage I/O operations.
+
+Attempts to tune a system without being able to compare the impact of changes
+made will at best result in haphazard, *feel good* results that may end up
+having no real world impact on your customers' experiences, and at worst may
+even result in lower performance than before you started. Additionally, in the
+all too common situation of budget constraints, having proper measurements of
+existing performance will greatly ease the process of focusing on those
+individual components that, should they require hardware expenditures or larger
+investments of employee time, have the highest potential gains relative to
+their cost.
+
+Building Traffic Server
+=======================
+
+While the default compilation settings for |TS| will produce a set of binaries
+capable of serving most caching and proxying needs, there are some build
+options worth considering in specific environments.
+
+.. TODO::
+
+   - any reasons why someone wouldn't want to just go with distro packages?
+     (other than "distro doesn't package versions i want")
+   - list relevant build options, impact each can potentially have
+
+Hardware Tuning
+===============
+
+As with any other server software, efficient allocation of hardware resources
+will have a significant impact on |TS| performance.
+
+CPU Selection
+-------------
+
+|ATS| uses a hybrid event-driven engine and multi-threaded processing model for
+handling incoming requests. As such, it is highly scalable and makes efficient
+use of modern, multicore processor architectures.
+
+.. TODO::
+
+   any benchmarks showing relative req/s improvements between 1 core, 2 core,
+   N core? diminishing rate of return? can't be totally linear, but maybe it
+   doesn't realistically drop off within the currently available options (i.e.
+   the curve holds up pretty well all the way through current four socket xeon
+   8 core systems, so given a lack of monetary constraint, adding more cores
+   is a surefire performance improvement (up to the bandwidth limits), or does
+   it fall off earlier, or can any modern 4 core saturate a 10G network link
+   given fast enough disks?)
+
+Memory Allocation
+-----------------
+
+Though |TS| stores cached content within an on-disk host database, the entire
+:ref:`cache-directory` is always maintained in memory during server operation.
+Additionally, most operating systems will maintain disk caches within system
+memory. It is also possible, and commonly advisable, to maintain an in-memory
+cache of frequently accessed content.
+
+The memory footprint of the |TS| process is largely fixed at the time of server
+startup. Your |TS| systems will need at least enough memory to satisfy basic
+operating system requirements, as well as capacity for the cache directory, and
+any memory cache you wish to use. The default settings allocate roughly 10
+megabytes of RAM cache for every gigabyte of disk cache storage, though this
+setting can be adjusted manually in :file:`records.config` using the setting
+:ts:cv:`proxy.config.cache.ram_cache.size`. |TS| will, under the default
+configuration, adjust this automatically if your system does not have enough
+physical memory to accomodate the aforementioned target.
+
+Aside from the cost of physical memory, and necessary supporting hardware to
+make use of large amounts of RAM, there is little downside to increasing the
+memory allocation of your cache servers. You will see, however, no benefit from
+sizing your memory allocation larger than the sum of your content (and index
+overhead).
+
+Disk Storage
+------------
+
+Except in cases where your entire cache may fit into system memory, your cache
+nodes will eventually need to interact with their disks. While a more detailed
+discussion of storage stratification is covered in `Cache Partitioning`_ below,
+very briefly you may be able to realize gains in performance by separating
+more frequently accessed content onto faster disks (PCIe SSDs, for instance)
+while maintaining the bulk of your on-disk cache objects, which may not receive
+the same high volume of requests, on lower-cost mechanical drives.
+
+
+
+Operating System Tuning
+========================
+
+|ATS| is supported on a variety of operating systems, and as a result the tuning
+strategies available at the OS level will vary depending upon your chosen
+platform.
+
+General Recommendations
+-----------------------
+
+TCP Keep Alive
+~~~~~~~~~~~~~~
+
+TCP Congestion Control Settings
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Ephemeral and Reserved Ports
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Jumbo Frames
+~~~~~~~~~~~~
+
+.. TODO:: would they be useful/harmful/neutral for anything other than local forward/transparent proxies?
+
+Linux
+-----
+
+FreeBSD
+-------
+
+OmniOS / illumos
+----------------
+
+Mac OS X
+--------
+
+Traffic Server Tuning
+=====================
+
+|TS| itself, of course, has many options you may want to consider adjusting to
+achieve optimal performance in your environment. Many of these settings are
+recorded in :file:`records.config` and may be adjusted with the
+:option:`traffic_ctl config set` command line utility while the server is operating.
+
+CPU and Thread Optimization
+---------------------------
+
+Thread Scaling
+~~~~~~~~~~~~~~
+
+By default, |TS| creates 1.5 threads per CPU core on the host system. This may
+be adjusted with the following settings in :file:`records.config`:
+
+* :ts:cv:`proxy.config.exec_thread.autoconfig`
+* :ts:cv:`proxy.config.exec_thread.autoconfig.scale`
+* :ts:cv:`proxy.config.exec_thread.limit`
+
+Thread Affinity
+~~~~~~~~~~~~~~~
+
+On multi-socket servers, such as Intel architectures with NUMA, you can adjust
+the thread affinity configuration to take advantage of cache pipelines and
+faster memory access, as well as preventing possibly costly thread migrations
+across sockets. This is adjusted with :ts:cv:`proxy.config.exec_thread.affinity`
+in :file:`records.config`. ::
+
+    CONFIG proxy.config.exec_thread.affinity INT 1
+
+Thread Stack Size
+~~~~~~~~~~~~~~~~~
+
+:ts:cv:`proxy.config.thread.default.stacksize`
+
+.. TODO::
+
+   is there ever a need to fiddle with this, outside of possibly custom developed plugins?
+
+Polling Timeout
+~~~~~~~~~~~~~~~
+
+If you are experiencing unusually or unacceptably high CPU utilization during
+idle workloads, you may consider adjusting the polling timeout with
+:ts:cv:`proxy.config.net.poll_timeout`::
+
+    CONFIG proxy.config.net.poll_timeout INT 60
+
+Memory Optimization
+-------------------
+
+:ts:cv:`proxy.config.thread.default.stacksize`
+:ts:cv:`proxy.config.cache.ram_cache.size`
+
+
+Disk Storage Optimization
+-------------------------
+
+:ts:cv:`proxy.config.cache.force_sector_size`
+:ts:cv:`proxy.config.cache.max_doc_size`
+:ts:cv:`proxy.config.cache.target_fragment_size`
+
+Cache Partitioning
+~~~~~~~~~~~~~~~~~~
+
+Network Tuning
+--------------
+
+:ts:cv:`proxy.config.net.connections_throttle`
+
+Error responses from origins are conistent and costly
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If error responses are costly for your origin server to generate, you may elect
+to have |TS| cache these responses for a period of time. The default behavior is
+to consider all of these responses to be uncacheable, which will lead to every
+client request to result in an origin request.
+
+This behavior is controlled by both enabling the feature via
+:ts:cv:`proxy.config.http.negative_caching_enabled` and setting the cache time
+(in seconds) with :ts:cv:`proxy.config.http.negative_caching_lifetime`. ::
+
+    CONFIG proxy.config.http.negative_caching_enabled INT 1
+    CONFIG proxy.config.http.negative_caching_lifetime INT 10
+
+SSL-Specific Options
+~~~~~~~~~~~~~~~~~~~~
+
+:ts:cv:`proxy.config.ssl.max_record_size`
+:ts:cv:`proxy.config.ssl.session_cache`
+:ts:cv:`proxy.config.ssl.session_cache.size`
+
+Thread Types
+------------
+
+Logging Configuration
+---------------------
+
+.. TODO::
+
+   binary vs. ascii output
+   multiple log formats (netscape+squid+custom vs. just custom)
+   overhead to log collation
+   using direct writes vs. syslog target
+
+Plugin Tuning
+=============
+
+Common Scenarios and Pitfalls
+=============================
+
+While environments vary widely and |TS| is useful in a great number of different
+situations, there are at least some recurring elements that may be used as
+shortcuts to identifying problem areas, or realizing easier performance gains.
+
+.. TODO::
+
+   - origins not sending proper expiration headers (can fix at the origin (preferable) or use proxy.config.http.cache.heuristic_(min|max)_lifetime as hacky bandaids)
+   - cookies and http_auth prevent caching
+   - avoid thundering herd with read-while-writer (link to section in http-proxy-caching)

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce162a6d/doc/admin-guide/plugins/authproxy.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/plugins/authproxy.en.rst b/doc/admin-guide/plugins/authproxy.en.rst
new file mode 100644
index 0000000..d4a5e19
--- /dev/null
+++ b/doc/admin-guide/plugins/authproxy.en.rst
@@ -0,0 +1,110 @@
+.. _authproxy-plugin:
+
+AuthProxy Plugin
+****************
+
+.. Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License.
+
+There are many ways of authorizing an HTTP request. Often, this
+requires making IPC calls to some internal infrastructure. ``AuthProxy``
+is a plugin that takes care of the Traffic Server end of authorizing
+a request and delegates the authorization decision to an external
+HTTP service.
+
+This plugin can be used as either a global plugin or a remap plugin.
+
+Note that Traffic Server optimizes latency by skipping the DNS
+lookup state if a document is found in the cache. This will have
+the effect of serving the document without consulting the ``AuthProxy``
+plugin. you can disable this behavior by setting
+:ts:cv:`proxy.config.http.doc_in_cache_skip_dns` to ``0`` in
+:file:`records.config`.
+
+Note that the authorization request will need to match a remap rule 
+(which, as a standalone remap rule, does not need to call the 
+AuthProxy plugin). If a second remap rule is required, by default,
+the authorization request will not have the same Host header as 
+the request from the client. It could be added using the 
+``header_rewrite`` plugin (set-header Host "pristine_host.example.com").
+
+Plugin Options
+--------------
+
+--auth-transform=TYPE
+  This option specifies how to route the incoming request to the
+  authorization service. The transform type may be ``head`` or
+  ``redirect``.
+
+  If the transform type is ``head``, then the incoming request is
+  transformed to a HEAD request and is sent to the same destination.
+  If the response is ``200 OK``, the incoming request is allowed
+  to proceed.
+
+  If the transform type is ``range``, then the incoming request is
+  transformed to a Range request asking for 0 bytes. Other than that,
+  the behavior is identical to the ``head`` option above. This type
+  of Range request is useful when the upstream destination is a cache,
+  and it's not able to cache HEAD requests.
+
+  If the transform type is ``redirect`` then the incoming
+  request is sent to the authorization service designated by the
+  `--auth-host` and `--auth-port` parameters. If the response is
+  200 OK, the incoming request is allowed to proceed.
+
+  When the authorization service responds with a status other than
+  200 OK, that response is returned to the client as the response to
+  the incoming request. This allows mechanisms such as HTTP basic
+  authentication to work correctly. Note that the body of the
+  authorization service response is not returned to the client.
+
+--auth-host=HOST
+  The name or address of the authorization host. This is only used
+  by the ``redirect`` transform.
+
+--auth-port=PORT
+  The TCP port of the authorization host. This is only used by the
+  ``redirect`` transform.
+
+--force-cacheability
+  If this options is set, the plugin will allow Traffic Server to
+  cache the result of authorized requests. In the normal case, requests
+  with authorization headers are nor cacheable, but this flag allows
+  that by setting the :ts:cv:`proxy.config.http.cache.ignore_authentication`
+  option on the request.
+
+Examples
+--------
+
+In this example, the authentication is performed by converting the incoming
+HTTP request to a `HEAD` request and sending that to the origin server
+`origin.internal.com`::
+
+  map http://cache.example.com http://origin.internal.com/ \
+    @plugin=authproxy.so @pparam=--auth-transform=head
+
+  map http://origin.internal.com http://origin.internal.com/ 
+
+
+In this example, the request is directed to a local authentication server
+that authorizes the request based on internal policy rules::
+
+  map http://cache.example.com http://origin.internal.com/ \
+    @plugin=authproxy.so @pparam=--auth-transform=redirect @pparam=--auth-host=127.0.0.1 @pparam=--auth-port=9000
+
+  map http://origin.internal.com/ http://origin.internal.com/ \
+    @plugin=authproxy.so @pparam=--auth-transform=redirect @pparam=--auth-host=127.0.0.1 @pparam=--auth-port=9000    


Mime
View raw message