versión 11 (Modificado)
4D le permite obtener información sobre el funcionamiento de su sitio Web 4D.
Puede controlar el sitio utilizando URLs particulares (/4DSTATS, /4DHTMLSTATS, /4DCACHECLEAR y /4DWEBTEST).
Puede generar un historial de peticiones.
Puede obtener información sobre el servidor Web en la página Evaluación el Explorador de ejecución de 4D.
URLs de gestión del servidor Web
El servidor Web 4D acepta cuatro URLs particulares: /4DSTATS, /4DHTMLSTATS, /4DCACHECLEAR y /4DWEBTEST.
/4DSTATS, /4DHTMLSTATS y /4DCACHECLEAR son accesibles únicamente al Diseñador y Administrador de la base. Si la base no tiene sistema de contraseñas, estos URLs están disponibles para todos los usuarios.
/4DWEBTEST siempre está disponible.
/4DSTATS
El URL /4DSTATS devuelve la siguiente información en forma de texto puro:
el número de "hits" (conexiones de bajo nivel),
el número de contextos creados,
el número de contextos que no pueden ser creados,
el número de errores de contraseña,
el número de páginas almacenada en la caché,
el porcentaje de la caché utilizada,
la lista de las páginas y archivos JPEG o GIF almacenados en la caché de las páginas estáticas (*).
(*) Para mayor información sobre la caché de las páginas estáticas y de las imágenes, consulte la sección Web Server Settings.
Esta información puede permitirle controlar el funcionamiento de su servidor y eventualmente adaptar los parámetros correspondientes.
Nota: el comando WEB CACHE STATISTICS también le permite obtener información sobre cómo la caché está siendo utilizada por las páginas estáticas.
/4DHTMLSTATS
El URL /4DHTMLSTATS devuelve, igualmente en forma de texto puro, la misma información que el URL /4DSTATS. La diferencia es que en el último campo (contenido en el caché), sólo se devuelve la lista de las páginas HTML sin los archivos .GIF y .JPEG presentes en la caché.
/4DCACHECLEAR
El URL /4DCACHECLEAR provoca el borrado inmediato de la caché de las páginas estáticas y de las imágenes. Le permite por lo tanto "forzar" la actualización de las páginas que han sido modificadas.
/4DWEBTEST
El URL /4DWEBTEST está diseñado para controlar el estado del servidor Web. Cuando se llama esta URL, 4D devuelve un archivo de texto que contiene los siguientes campos HTTP:
Date: fecha actual en el formato RFC 822
Por ejemplo: "Date: Wed, 26 Jan 2000 13:12:50 GMT"
Server: 4D WebStar_D/número de versión interna
Por ejemplo: "4D WebStar_D/7.0"
User-Agent: nombre y versión @ dirección IP del cliente
Por ejemplo: "Mozilla/4.08 (Macintosh; I; PPC, Nav) @ 192.193.00.00"
Historial de las peticiones
4D le permite obtener un historial de peticiones.
Este archivo se llama "logweb.txt" y se ubica automáticamente:
con 4D en modo local y 4D Server, junto al archivo de estructura de la base.
con 4D en modo remoto, junto al archivo .exe de la aplicación (Windows) o el paquete de software (Mac OS).
Activación y formato
La activación y la configuración del contenido del archivo de historial se efectúan en las Preferencias de la aplicación, página Web/Formato de log:
Nota: la activación y desactivación del archivo de historial de las peticiones puede igualmente realizarse por programación utilizando el comando SET DATABASE PARAMETER.
El menú de formato del log ofrece las siguientes opciones:
Sin historial: cuando esta opción está seleccionada, 4D no generará un archivo de historial de las peticiones.
CLF (Common Log Format): cuando se selecciona esta opción, el historial de peticiones se genera en formato CLF. Con el formato CLF, cada línea de archivo representa una petición, tal como:
host rfc931 user [DD/MMM/YYYY:HH:MM:SS] "request" state length
Cada campo está separado por un espacio y cada línea termina en la secuencia CR/LF (carácter 13, carácter 10).
host: dirección IP del cliente (ej. 192.100.100.10)
rfc931: información no generada por 4D, es siempre - (un signo menos)
usuario: nombre del usuario tal como se autentica, o de lo contrario - (signo menos). Si el nombre de usuario contiene espacios, serán reemplazados por _ (un guión bajo)
DD: día, MMM: abreviación de 3 letras del nombre del mes (Ene, Feb,...), YYYY: año, HH: hora, MM: minutos, SS: segundos
La fecha y hora son locales al servidor.
request: petición enviada por el cliente (ej. GET /index.htm HTTP/1.0)
state: respuesta dada por el servidor.
length: tamaño de los datos devueltos (excepto el encabezado HTTP) ó 0.
Nota: por razones de rendimiento, las operaciones se guardan en un buffer de memoria en paquetes de 1Kb antes de ser escritas en el disco. Las operaciones también están escritas en el disco si ninguna petición ha sido enviado cada 5 segundos.
Los posibles valores del estado son los siguientes:
200: OK
204: Sin contenido
302: Redirección
304: No modificado
400: Autenticación incorrecta
401: Autenticación necesaria
404: No encontrada
500: Error interno
El formato CLF no puede personalizarse.
DLF (Combined Log Format): cuando se selecciona esta opción, el historial de peticiones se genera en el formato DLF. El formato DLF es similar al formato CLF y utiliza exactamente la misma estructura. Simplemente contiene dos campos HTTP adicionales al final de cada petición: Referer y User-agent.
- Referer: contiene el URL de la página que apunta al documento solicitado.
- User-agent: contiene el nombre y la versión del navegador o del paquete cliente en el origen de la petición.
El formato DLF no puedes personalizarse.
ELF (Extended Log Format): cuando esta opción está seleccionada, el historial de peticiones se genera en formato ELF. El formato ELF está ampliamente expandido en el mundo de los navegadores HTTP. Puede utilizarse para crear historiales sofisticados, que respondan a necesidades específicas. Por esta razón, el formato ELF es personalizable: es posible elegir los campos a grabar así como el orden de inserción en el archivo.
WLF (WebStar Log Format): cuando se selecciona esta opción, el historial de peticiones se genera en formato WLF. El formato WLF fue desarrollado específicamente por el servidor 4D WebSTAR. Es similar al formato ELF, con sólo unos pocos campos adicionales. Al igual que el formato ELF, es personalizable.
Configurar los campos
Cuando elige el formato ELF (Extended Log Format) o WLF (WebStar Log Format), el área "Formato personalizado del historial Web" muestra los campos disponibles para el formato. Debe seleccionar cada campo a incluir en el historial. Para hacerlo, utilice los botones de flecha o simplemente arrastre y suelte los campos que quiere al área "Campos seleccionados".
Nota: no es posible seleccionar el mismo campo dos veces.
La siguiente tabla lista los campos disponibles para cada formato (en orden alfabético) y describe sus contenidos:
Campo | ELF | WLF | Valor | ||||
BYTES_RECEIVED | X | Número de bytes recibidos por el servidor | |||||
BYTES_SENT | X | X | Número de bytes enviados por el servidor al cliente | ||||
C_DNS | X | X | Dirección IP del DNS (ELF: campo idéntico al campo C_IP) | ||||
C_IP | X | X | Dirección IP del cliente (por ejemplo 192.100.100.10) | ||||
CONNECTION_ID | X | Número único de la conexión | |||||
CS(COOKIE) | X | X | Información sobre las cookies contenidas en al petición HTTP | ||||
CS(HOST) | X | X | Campo Host de la petición HTTP | ||||
CS(REFERER) | X | X | URL de la página que apunta al documento solicitado | ||||
CS(USER_AGENT) | X | X | Información sobre el software y el sistema operativo del cliente | ||||
CS_SIP | X | X | Dirección IP del servidor | ||||
CS_URI | X | X | URI en la cual la petición se efectúa | ||||
CS_URI_QUERY | X | X | Parámetros de búsqueda de peticiones | ||||
CS_URI_STEM | X | X | Parte de la petición sin los parámetros de búsqueda | ||||
DATE | X | X | DD: día, MMM: abreviación de 3 letras para el mes (Ene, | ||||
Feb, etc.), YYYY: año | |||||||
METHOD | X | X | Método HTTP utilizado para la petición enviada al servidor | ||||
PATH_ARGS | X | Parámetros de la CGI: cadena ubicada después del carácter "$" | |||||
STATUS | X | X | Respuesta ofrecida por el servidor | ||||
TIME | X | X | HH: hora, MM: minutos, SS: segundos | ||||
TRANSFER_TIME | X | X | Tiempo solicitado por el servidor para generar la respuesta | ||||
USER | X | X | Nombre del usuario si es autenticado; de lo contrario - (signo | menos). | |||
Si el nombre de usuario contiene espacios, son reemplazados | |||||||
por _ (guiones bajos) | |||||||
URL | X | URL solicitada por el cliente |
Nota: fechas y horas dadas en GMT.
Periodicidad de los backups
Como un archivo de historial de peticiones puede volverse de un tamaño considerable, es posible configurar un mecanismo de archivo automático. La activación de un backup puede estar basada en un cierto periodo de tiempo (expresado en horas, días, semanas o meses), o basado en el tamaño del archivo; cuando se alcanza el tiempo (o tamaño de archivo) definido, 4D se cierra y el archiva automáticamente el archivo de historial actual y crea uno nuevo.
Cuando se activa el backup del archivo de historial Web, el archivo historial se guarda en una carpeta llamada "Logweb Archives," la cual se crea en el mismo nivel que el archivo logweb.txt (es decir, al lado del archivo de estructura de la base).
El archivo guardado se renombra basado en el siguiente ejemplo: "DYYYY_MM_DD_Thh_mm_ss.txt." Por ejemplo, para un archivo guardado el 4 de septiembre del 2006 a las 3:50 p.m. y 7 segundos: "D2006_09_04_T15_50_07.txt."
Parámetros de los backups
Los parámetros de backup automático del historial de peticiones se definen en la página Web/Planificador del historial de las Preferencias de la aplicación:
Primero debe elegir la frecuencia (días, semanas, etc.) o el criterio del tamaño limite del archivo haciendo clic en el botón correspondiente. Luego debe especificar el momento preciso para realizar el backup si es necesario.
Sin backup: la función de backup programado está desactivada.
Cada X hora(s): esta opción se utiliza para programar backups a determinadas horas. Puede introducir un valor entre 1 y 24 .
- a partir de: utilizado para definir la hora a la cual comenzará el primer backup.
Cada X día(s) a las X: esta opción se utiliza para programar backups diarios. Introduzca 1 si quiere realizar un backup diariamente. Cuando esta opción está seleccionada, debe indicar la hora a la cual debe comenzar el backup.
Cada X semana(s), día a las X: esta opción permite programar backups basados en semanas. Introduzca 1 si quiere realizar un backup semanalmente. Cuando esta opción está seleccionada, debe indicar el (los) día(s) de la semana y la hora a la cual el backup debe comenzar. Puede seleccionar varios días de la semana si lo desea. Por ejemplo, puede utilizar esta opción para definir dos backups a la semana: uno el miércoles y el otro los viernes.
Cada X mes(es), X día a las X: esta opción se utiliza para programar backups basados en meses. Introduzca 1 si quiere realizar un backup mensual. Cuando esta opción está seleccionada, debe indicar el día del mes y la hora a la que el backup debe comenzar.
Cada X MB: esta opción se utiliza para programar backups basados en el tamaño del archivo de historial de peticiones actual. Un backup se dispara automáticamente cuando el archivo alcanza el tamaño definido. Puede definir un tamaño límite de 1, 10, 100 o 1000 MB.
Nota: en el caso de los backups programados, si el servidor Web no fue lanzado en el momento del backup programado, en el siguiente inicio 4D considera el backup como fallido y aplica los parámetros apropiados, definidos en las Preferencias de la base.
Información del Explorador de ejecución de 4D
La página Evaluación ("Información") en el Explorador de ejecución muestra la diferente información relativa al servidor Web:
Ocupación de la caché Web: indica el número de páginas presentes en la caché Web así como el porcentaje de utilización. Esta información sólo está disponible si el servidor Web está activo y si el tamaño de la caché es mayor de 0.
Tiempo de actividad del servidor Web: indica la duración del funcionamiento (en formato horas:minutos:segundos) del servidor Web. Esta información sólo está disponible si el servidor Web está activo.
Número de peticiones HTTP: indica el número total de peticiones HTTP recibidas desde el lanzamiento del servidor Web, como también el número instantáneo de las peticiones por segundo (medida tomada entre dos actualizaciones del Explorador de ejecución). Esta información sólo está disponible si el servidor Web está activo.
Nota: para mayor información sobre el Explorador de ejecución, consulte el Manual de Diseño.
Ver también
Parámetros del servidor Web, WEB CACHE STATISTICS.