logs.xml.es

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

      en el registro con el formato conocido como Formato Común
      de Registro (CLF). Este formato estándar lo pueden generar
      muchos servidores web diferentes y lo pueden leer muchos de los
      progrmas que analizan registros. Las entradas de un fichero de
      registro que respetan ese formato común tienen una
      aparariencia parecida es esta:</p>

      <example>
        127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
        /apache_pb.gif HTTP/1.0" 200 2326
      </example>

      <p>Cada una de las partes de la entrada se explican a
      continuaci#243;n.</p>

      <dl>
        <dt><code>127.0.0.1</code> (<code>%h</code>)</dt>

        <dd>Es la direcci&#243;n IP del cliente (host remoto) que hizo
        la petici&#243;n al servidor. Si la directiva <directive
        module="core">HostnameLookups</directive> tiene valor
        <code>On</code>, el servidor intentar&#225; determinar el
        nombre del host y registrar ese nombre en lugar de la
        direcci&#243;n IP. Sin embargo, no se recomienda que use esta
        configuraci&#243;n porque puede ralentizar significativamente
        las operaciones del servidor. En su lugar, es mejor usar un
        programa que realice esta tarea posteriormente sobre el
        registro, por ejemplo <program>logresolve</program>. Las
        direcciones IP que se registren no son necesariamente las
        direcciones de las m&#225;quinas de los usuarios finales. Si
        existe un servidor proxy entre el usuario final y el servidor,
        la direcci&#243;n que se registra es la del proxy.</dd>

        <dt><code>-</code> (<code>%l</code>)</dt>

        <dd>Un "gui&#243;n" siginifica que la informaci&#243;n que
        deber&#237;a ir en ese lugar no est&#225; disponible. En este
        caso, esa informaci&#243;n es la identidad RFC 1413 del
        cliente determinada por <code>identd</code> en la m&#225;quina
        del cliente. Esta informaci&#243;n es muy poco fiable y no
        deber&#237;a ser usada nunca excepto con clientes que
        est&#233;n sometidos a controles muy estrictos en redes
        internas. Apache httpd ni siquiera intenta recoger esa
        informaci&#243;n a menos que la directiva <directive
        module="core">IdentityCheck</directive> tenga valor
        <code>On</code>.</dd>

        <dt><code>frank</code> (<code>%u</code>)</dt>

        <dd>Este es el identificador de usuario de la persona que
        solicita el documento determinado por la autentificaci&#243;n
        HTTP. Normalmente ese mismo valor se pasa a los scripts CGI
        con la variable de entorno <code>REMOTE_USER</code>. Si el
        c&#243;digo de estado de la petici&#243;n (ver abajo) es 401,
        entonces no debe confiar en la veracidad de ese dato porque el
        usuario no ha sido a&#250;n autentificado. Si el documento no
        est&#225; protegido por contrase&#241;a, se mostrar&#225; un
        gui&#243;n "<code>-</code>" en esta entrada.</dd>

        <dt><code>[10/Oct/2000:13:55:36 -0700]</code>
        (<code>%t</code>)</dt>

        <dd>
          La hora a la que el servidor termin&#243; de procesar la
          petici&#243;n. El formato es:

          <p class="indent">
            <code>[d&#237;a/mes/a&#241;o:hora:minuto:segundo zona_horaria]<br />
             day = 2*digit<br />
             month = 3*letter<br />
             year = 4*digit<br />
             hour = 2*digit<br />
             minute = 2*digit<br />
             second = 2*digit<br />
             zone = (`+' | `-') 4*digit</code>
          </p>
          Es posible mostrar la hora de otra manera especificando
          <code>%{format}</code> en el formato a usar en el registro,
          donde <code>format</code> se sustituye como se har&#237;a al
          usar <code>strftime(3)</code> de la librer&#237;a
          est&#225;ndar de C.
        </dd>

        <dt><code>"GET /apache_pb.gif HTTP/1.0"</code>
        (<code>\"%r\"</code>)</dt>

        <dd>La l&#237;nea de la petici&#243;n del cliente se muestra
        entre dobles comillas. La l&#237;nea de petici&#243;n contiene
        mucha informaci&#243;n de utilidad. Primero, el m&#233;todo
        usado por el cliente es <code>GET</code>. Segundo, el cliente
        ha hecho una petici&#243;n al recurso
        <code>/apache_pb.gif</code>, y tercero, el cliente uso el
        protocolo <code>HTTP/1.0</code>. Tambi&#233;n es posible
        registrar una o m&#225;s partes de la l&#237;nea de
        petici&#243;n independientemente. Por ejemplo, el formato
        "<code>%m %U%q %H</code>" registrar&#225; el m&#233;todo, ruta,
        cadena de consulta y protocolo, teniendo exactamente el mismo
        resultado que "<code>%r</code>".</dd>

        <dt><code>200</code> (<code>%&gt;s</code>)</dt>

        <dd>Es el c&#243;digo de estado que el servidor env&#237;a de
        vuelta al cliente. Esta informaci&#243;n es muy valiosa,
        porque revela si la petici&#243;n fue respondida con
        &#233;xito por el servidor (los c&#243;digos que empiezan por
        2), una redirecci&#243;n (los c&#243;digos que empiezan por
        3), un error provocado por el cliente (los c&#243;digos que
        empiezan por 4), o un error en el servidor (los c&#243;digos
        que empiezan por 5). La lista completa de c&#243;digos de
        estado posibles puede consultarle en <a
        href="http://www.w3.org/Protocols/rfc2616/rfc2616.txt">la
        especificaci&#243;n de HTTP</a> (RFC2616 secci&#243;n
        10).</dd>

        <dt><code>2326</code> (<code>%b</code>)</dt>

        <dd>La &#250;ltima entrada indica el tama&#241;o del objeto
        retornado por el cliente, no inclu&#237;das las cabeceras de
        respuesta. Si no se respondi&#243; con ning&#250;n contenido
        al cliente, este valor mostrar&#225; valor
        "<code>-</code>". Para registrar "<code>0</code>" en ese caso,
        use <code>%B</code> en su lugar.</dd>
      </dl>
    </section>

    <section id="combined">
      <title>Formato de Registro Combinado (Combined Log Format)</title>

      <p>Otro formato usado a menudo es el llamado Formato de Registro
      Combinado. Este formato puede ser usado como sigue.</p>

      <example>
        LogFormat "%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\"
        \"%{User-agent}i\"" combined<br />
         CustomLog log/access_log combined
      </example>

      <p>Es exactamente igual que Formato Com&#250;n de Registro, pero
      a&#241;ade dos campos. Cada campo adicional usa la directiva
      <code>%{<em>header</em>}i</code>, donde <em>header</em> puede
      ser cualquier cabecera de petici&#243;n HTTP. El registro de
      acceso cuando se usa este formato tendr&#225; este aspecto:</p>

      <example>
        127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
        /apache_pb.gif HTTP/1.0" 200 2326
        "http://www.example.com/start.html" "Mozilla/4.08 [en]
        (Win98; I ;Nav)"
      </example>

      <p>Los campos adicionales son:</p>

      <dl>
        <dt><code>"http://www.example.com/start.html"</code>
        (<code>\"%{Referer}i\"</code>)</dt>

        <dd>La cabecera de petici&#243;n de HTTP "Referer"
        (sic). Muestra el servidor del que proviene el cliente. (Esta
        deber&#237;a ser la p&#225;gina que contiene un enlace o
        que contiene a <code>/apache_pb.gif</code>).</dd>

        <dt><code>"Mozilla/4.08 [en] (Win98; I ;Nav)"</code>
        (<code>\"%{User-agent}i\"</code>)</dt>

        <dd>La cabecera de petici&#243;n HTTP "User-Agent". Es la
        informaci&#243;n de identificaci&#243;n que el navegador del
        cliente incluye sobre s&#237; mismo.</dd>
      </dl>
    </section>

    <section id="multiple">
      <title>C&#243;mo usar varios registros de acceso</title>

      <p>Para crear varios registros de acceso solamente tiene que
      especificar varias directivas <directive
      module="mod_log_config">CustomLog</directive> en el fichero de
      configuraci&#243;n. Por ejemplo, las siguientes directivas
      crear&#225;n tres registros de acceso. El primero contendr&#225;
      la informaci&#243;n b&#225;sica en Formato Com&#250;n de
      Registro, mientras que el segundo y el tercero contendr&#225;n
      contendr&#225;n la informaci&#243;n de los "referer" y de los
      navegadores usados. Las dos &#250;ltimas l&#237;neas <directive
      module="mod_log_config">CustomLog</directive> muestran c&#243;mo
      reproducir el comportamiento de las directivas
      <code>ReferLog</code> y <code >AgentLog</code>.</p>

      <example>
        LogFormat "%h %l %u %t \"%r\" %&gt;s %b" common<br />
        CustomLog logs/access_log common<br />
        CustomLog logs/referer_log "%{Referer}i -&gt; %U"<br />
        CustomLog logs/agent_log "%{User-agent}i"
      </example>

      <p>Este ejemplo tambi&#233;n muestra que no es necesario definir un
      "apodo" con la directiva <directive
      module="mod_log_config">LogFormat</directive>. En lugar de esto,
      el formato de registro puede especificarse directamente en la
      directiva <directive
      module="mod_log_config">CustomLog</directive>.</p>
    </section>

    <section id="conditional">
      <title>Registro Condicional</title>

      <p>Algunas veces es m&#225;s conveniente excluir determinadas
      entradas del registro de acceso en funci&#243;n de las
      caracter&#237;sticas de la petici&#243;n del cliente. Puede
      hacer esto f&#225;cilmente con la ayuda de <a
      href="env.html">variables de entorno</a>. Primero, debe
      especificar una variable de entorno que indique que la
      petici&#243;n cumple determinadas condiciones. Esto se hace
      normalmente con <directive
      module="mod_setenvif">SetEnvIf</directive>. Entonces puede usar
      la cla&#250;sula <code>env=</code> de la directiva <directive
      module="mod_log_config">CustomLog</directive> para incluir o
      excluir peticiones en las que est&#233; presente la variable de
      entorno. Algunos ejemplos:</p>

      <example>
        # Marcar las peticiones de la interfaz loop-back<br />
        SetEnvIf Remote_Addr "127\.0\.0\.1" dontlog<br /> 
        # Marcar las peticiones del fichero robots.txt<br /> 
        SetEnvIf Request_URI "^/robots\.txt$" dontlog<br /> 
        # Registrar lo que quede<br />
        CustomLog logs/access_log common env=!dontlog
      </example>

      <p>Como otro ejemplo, considere registrar las peticiones de los
      angloparlantes en un fichero de registro, y el resto de
      peticiones en un fichero de registro diferente.</p>