# 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.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Apache Traffic Server 6.2\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2016-06-30 14:07+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.2.0\n"

#: ../../../admin-guide/monitoring/statistics/accessing.en.rst:23
msgid "Accessing Statistics"
msgstr ""

#: ../../../admin-guide/monitoring/statistics/accessing.en.rst:25
msgid ""
"There are currently two methods provided with |TS| to view statistics: :ref:"
"`admin-stats-traffic-line` and :ref:`admin-stats-stats-over-http`."
msgstr ""

#: ../../../admin-guide/monitoring/statistics/accessing.en.rst:31
msgid "Traffic Line"
msgstr ""

#: ../../../admin-guide/monitoring/statistics/accessing.en.rst:33
msgid ""
"The command line utility :program:`traffic_ctl` offers a text based "
"interface for viewing |TS| statistics. Invocation is simple and requires "
"knowing the specific name of the statistic you wish you view::"
msgstr ""

#: ../../../admin-guide/monitoring/statistics/accessing.en.rst:39
msgid ""
"You may notice that this is the same utility, and argument, used for "
"viewing configuration variables of a running |TS| instance. Unlike "
"configuration variables, you cannot modify a statistic value with the :"
"program:`traffic_ctl` program."
msgstr ""

#: ../../../admin-guide/monitoring/statistics/accessing.en.rst:44
msgid ""
"This utility is enabled and built by default, and will be located in the "
"``bin/`` subdirectory of your |TS| installation. There are no required "
"changes to your configuration to allow :program:`traffic_ctl` to function, "
"however it may only be run by users with permissions to access the |TS| "
"Unix socket. This will typically limit use to root as well as the system "
"user you have configured |TS| to run under or any other system users which "
"share the same group as you have configured |TS| to use."
msgstr ""

#: ../../../admin-guide/monitoring/statistics/accessing.en.rst:55
msgid "Stats Over HTTP"
msgstr ""

#: ../../../admin-guide/monitoring/statistics/accessing.en.rst:57
msgid ""
"|TS| includes a stable plugin, :ref:`admin-plugins-stats-over-http`, which "
"provides HTTP access to all |TS| statistcs. The plugin returns a JSON "
"object with all statistics and their current values. It is not possible to "
"return a subset of the statistics. The plugin must be enabled before you "
"may use it."
msgstr ""

#: ../../../admin-guide/monitoring/statistics/accessing.en.rst:65
msgid "Enabling Stats Over HTTP"
msgstr ""

#: ../../../admin-guide/monitoring/statistics/accessing.en.rst:67
msgid ""
"To enable the :ref:`admin-plugins-stats-over-http` plugin, you must add the "
"following to your :file:`plugin.config`::"
msgstr ""

#: ../../../admin-guide/monitoring/statistics/accessing.en.rst:72
msgid ""
"Once the plugin is enabled and |TS| has reloaded, you can test that it is "
"working properly by issuing a simple HTTP request with ``curl``. Assuming "
"your |TS| installation is using the default interface and port bindings, "
"running the following command on the same host as |TS| should now work::"
msgstr ""

#: ../../../admin-guide/monitoring/statistics/accessing.en.rst:79
msgid ""
"You should be presented with an HTTP response containing a single JSON "
"object which lists all the available statistics and their current values. "
"If you have configured |TS| to only listen on a specific interface, or to "
"use a different port, you may need to adjust the URL in the command above."
msgstr ""

#: ../../../admin-guide/monitoring/statistics/accessing.en.rst:84
msgid ""
"If you wish to have the stats made available at a non-default path, then "
"that path should be given as the sole argument to the plugin, as so::"
msgstr ""

#: ../../../admin-guide/monitoring/statistics/accessing.en.rst:89
msgid ""
"The above :file:`plugin.config` entry will result in your |TS| statistics "
"being located at ``/81c075bc0cca1435ea899ba4ad72766b`` on any host and port "
"on which you have your |TS| instance listening."
msgstr ""

#: ../../../admin-guide/monitoring/statistics/accessing.en.rst:96
msgid "Statistics Security and Privacy"
msgstr ""

#: ../../../admin-guide/monitoring/statistics/accessing.en.rst:98
msgid ""
"Simply changing the path at which your statistics are available should be "
"considered very weak security. While cache objects themselves cannot be "
"accessed through the plugin's JSON output, and no modifications to the "
"configuration or operation of |TS| may be made through the plugin, the "
"statistics may reveal much more about your network's traffic and "
"architecture than you wish to be publicly available."
msgstr ""

#: ../../../admin-guide/monitoring/statistics/accessing.en.rst:105
msgid ""
"A better method is to use an :ref:`ACL Filter <remap-config-named-filters>` "
"in :file:`remap.config` to restrict access to clients. For instance, if "
"your |TS| host resides on a private network in the 10.1.1.0/24 IPv4 address "
"space listening on the address 10.1.1.10, separate from its public "
"interface(s) used to serve client requests, you could add the following "
"remap configuration::"
msgstr ""

#: ../../../admin-guide/monitoring/statistics/accessing.en.rst:114
msgid ""
"The above configuration sets the default policy for the entirety of IPv4 "
"address space to deny, but then exempts the 10.1.1.0/24 network by "
"permitting their requests to be processed by |TS|. If your monitoring "
"infrastructure makes use of locally-installed data collection agents, you "
"may even wish to restrict access to the Stats Over HTTP plugin to all but "
"localhost."
msgstr ""
