#
# 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.
#
msgid ""
msgstr ""
"Project-Id-Version: Apache Traffic Server 4.1\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2013-11-08 17:57+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"

#: ../../reference/configuration/logs_xml.config.en.rst:20
msgid "logs_xml.config"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:24
msgid ""
"The :file:`logs_xml.config` file defines the custom log file formats, "
"filters, and processing options. The format of this file is modeled after "
"XML, the Extensible Markup Language."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:29
msgid "Format"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:31
msgid "The :file:`logs_xml.config` file contains the specifications below:"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:33
msgid ""
"``LogFormat`` specifies the fields to be gathered from each protocol event "
"access."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:35
msgid ""
"``LogFilter`` specifies the filters that are used to include or exclude "
"certain entries being logged based on the value of a field within that "
"entry."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:38
msgid ""
"``LogObject`` specifies an object that contains a particular format, a "
"local filename, filters, and collation servers."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:41
msgid ""
"The :file:`logs_xml.config` file ignores extra white space, blank lines, "
"and all comments."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:47
msgid "LogFormat"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:49
msgid "The following list shows ``LogFormat`` specifications."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:57
msgid "``<Name = \"valid_format_name\"/>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:54
msgid ""
"Required Valid format names include any name except ``squid``, ``common``, "
"``extended``, or ``extended2``, which are pre-defined formats. There is no "
"default for this tag."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:78
msgid "``<Format = \"valid_format_specification\"/>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:62
msgid ""
"Required A valid format specification is a printf-style string describing "
"each log entry when formatted for ASCII output. Use ``%<`` ``field`` ``>`` "
"as a placeholder for valid field names. For more information, refer to :ref:"
"`custom-logging-fields`."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:68
msgid "The specified field can be one of the following types:"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:70
msgid ""
"Simple. For example: ``%<cqu>`` A field within a container, such as an HTTP "
"header or a statistic. Fields of this type have the syntax: ::"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:76
msgid ""
"Aggregates, such as ``COUNT``, ``SUM``, ``AVG``, ``FIRST``, ``LAST``. "
"Fields of this type have the syntax: ``%<operator (`` ``field`` ``)>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:82
msgid ""
"You cannot create a format specification that contains both aggregate "
"operators and regular fields."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:96
msgid "``<Interval = \"aggregate_interval_secs\"/>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:85
msgid ""
"Optional Use this tag when the format contains aggregate operators. The "
"value \"``aggregate_interval_secs``\\\" represents the number of seconds "
"between individual aggregate values being produced."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:90
msgid "The valid set of aggregate operators are:"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:92
msgid "COUNT"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:93
msgid "SUM"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:94
msgid "AVG"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:95
msgid "FIRST"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:96
msgid "LAST"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:101
msgid "LogFilters"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:103
msgid "The following list shows the ``LogFilter`` specifications."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:107
msgid "``<Name = \"valid_filter_name\"/>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:106
msgid "Required All filters must be uniquely named."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:131
msgid ""
"``<Condition = \"valid_log_field valid_operator valid_comparison_value\"/>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:110
msgid "Required This field contains the following elements:"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:113
msgid ""
"``valid_log_field`` - the field that will be compared against the given "
"value. For more information, refer to :ref:`logging-format-cross-reference`."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:116
msgid ""
"``valid_operator_field`` - any one of the following: ``MATCH``, "
"``CASE_INSENSITIVE_MATCH``, ``CONTAIN``, ``CASE_INSENSITIVE_CONTAIN``."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:120
msgid ""
"``MATCH`` is true if the field and value are identical (case-sensitive)."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:122
msgid ""
"``CASE_INSENSITIVE_MATCH`` is similar to ``MATCH``, except that it is case-"
"insensitive."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:124
msgid ""
"``CONTAIN`` is true if the field contains the value (the value is a "
"substring of the field)."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:126
msgid ""
"``CASE_INSENSITIVE_CONTAIN`` is a case-insensitive version of ``CONTAIN``."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:129
msgid ""
"``valid_comparison_value`` - any string or integer matching the field type. "
"For integer values, all of the operators are equivalent and mean that the "
"field must be equal to the specified value."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:135
msgid ""
"There are no negative comparison operators. If you want to specify a "
"negative condition, then use the ``Action`` field to ``REJECT`` the record."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:142
msgid "``<Action = \"valid_action_field\"/>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:140
msgid ""
"Required: ``ACCEPT`` or ``REJECT`` . This instructs Traffic Server to "
"either accept or reject records that satisfy the filter condition."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:147
msgid "LogObject"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:149
msgid "The following list shows the ``LogObject`` specifications."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:156
msgid "``<Format = \"valid_format_name\"/>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:152
msgid ""
"Required Valid format names include the predefined logging formats: "
"``squid``, ``common``, ``extended``, and ``extended2``, as well as any "
"previously-defined custom log formats. There is no default for this tag."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:171
msgid "``<Filename = \"file_name\"/>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:159
msgid ""
"Required The filename to which the given log file is written on the local "
"file system or on a remote collation server. No local log file will be "
"created if you fail to specify this tag. All filenames are relative to the "
"default logging directory."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:170
msgid ""
"If you do not want an extension to be added, then end the filename with a "
"single (.) dot (for example: ``squid.`` )."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:199
msgid "``<Mode = \"valid_logging_mode\"/>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:176
msgid ""
"Optional Valid logging modes include ``ascii`` , ``binary`` , and "
"``ascii_pipe`` . The default is ``ascii`` ."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:180
msgid ""
"Use ``ascii`` to create event log files in human-readable form (plain "
"ASCII)."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:182
msgid ""
"Use ``binary`` to create event log files in binary format. Binary log files "
"generate lower system overhead and occupy less space on the disk (depending "
"on the information being logged). You must use the :program:"
"`traffic_logcat` utility to translate binary log files to ASCII format "
"before you can read them."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:187
msgid ""
"Use ``ascii_pipe`` to write log entries to a UNIX named pipe (a buffer in "
"memory). Other processes can then read the data using standard I/O "
"functions. The advantage of using this option is that Traffic Server does "
"not have to write to disk, which frees disk space and bandwidth for other "
"tasks. In addition, writing to a pipe does not stop when logging space is "
"exhausted because the pipe does not use disk space."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:195
msgid ""
"If you are using a collation server, then the log is written to a pipe on "
"the collation server. A local pipe is created even before a transaction is "
"processed, so you can see the pipe right after Traffic Server starts. Pipes "
"on a collation server, however, *are* created when Traffic Server starts."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:205
msgid "``<Filters = \"list_of_valid_filter_names\"/>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:202
msgid ""
"Optional A comma-separated list of names of any previously-defined log "
"filters. If more than one filter is specified, then all filters must accept "
"a record for the record to be logged."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:211
msgid "``<Protocols = \"list_of_valid_protocols\"/>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:208
msgid ""
"Optional A comma-separated list of the protocols this object should log. "
"Valid protocol names for this release are ``HTTP`` (FTP is deprecated)."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:216
msgid "``<ServerHosts = \"list_of_valid_servers\"/>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:214
msgid ""
"Optional A comma-separated list of valid hostnames.This tag indicates that "
"only entries from the named servers will be included in the file."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:237
msgid "``<Header = \"header\"/>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:234
msgid ""
"Optional The header text you want the log files to contain. The header text "
"appears at the beginning of the log file, just before the first record."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:257
msgid "``<RollingEnabled = \"truth value\"/>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:240
msgid ""
"Optional Enables or disables log file rolling for the ``LogObject``. This "
"setting overrides the value for the :ts:cv:`proxy.config.log."
"rolling_enabled` variable in the :file:`records.config` file. Set *truth "
"value* to one of the following values:"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:247
msgid "``0`` to disable rolling for this particular ``LogObject``."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:248
msgid ""
"``1`` to roll log files at specific intervals during the day (you specify "
"time intervals with the ``RollingIntervalSec`` and ``RollingOffsetHr`` "
"fields)."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:251
msgid ""
"``2`` to roll log files when they reach a certain size (you specify the "
"size with the ``RollingSizeMb`` field)."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:253
msgid ""
"``3`` to roll log files at specific intervals during the day or when they "
"reach a certain size (whichever occurs first)."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:255
msgid ""
"``4`` to roll log files at specific intervals during the day when log files "
"reach a specific size (at a specified time if the file is of the specified "
"size)."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:269
msgid "``<RollingIntervalSec = \"seconds\"/>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:262
msgid ""
"Optional The seconds between log file rolling for the ``LogObject``; "
"enables you to specify different rolling intervals for different "
"``LogObjects``."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:267
msgid ""
"This setting overrides the value for :ts:cv:`proxy.config.log."
"rolling_interval_sec` in the :file:`records.config` file."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:279
msgid "``<RollingOffsetHr = \"hour\"/>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:272
msgid ""
"Optional Specifies an hour (from 0 to 23) at which rolling is guaranteed to "
"align. Rolling might start before then, but a rolled file will be produced "
"only at that time. The impact of this setting is only noticeable if the "
"rolling interval is larger than one hour. This setting overrides the "
"configuration setting for :ts:cv:`proxy.config.log.rolling_offset_hr` in "
"the :file:`records.config` file."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:283
msgid "``<RollingSizeMb = \"size_in_MB\"/>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:282
msgid "Optional The size at which log files are rolled."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:286
msgid "Examples"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:288
msgid ""
"The following is an example of a ``LogFormat`` specification that collects "
"information using three common fields: ::"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:296
msgid ""
"The following is an example of a ``LogFormat`` specification that uses "
"aggregate operators: ::"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:305
msgid ""
"The following is an example of a ``LogFilter`` that will cause only "
"``REFRESH_HIT`` entries to be logged: ::"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:316
msgid ""
"When specifying the field in the filter condition, you can omit the ``"
"%<>``. This means that the filter below is equivalent to the example "
"directly above: ::"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:326
msgid ""
"The following is an example of a ``LogObject`` specification that creates a "
"local log file for the minimal format defined earlier. The log filename "
"will be ``minimal.log`` because this is an ASCII log file (the default).::"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:336
msgid ""
"The following is an example of a ``LogObject`` specification that includes "
"only HTTP requests served by hosts in the domain ``company.com`` or by the "
"specific server ``server.somewhere.com``. Log entries are sent to port 4000 "
"of the collation host ``logs.company.com`` and to port 5000 of the "
"collation host ``209.131.52.129.`` ::"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:353
msgid "WELF"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:355
msgid ""
"Traffic Server supports WELF (WebTrends Enhanced Log Format) so you can "
"analyze Traffic Server log files with WebTrends reporting tools. A "
"predefined ``<LogFormat>`` that is compatible with WELF is provided in the :"
"file:`logs_xml.config` file (shown below). To create a WELF format log "
"file, create a ``<LogObject>`` that uses this predefined format. ::"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:231
msgid ""
"``<CollationHosts = \"list_of_valid_hostnames:port|failover hosts\"/>``"
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:221
msgid ""
"Optional A comma-separated list of collation servers (with pipe delimited "
"failover servers) to which all log entries (for this object) are forwarded. "
"Collation servers can be specified by name or IP address. Specify the "
"collation port with a colon after the name. For example, in ``host1:5000|"
"failhostA:5000|failhostB:6000, host2:6000`` logs would be sent to host1 and "
"host2, with failhostA and failhostB acting as failover hosts for host1. "
"When host1 disconnects, logs would be sent to failhostA. If failhostA "
"disconnects, log entries would be sent to failhostB until host1 or "
"failhostA comes back. Logs would also be sent to host2."
msgstr ""

#: ../../reference/configuration/logs_xml.config.en.rst:165
msgid ""
"If the name does not contain an extension (for example, ``squid``), then "
"the extension ``.log`` is automatically appended to it for ASCII logs and "
"``.blog`` for binary logs (refer to :ref:`Mode = \"valid_logging_mode\" "
"<LogObject-Mode>`)."
msgstr ""
