Trabajo con informes de servidor

El software de servidor AnswerBook2 mantiene registros que muestran los errores del servidor y los accesos a éste. Asimismo, incluye un informe de resumen de la frecuencia de acceso de las colecciones de documentos y la cantidad de errores que se producen.

Informe de resumen de acceso a manuales

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

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

• Nombre corto del manual: el nombre corto del manual, tal como está identificado en su archivo de configuración

• Nombre de colección: el nombre corto de la colección a la que pertenece el manual, tal como está identificada en el archivo collinfo

• Accesos: número de veces que se ha accedido al 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 de la página Administración de AnswerBook2.

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

• Para dejar de guardar la información en el archivo de registro de acceso, pulse el botón situado junto a desactivado y luego haga clic en Aplicar.

También puede utilizar los siguientes comandos para llevar a cabo estas funciones:

% /usr/lib/ab2/bin/ab2admin -o access_on [-m nombre_serv] [-p puerto_serv]
 

% /usr/lib/ab2/bin/ab2admin -o access_off [-m nombre_serv] [-p puerto_serv]
 

Después de cambiar la función de registro, debe parar e iniciar el servidor de documentación. Entre como el 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 visualizar el archivo de registro de acceso, seleccione Ver archivos de registro de la página Administración de AnswerBook2 y luego haga clic en Ver archivo de registro de acceso, que es un archivo de texto que muestra todos los accesos realizados en el servidor de documentación. Cada línea del registro de acceso tiene un aspecto similar a éste:

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 un 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_serv] [-p puerto_serv]

Archivos de registro de errores

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

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

• Para dejar de guardar la información en el archivo de registro de errores, pulse el botón situado junto a desactivado y luego pulse Aplicar.

También puede utilizar los siguientes comandos para llevar a cabo estas funciones:

% /usr/lib/ab2/bin/ab2admin -o error_on [-m nombre_serv] [-p puerto_serv]
 

% /usr/lib/ab2/bin/ab2admin -o error_off [-m nombre_serv] [-p puerto_serv]

Después de cambiar la función de registro, debe parar e iniciar el servidor de documentación. Entre como 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 visualizar el archivo de registro de errores, seleccione Ver archivos de registro de la página Administración de AnswerBook2 y luego haga clic en Ver archivo de registro de errores. El archivo de registro de errores muestra todos los errores producidos en el servidor de documentación. Puede utilizar esta información para determinar la causa de problemas del servidor o comportamientos no habituales. Estos errores suelen identificar el servidor y puerto con los que está asociado el error, así como un texto que describe éste.

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

% /usr/lib/ab2/bin/ab2admin -o view_error [-m nombre_serv] [-p puerto_serv]

Rotación de archivos de registro

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

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

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

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

1. Escriba el nombre del archivo en el que debe guardarse en el campo Guardar archivo de registro.

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

   Observe que el campo Ubicación del archivo de registro muestra dónde se guarda el archivo. No puede cambiar esta 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. Entre como 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_serv] [-p puerto_serv]
 

% /usr/lib/ab2/bin/ab2admin -o rotate_access [-m nombre_serv] [-p puerto_serv]