apache-http-server/docs/manual/mod/mod_status.xml.es

<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
<!-- English Revision: 1755973:1873230 (outdated) -->
<!-- Spanish Translation: Daniel Ferradal <dferradal@apache.org> -->


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

<modulesynopsis metafile="mod_status.xml.meta">

<name>mod_status</name>
<description>Provee información de la actividad y rendimiento del 
  servidor</description>
<status>Base</status>
<sourcefile>mod_status.c</sourcefile>
<identifier>status_module</identifier>


<summary>
    <p>El módulo de Estado permite a un administrador averiguar lo bien que está
    rindiendo su servidor. Se presenta una página HTML que da las estadísticas
    actuales del servidor en una forma fácilmente legible. Si es necesario
    se puede hacer que ésta página se refresque automáticamente (con un navegador
    compatible). También hay otra página que da una sencilla lista legible por 
    máquina del estado actual del servidor.</p>

    <p>Los detalles que se dan son:</p>

    <ul>
      <li>El número de worker sirviendo peticiones</li>

      <li>El número de worker desocupado</li>

      <li>El estado de cada worker, el número de peticiones que ese worker ha
      realizado y el número total de bytes servido por el worker (*)</li>

      <li>Un número total de accesos y recuento de bytes servidos (*)</li>

      <li>La hora a la que el servidor ha sido arrancado/reiniciado y el tiempo
      que se ha estado ejecutando</li>

      <li>Medias indicando el número de peticiones por segundo, el número de bytes
      servido por segundo y la media de bytes por petición (*)</li>

      <li>El porcentaje actual de CPU usado por cada worker y en total por todos
      los workers al completo (*)</li>

      <li>Los hosts actuales y peticiones que se están procesando en el momento
       (*)</li>
    </ul>

    <p>Las líneas marcadas con "(*)" solo están disponibles si
    <directive module="core">ExtendedStatus</directive> está configurado a
    <code>On</code>.  En la versión 2.3.6, cargar mod_status pondrá
    <directive module="core">ExtendedStatus</directive> en On por defecto.</p>

    <note>
      <strong>Debería tenerse en cuenta que si se carga 
      <module>mod_status</module> en el servidor, su handler estará disponible
      en <em>todos</em> los ficheros de configuración, incluidos ficheros
      <em>de</em>-directorio (<em>p. ej.</em>, <code>.htaccess</code>). Esto puede tener ramificaciones relacionadas con la seguridad en su sitio web.</strong>
    </note>

</summary>

<section id="enable">
    <title>Activando el Soporte de Estado</title>

    <p>Para activar los reportes de estado para navegadores tán solo desde el 
    dominio example.com añada este código en su fichero de configuración 
    <code>httpd.conf</code></p>
<highlight language="config">
&lt;Location "/server-status"&gt;
    SetHandler server-status
    Require host example.com
&lt;/Location&gt;
</highlight>

    <p>Ahora puede acceder a estadísticas del servidor usando un navegador web
    para acceder a la página
    <code>http://your.server.name/server-status</code></p>
</section>

<section id="autoupdate">

    <title>Actualizaciones Automáticas</title>
    <p>Puede hacer que la página de estado se actualice automáticamente si tiene
    un navegador que soporte "refresh". Acceda a la página
    <code>http://your.server.name/server-status?refresh=N</code> para refrescar
    la página cada N segundos.</p>

</section>

<section id="machinereadable">

    <title>Fichero de Estado legible por máquina</title>
    <p>Una versión legible por máquina del fichero de estado está disponible
    accediendo a la página 
    <code>http://your.server.name/server-status?auto</code>. Esto es útil cuando
    la solicitud de estado se lanza automáticamente, vea el programa Perl 
    <code>log_server_status</code>, que encontrará en el directorio 
    <code>/support</code> de su instalación del Servidor Apache HTTP.</p>

</section>

<section id="troubleshoot">
    <title>Usando server-status para identificar problemas</title>

    <p>La página <code>server-status</code> puede usarse como un lugar donde
    empezar a identificar problemas en una situación en la que su servidor está
    consumiento todos los recursos disponibles (CPU o memoria), y ustéd desea
    identificar qué peticiones o clientes están causando el problema.</p>

    <p>Primero, asegúrese de que tiene <directive
    module="core">ExtendedStatus</directive> configurado a on, de manera que 
    puede ver toda la información de la petición y el cliente para cada proceso
    o hilo.</p>

    <p>Ahora mire en la lista de procesos (usando <code>top</code>, o utilidad
    similar para ver procesos) para identificar los procesos específicos
    que son los principales culpables. Ordene la salida de <code>top</code> por
    uso de CPU, o de memoria, dependiendo del problema que esté intentando 
    ubicar.</p>

    <p>Recargue la página <code>server-status</code>, y busque esos ids de
    proceso, y podrá ver qué petición se está sirviendo por ese proceso y para
    qué cliente. Las peticiones son pasajeras, así que puede que necesite
    intentarlo varias veces antes de que lo cace en el acto, por decirlo de 
    alguna manera.</p>

    <p>Este proceso <em>debería</em> darle alguna idea de qué cliente, o qué
    tipo de petición, son los principales responsables para sus problemas de
    carga. A menudo identificará una aplicación web en particular que puede 
    estar comportándose como no es debido, o un cliente en particular que está
    atacando su sitio web.</p>

</section>

</modulesynopsis>