logs.xml.es

Apache HTTP Server 是一个功能强大的灵活的与HTTP/1.1相兼容的web服务器.这里给出的是Apache HTTP服务器的源码。

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.es.xsl"?>
<!-- English Revision: 151405 -->

<!--
 Copyright 2005 The Apache Software Foundation or it licensors,
                as applicable.

 Licensed 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.
-->

<manualpage metafile="logs.xml.meta">

  <title>Archivos de Registro (Log Files)</title>

  <summary>
    <p>Para administrar de manera efectiva un servidor web, es
    necesario tener registros de la actividad y el rendimiento del
    servidor as&#237; como de cualquier problema que haya podido
    ocurrir durante su operaci&#243;n. El servidor HTTP Apache ofrece
    capacidades muy amplias de registro de este tipo de
    informaci&#243;n. Este documento explica c&#243;mo configurar esas
    capacidades de registro, y c&#243;mo comprender qu&#233;
    informaci&#243;n contienen los ficheros de registro.</p>
  </summary>

  <section id="security">
    <title>Advertencia de seguridad</title>

    <p>Cualquiera que tenga permisos de escritura sobre el directorio
    en el que Apache est&#233; escribiendo un archivo de registro
    puede con casi toda seguridad tener acceso al identificador de
    usuario con el que se inici&#243; el servidor, normalmente
    root. <em>NO</em> le de a nadie permisos de escritura sobre el
    directorio en que se almacenan los ficheros de registro sin tener
    en cuenta las consecuencias; consulte los <a
    href="misc/security_tips.html">consejos de seguridad</a> para
    obtener m&#225;s informaci&#243;n.</p>

    <p>Adem&#225;s, los ficheros de registro pueden contener
    informaci&#243;n suministrada directamente por el cliente, sin
    sustituir. Es posible por tanto que clientes con malas intenciones
    inserten caracteres de control en los ficheros de registro. Por
    ello es necesario tener cuidado cuando se procesan los ficheros de
    registro originales.</p>
  </section>

  <section id="errorlog">
    <title>Registro de Errores (Error Log)</title>

    <related>
      <directivelist>
        <directive module="core">ErrorLog</directive>
        <directive module="core">LogLevel</directive>
      </directivelist>
    </related>

    <p>El registro de errores del servidor, cuyo nombre y
    ubicaci&#243;n se especifica en la directiva <directive
    module="core">ErrorLog</directive>, es el m&#225;s importante de
    todos los registros. Apache enviar&#225; cualquier
    informaci&#243;n de diagn&#243;stico y registrar&#225; cualquier
    error que encuentre al procesar peticiones al archivo de registro
    seleccionado. Es el primer lugar donde tiene que mirar cuando
    surja un problema al iniciar el servidor o durante su
    operaci&#243;n normal, porque con frecuencia encontrar&#225; en
    &#233;l informaci&#243;n detallada de qu&#233; ha ido mal y
    c&#243;mo solucionar el problema.</p>

    <p>El registro de errores se escribe normalmente en un fichero
    (cuyo nombre suele ser <code>error_log</code> en sistemas Unix y
    <code>error.log</code> en Windows y OS/2). En sistemas Unix
    tambi&#233;n es posible hacer que el servidor env&#237;e los
    mensajes de error al <code>syslog</code> o <a
    href="#piped">pasarlos a un programa</a>.</p>

    <p>El formato del registro de errores es relativamente libre y
    descriptivo. No obstante, hay cierta informaci&#243;n que se
    incluye en casi todas las entradas de un registro de errores. Por
    ejemplo, este es un mensaje t&#237;pico.</p>

    <example>
      [Wed Oct 11 14:32:52 2000] [error] [client 127.0.0.1]
      client denied by server configuration:
      /export/home/live/ap/htdocs/test
    </example>

    <p>El primer elemento de la entrada es la fecha y la hora del
    mensaje. El segundo elemento indica la gravedad del error que se
    ha producido. La directiva <directive
    module="core">LogLevel</directive> se usa para controlar los tipos
    de errores que se env&#237;an al registro de errores seg&#250;n su
    gravedad. La tercera parte contiene la direcci&#243;n IP del
    cliente que gener&#243; el error. Despu&#233;s de la direcci&#243;n
    IP est&#225; el mensaje de error propiamente dicho, que en este
    caso indica que el servidor ha sido configurado para denegar el
    acceso a ese cliente. El servidor reporta tambi&#233;n la ruta en
    el sistema de ficheros (en vez de la ruta en el servidor
    web) del documento solicitado.</p>

    <p>En el registro de errores puede aparecer una amplia variedad de
    mensajes diferentes. La mayor&#237;a tienen un aspecto similar al
    del ejemplo de arriba. El registro de errores tambi&#233;n
    contiene mensaje de depuraci&#243;n de scripts CGI. Cualquier
    informaci&#243;n escrita en el <code>stderr</code> por un script
    CGI se copiar&#225; directamente en el registro de errores.</p>

    <p>El registro de errores no se puede personalizar a&#241;adiendo
    o quitando informaci&#243;n. Sin embargo, las entradas del
    registro de errores que se refieren a determinadas peticiones
    tienen sus correspondientes entradas en el <a
    href="#accesslog">registro de acceso</a>. El ejemplo de arriba se
    corresponde con una entrada en el registro de acceso que
    tendr&#225; un c&#243;digo de estado 403. Como es posible
    personalizar el registro de acceso, puede obtener m&#225;s
    informaci&#243;n sobre los errores que se producen usando ese
    registro tambi&#233;n.</p>

    <p>Si hace pruebas, suele ser de utilidad monitorizar de forma
    continua el registro de errores para comprobar si ocurre
    alg&#250;n problema. En sistemas Unix, puede hacer esto
    usando:</p>

    <example>
      tail -f error_log
    </example>
  </section>

  <section id="accesslog">
    <title>Registro de Acceso (Access Log)</title>

    <related>
      <modulelist>
        <module>mod_log_config</module>
        <module>mod_setenvif</module>
      </modulelist>
      <directivelist>
        <directive module="mod_log_config">CustomLog</directive>
        <directive module="mod_log_config">LogFormat</directive>
        <directive module="mod_setenvif">SetEnvIf</directive>
      </directivelist>
    </related>

    <p>El servidor almacena en el registro de acceso informaci&#243;n
    sobre todas las peticiones que procesa. La ubicaci&#243;n del
    fichero de registro y el contenido que se registra se pueden
    modificar con la directiva <directive
    module="mod_log_config">CustomLog</directive>. Puede usar la
    directiva <directive module="mod_log_config">LogFormat</directive>
    para simplificar la selecci&#243;n de los contenidos que quiere
    que se incluyan en los registros. Esta secci&#243;n explica como
    configurar el servidor para que registre la informaci&#243;n que
    usted considere oportuno en el registro de acceso.</p>

    <p>Por supuesto, almacenar informaci&#243;n en el registro de
    acceso es solamente el principio en la gesti&#243;n de los
    registros. El siguiente paso es analizar la informaci&#243;n que
    contienen para producir estad&#237;sticas que le resulten de
    utilidad. Explicar el an&#225;lisis de los registros en general
    est&#225; fuera de los prop&#243;sitos de este documento, y no es
    propiamente una parte del trabajo del servidor web. Para m&#225;s
    informaci&#243;n sobre este tema, y para aplicaciones que analizan
    los registros, puede visitar
    <a
    href="http://dmoz.org/Computers/Software/Internet/Site_Management/Log_analysis/">
    Open Directory</a> o <a
    href="http://dir.yahoo.com/Computers_and_Internet/Software/Internet/World_Wide_Web/Servers/Log_Analysis_Tools/">
    Yahoo</a>.</p>

    <p>Diferentes versiones de Apache httpd han usado otros
    m&#243;dulos y directivas para controlar la informaci&#243;n que
    se almacena en el registro de acceso, incluyendo mod_log_referer,
    mod_log_agent, y la directiva <code>TransferLog</code>. Ahora la
    directiva <directive module="mod_log_config">CustomLog</directive>
    asume toda la funcionalidad que antes estaba repartida.</p>

    <p>El formato del registro de acceso es altamente configurable. El
    formato se especifica usando una cadena de caracteres de formato
    similar a las de printf(1) en lenguaje C. Hay algunos ejemplos en
    las siguientes secciones. Si quiere una lista completa de los
    posibles contenidos que se pueden incluir, consulte la
    documentaci&#243; sobre <a
    href="mod/mod_log_config.html#formats">las cadenas de caracteres
    de formato</a> del <module>mod_log_config</module>.</p>

    <section id="common">
      <title>Formato Com&#250;n de Registro (Common Log
      Format)</title>

      <p>Una configuraci&#243;n t&#237;pica del registro de acceso
      podr&#237;a tener un aspecto similar a este.</p>

      <example>
        LogFormat "%h %l %u %t \"%r\" %&gt;s %b" common<br />
         CustomLog logs/access_log common
      </example>

      <p>Con esto se define el <em>apodo (nickname)</em> <code>common</code> y se
      le lo asocia con un determinado formato. El formato consiste en
      una serie de directivas con tantos por ciento, cada una de las
      cuales le dice al servidor que registre una determinada
      informaci&#243;n en particular. El formato tambi&#233;n puede
      incluir caracteres literales, que se copiar&#225;n directamente
      en el registro. Si usa el caracter comillas (<code>"</code>)
      debe anteponerle una barra invertida para evitar que sea
      interpretado como el final la cadena de caracteres a
      registrar. El formato que especifique tambi&#233;n puede
      contener los caracteres de control especiales "<code>\n</code>"
      para salto de l&#237;nea y "<code>\t</code>" para tabulador.</p>

      <p>La directiva <directive
	  module="mod_log_config">CustomLog</directive> crea un nuevo
	  fichero de registro usando el <em>apodo</em> definido. El
	  nombre del fichero de registro de acceso se asume que es
	  relativo al valor especificado en <directive
	  module="core">ServerRoot</directive> a no ser que empiece
	  por una barra (/).</p>

      <p>La configuraci&#243;n de arriba escribir&#225; las entradas