Trabajo con informes de servidor

El software de servidor AnswerBook2 mantiene registros de los errores del servidor y de los accesos a éste. Además, proporciona un informe de resumen de la frecuencia de acceso de las colecciones de documentos y el número de errores producidos.

Informe de resumen de acceso a manuales

Para ver un resumen del acceso a los manuales del servidor, seleccione Ver resumen de acceso a manuales en la página de administración de AnswerBook2. El informe de acceso a manuales muestra la frecuencia con que se ha accedido a cada uno de los manuales del servidor. Para cada manual del servidor, se muestra:

• Título del manual: el título del manual, como aparece en la página Biblioteca

• Nombre corto del manual: el nombre corto del manual, según está identificado en el archivo de configuración del mismo

• Nombre de colección: el nombre corto de la colección a la que pertenece el manual, según está identificado en el archivo collinfo

• Accesos: número de veces a las que se ha accedido el manual

• Errores: número de errores asociados con el manual

Archivos de registro de acceso

Para activar o desactivar el registro de acceso, seleccione Modificar configuración del servidor en la página de administración de AnswerBook2.

• Para hacer que la información sobre quién está accediendo a los datos del servidor de documentación se escriba en el archivo de registro de acceso, haga clic en el botón situado al lado de activado y luego en Aplicar. La ubicación predeterminada de este archivo es /var/log/ab2/logs/access-8888.log.

• Para hacer que la información se deje de escribir en el archivo de registro de acceso, haga clic en el botón situado al lado de Desactivado y luego en Aplicar.

Tara llevar a cabo estas funciones también puede utilizar los siguientes comandos:

% /usr/lib/ab2/bin/ab2admin -o access_on [-m nombre_servidor] [-p puerto_servidor]
 

% /usr/lib/ab2/bin/ab2admin -o access_off [-m nombre_servidor] [-p puerto_servidor]
 

Después de cambiar la función de registro, debe parar e iniciar el servidor de documentación. Inicie una sesión de usuario root en la máquina del servidor y escriba los comandos siguientes:

# /usr/lib/ab2/bin/ab2admin -o stop
# /usr/lib/ab2/bin/ab2admin -o start

Visualización del registro de acceso

Para ver el archivo de registro de acceso, seleccione Ver archivos de registro en la página de administración de AnswerBook2 y luego haga clic en Ver archivo de registro de acceso. Éste es un archivo de texto que enumera todos los accesos realizados en el servidor de documentación. Cada línea del registro de acceso tiene un aspecto similar a:

129.146.83.55 - - [04/Nov/1996:15:07:05 -0800]
"GET /icons/ab2_curr_home.gif HTTP/1.0" 200 1938

Donde:

• El primer conjunto de cifras es la dirección IP (Internet Protocol) del cliente. Por ejemplo, 129.146.83.55.

• La información entre corchetes es la fecha y hora del acceso. Por ejemplo, [04/Nov/1996:15:07:05 -0800] .

• La información entre comillas indica el acceso que se ha producido. Normalmente, suele identificar una URL o un nombre de archivo, así como el protocolo utilizado para responder a la solicitud de acceso. Por ejemplo, "GET /icons/ab2_curr_home.gif HTTP/1.0" indica que el acceso consistió en obtener el archivo /icons/ab2_curr_home.gif mediante el protocolo HTTP 1.0.

• El penúltimo número indica si el acceso fue satisfactorio (200) o no (cualquier otro valor).

• El último número indica el tamaño (en Kilobytes) de la información devuelta al solicitante. Por ejemplo, 1938 es el tamaño del archivo .gif recuperado.

Para llevar a cabo esta función, también puede usar el comando siguiente:

% /usr/lib/ab2/bin/ab2admin -o view_access [-m nombre_servidor] [-p puerto_servidor]

Archivos de registro de errores

Para activar o desactivar el registro de errores, seleccione Modificar configuración del servidor en la página de administración de AnswerBook2.

• Para hacer que se escriba en el archivo de registro de errores la información sobre cualquier error que se produzca en el servidor de documentación, haga clic en el botón situado al lado de activado y luego en Aplicar. La ubicación predeterminada de este archivo es /var/log/ab2/logs/errors-8888.log.

• Para hacer que se deje de escribir la información en el registro de errores, haga clic en el botón situado a lado de desactivado y luego en Aplicar.

Para llevar a cabo estas funciones también puede utilizar los siguientes comandos:

% /usr/lib/ab2/bin/ab2admin -o error_on [-m nombre_servidor] [-p puerto_servidor]
 

% /usr/lib/ab2/bin/ab2admin -o error_off [-m nombre_servidor] [-p puerto_servidor]

Después de cambiar la función de registro, debe parar e iniciar el servidor de documentación. Inicie una sesión de usuario root en la máquina del servidor y escriba los comandos siguientes:

# /usr/lib/ab2/bin/ab2admin -o stop
# /usr/lib/ab2/bin/ab2admin -o start

Visualización del registro de errores

Para ver el archivo de registro de errores, seleccione Ver archivos de registro en la página de administración de AnswerBook2 y luego haga clic en Ver archivo de registro de errores. Este archivo enumera todos los errores que se produjeron en este servidor de documentación. Puede utilizar esta información para determinar la causa de problemas del servidor o comportamientos poco habituales. Estos errores suelen identificar el servidor y puerto con los que está asociado el error, así como un texto que describe dicho error.

Para llevar a cabo esta función, también puede usar el comando siguiente:

% /usr/lib/ab2/bin/ab2admin -o view_error [-m nombre_servidor] [-p puerto_servidor]

Rotación de archivos de registro

Puede guardar el archivo de registro de acceso o errores actual en un archivo y comenzar a registrar la información en un archivo vacío.

• Para rotar el registro de errores, seleccione Rotar archivo de registro de errores en la página de administración de AnswerBook2.

• Para rotar el registro de acceso, seleccione Rotar archivo de registro de accesos en la página de administración de AnswerBook2.

Cuando aparezca la página Rotar archivo de registro de accesos (errores):

1. Escriba el nombre de archivo donde se guardará en el campo Guardar archivo de registro.

   El valor predeterminado es fecha_actual.nombre_archivo_registro_actual.log, donde fecha_actual tiene el formato AñoAñoAñoAño_MesMes_DíaDía_HoraHora y nombre_archivo_registro_actual tiene el valor predeterminado access-8888.log o error-8888.log (por ejemplo, 1997_02_26_14.access-8888.log).

   Tenga en cuenta que el campo Ubicación del archivo de registro muestra dónde se guardará el archivo. No puede cambiar la información en esta página.

2. Haga clic en Aplicar.

Después de cambiar la función de registro, debe parar e iniciar el servidor de documentación. Inicie una sesión de usuario root en la máquina del servidor y escriba los comandos siguientes:

# /usr/lib/ab2/bin/ab2admin -o stop
# /usr/lib/ab2/bin/ab2admin -o start

Para llevar a cabo estas funciones también puede utilizar los siguientes comandos:

% /usr/lib/ab2/bin/ab2admin -o rotate_error [-m nombre_servidor] [-p puerto_servidor]
 

% /usr/lib/ab2/bin/ab2admin -o rotate_access [-m nombre_servidor] [-p puerto_servidor]