logs.xml.es

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

      <example>
        SetEnvIf Accept-Language "en" english<br />
        CustomLog logs/english_log common env=english<br />
        CustomLog logs/non_english_log common env=!english
      </example>

      <p>Aunque acabamos de mostar que el registro condicional es muy
      potente y flexible, no es la &#250;nica manera de controlar los
      contenidos de los ficheros de registro. Los ficheros de registro
      son m&#225;s &#250;tiles cuanta m&#225;s informaci&#243;n sobre
      la actividad del servidor contengan. A menudo es m&#225;s
      f&#225;cil eliminar las peticiones que no le interesen
      procesando posteriormente los ficheros de registro
      originales.</p>
    </section>
  </section>

  <section id="rotation">
    <title>Rotaci&#243;n de los ficheros de registro</title>

    <p>Incluso en un servidor con una actividad moderada, la cantidad
    de informaci&#243;n almacenada en los ficheros de registro es muy
    grande. El registro de acceso crece normalmente en 1MB por cada
    10.000 peticiones. Por lo tanto, es necesario rotar
    peri&#243;dicamente los registros moviendo o borrando su
    contenido. Esto no se puede hacer con el servidor funcionando,
    porque Apache continuar&#225; escribiendo en el antiguo registro
    mientras que el archivo est&#233; abierto. En lugar de esto, el
    servidor debe ser <a href="stopping.html">reiniciado</a>
    despu&#233;s de mover o borrar los ficheros de registro para que
    se abran nuevos ficheros de registro.</p>

    <p>Usando un reinicio <em>graceful</em>, se le puede indicar al
    servidor que abra nuevos ficheros de registro sin perder ninguna
    petici&#243;n siendo servida o en espera de alg&#250;n cliente. Sin
    embargo, para hacer esto, el servidor debe continuar escribiendo
    en los ficheros de registro antiguos mientras termina de servir
    esas peticiones. Por lo tanto, es preciso esperar alg&#250;n
    tiempo despu&#233;s del reinicio antes de realizar ninguna
    operaci&#243;n sobre los antiguos ficheros de registro. Una
    situaci&#243;n t&#237;pica que simplemente rota los registros y
    comprime los registros antiguos para ahorrar espacio es:</p>

    <example>
      mv access_log access_log.old<br />
      mv error_log error_log.old<br />
      apachectl graceful<br />
      sleep 600<br />
      gzip access_log.old error_log.old
    </example>

    <p>Otra manera de realizar la rotaci&#243;n de los registros es
    usando <a href="#piped">ficheros de registro redireccionados
    (piped logs)</a> de la forma en que se explica en la siguiente
    secci&#243;n.</p>
  </section>

  <section id="piped">
    <title>Ficheros de registro redireccionados (Piped Logs)</title>

    <p>Apache httpd es capaz de escribir la informaci&#243;n del
    registro de acceso y errores mediante una redirecci&#243;n a otro
    proceso, en lugar de directamente a un fichero. Esta capacidad
    incrementa de forma muy importante la flexibilidad de registro,
    sin a&#241;adir c&#243;digo al servidor principal. Para escribir
    registros a una redirecci&#243;n, simplemente reemplace el nombre
    de fichero por el car&#225;cter "<code>|</code>", seguido por el
    nombre del ejecutable que deber&#237;a aceptar las entradas de
    registro por su canal de entrada est&#225;ndar. Apache
    iniciar&#225; el proceso de registro redireccionado cuando se
    inicie el servidor, y lo reiniciar&#225; si se produce alg&#250;n
    error irrecuperable durante su ejecuci&#243;n. (Esta &#250;ltima
    funcionalidad es la que hace que se llame a esta t&#233;cnica
    "registro redireccionado fiable".)</p>

    <p>Los procesos de registros son engendrados por el proceso padre
    de Apache httpd, y heredan el identificador de usuario de ese
    proceso. Esto significa que los programas a los que se
    redireccionan los registros se ejecutan normalmente como root. Es
    por ello que es muy importante que los programas sean simples y
    seguros.</p>

    <p>Un uso importante de los registros redireccionados es permitir
    la rotaci&#243;n de los registros sin tener que reiniciar el
    servidor. El servidor Apache HTTP incluye un programa simple
    llamado <program>rotatelogs</program> con este prop&#243;sito. Por
    ejemplo para rotar los registros cada 24 horas, puede usar:</p>

    <example>
      CustomLog "|/usr/local/apache/bin/rotatelogs
      /var/log/access_log 86400" common
    </example>

    <p>Tenga en cuenta que las comillas se usan para abarcar el
    comando entero que ser&#225; invocado por la
    redirecci&#243;n. Aunque estos ejemplos son para el registro de
    acceso, la misma t&#233;cnica se puede usar para el registro de
    errores.</p>

    <p>Otro programa para la rotaci&#243;n de los registros mucho
    m&#225;s flexible llamado <a
    href="http://www.cronolog.org/">cronolog</a> est&#225; disponible
    en un sitio web externo.</p>

    <p>Como ocurre con el registro condicional, la redirecci&#243;n de
    registros es una herramienta muy potente, pero no deben ser usados
    si hay disponible una soluci&#243;n m&#225;s simple de procesado
    posterior de los registros fuera de l&#237;nea.</p>
  </section>

  <section id="virtualhost">
    <title>Hosts Virtuales</title>

    <p>Cuando se est&#225; ejecutando un servidor con muchos <a
    href="vhosts/">hosts virtuales</a>, hay varias formas de abordar
    el asunto de los registros. Primero, es posible usar los registros
    de la misma manera que se usar&#237;an si hubiera solamente un
    host en el servidor. Simplemente poniendo las directivas que
    tienen que ver con los registros fuera de las secciones <directive
    module="core" type="section">VirtualHost</directive> en el
    contexto del servidor principal, puede almacenar toda la
    informaci&#243;n de todas las peticiones en los mismos registros
    de acceso y errores. Esta t&#233;cnica no permite una
    recolecci&#243;n f&#225;cil de las estad&#237;sticas individuales
    de cada uno de los hosts virtuales.</p>

    <p>Si una directiva <directive
    module="mod_log_config">CustomLog</directive> o <directive
    module="core">ErrorLog</directive> se pone dentro una secci&#243;n
    <directive module="core" type="section">VirtualHost</directive>,
    todas las peticiones de ese host virtual se registrar&#225;n
    solamente en el fichero especificado. Las peticiones de cualquier
    host virtual que no tenga directivas de registro espec&#237;ficas
    para &#233;l se registrar&#225;n en los registros del servidor
    principal. Esta t&#233;cnica es muy &#250;til si usa un
    peque&#241;o n&#250;mero de hosts virtuales, pero si usa un gran
    n&#250;mero de ellos, puede ser complicado de
    gestionar. Adem&#225;s, puede a menudo provocar problemas con <a
    href="vhosts/fd-limits.html"> descriptores de fichero
    insuficientes</a>.</p>

    <p>Para el registro de acceso, se puede llegar a un buen
    equilibrio. A&#241;adiendo informaci&#243;n del host virtual al
    formato de registro, es posible registrar las operaciones de todos
    los hosts en un &#250;nico registro, y posteriormente dividir el
    fichero con todos los registros en ficheros individualizados. Por
    ejemplo, considere las siguientes directivas.</p>

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

    <p>El <code>%v</code> se usa para registrar el nombre del host
    virtual que est&#225; sirviendo la petici&#243;n. Puede usar un
    programa como <a href="programs/other.html">split-logfile</a> para
    procesar posteriormente el registro de acceso y dividirlo en
    ficheros independientes para cada host virtual.</p>
  </section>

  <section id="other">
    <title>Otros ficheros de registro</title>

    <related>
      <modulelist>
        <module>mod_cgi</module>
        <module>mod_rewrite</module>
      </modulelist>
      <directivelist>
        <directive module="mpm_common">PidFile</directive>
        <directive module="mod_rewrite">RewriteLog</directive>
        <directive module="mod_rewrite">RewriteLogLevel</directive>
        <directive module="mod_cgi">ScriptLog</directive>
        <directive module="mod_cgi">ScriptLogBuffer</directive>
        <directive module="mod_cgi">ScriptLogLength</directive>
      </directivelist>
    </related>

    <section id="pidfile">
      <title>Fichero PID (PID File)</title>

      <p>Al iniciar, Apache httpd guarda el identificador del proceso
      padre del servidor en el fichero
      <code>logs/httpd.pid</code>. Puede modificar el nombre de este
      fichero con la directiva <directive
      module="mpm_common">PidFile</directive>. El identificador del
      proceso puede usarlo el administrador para reiniciar y finalizar
      el demonio (daemon) mediante el env&#237;o de se&#241;ales al
      proceso padre; en Windows, use la opci&#243;n de l&#237;nea de
      comandos -k en su lugar.  Para m&#225;s informaci&#243;n al
      respecto, consulte la documentaci&#243;n sobre <a
      href="stopping.html">parar y reiniciar Apache</a>.</p>
    </section>

    <section id="scriptlog">
      <title>Registro de actividad de scripts (Script Log)</title>

      <p>Para ayudar a la detecci&#243;n de errores, la directiva
      <directive module="mod_cgi">ScriptLog</directive> permite
      guardar la entrada y la salida de los scripts CGI. Esta
      directiva solamente deber&#237;a usarla para hacer pruebas - no
      en servidores en producci&#243;n.  Puede encontrar m&#225;s
      informaci&#243;n al respecto en la documentaci&#243;n de <a
      href="mod/mod_cgi.html">mod_cgi</a>.</p>
    </section>

    <section id="rewritelog">
      <title>Registro de actividad de Rewrite (Rewrite Log)</title>

      <p>Cuando use las potentes y complejas funcionalidades de <a
      href="mod/mod_rewrite.html">mod_rewrite</a>, ser&#225; casi
      siempre necesario usar la direcitiva <directive
      module="mod_rewrite">RewriteLog</directive> para ayudar a la
      detecci&#243;n de errores. Este fichero de registro produce un
      an&#225;lisis detallado de c&#243;mo act&#250;a este
      m&#243;dulo sobre las peticiones. El nivel de detalle del
      registro se controla con la directiva <directive
      module="mod_rewrite">RewriteLogLevel</directive>.</p>
    </section>
  </section>
</manualpage>