Información sobre el sitio web

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.

Nota: por razones de seguridad, a partir de 4D v15 R2, el método HTTP TRACE está desactivado por defecto en el servidor web de 4D. Esto significa que cuando se recibe una petición HTTP TRACE, el servidor web de 4D ahora devuelve un error 405 ("método no autorizado"). Si desea habilitar explícitamente el método HTTP TRACE, debe utilizar la opción Web HTTP TRACE con el comando WEB SET OPTION.

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.

El URL /4DSTATS devuelve diferente información en una tabla HTML (visible en un navegador):

• Cache Current Size: tamaño actual de la caché del servidor web (en bytes)
• Cache Max Size: tamaño máximo de la caché (en bytes)
• Cached Object Max Size: tamaño máximo de cada objeto en la caché (en bytes)
• Cache Use: porcentaje de la caché utilizada
• Cached Objects: número de objetos (páginas, archivos imagen, etc.) presentes en la caché.

(*) Para mayor información sobre la caché de las páginas estáticas y de las imágenes, consulte la sección Parámetros del servidor webParámetros del servidor web.

Esta información puede permitirle controlar el funcionamiento de su servidor y eventualmente adaptar los parámetros correspondientes.

Nota: el comando WEB GET STATISTICS también le permite obtener información sobre cómo la caché está siendo utilizada por las páginas estáticas.

El URL /4DHTMLSTATS devuelve, igualmente en forma de tabla HTML, la misma información que el URL /4DSTATS. La diferencia es que en el último campo Cached Objects, sólo cuenta las páginas HTML, sin los archivos imagen. Además, este URL devuelve el campo Filtered Objects.

• Filtered Objects: número de objetos de la caché no contabilizados por el URL, en particular las imágenes.

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.

El URL /4DWEBTEST permite controlar el estado del servidor web. Cuando se llama esta URL, 4D devuelve un archivo de texto que contiene únicamente los siguientes campos HTTP:

• Date: fecha actual en el formato RFC 822
  Por ejemplo: “Mon, 16 Jan 2012 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/5.0 (Windows NT 6.1; WOW64; rv:9.0.1) Gecko/20100101 Firefox/9.0.1 @ 127.0.0.1

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, en la carpeta Logs ubicada junto al archivo de estructura de la base.
• con 4D en modo remoto, en la subcarpeta Logs de la carpeta de base del cliente 4D (carpeta caché).

La activación y la configuración del contenido del archivo de historial se efectúa en las Propiedades de la base, página Web/Historial (formato):

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 (4D v12) o WEB SET OPTION (4D v13 y posteriores).

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:

Nota: fechas y horas dadas en GMT.

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

Los parámetros de backup automático del historial de peticiones se definen en la página Web/Historial (periodicidad) de las Propiedades de la base:

Primero debe elegir la frecuencia (días, semanas, etc.) o el criterio de 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.

• Todos los 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.

• Todos los 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.

• Todos los 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.

• Todos los 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.

• Todos los 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 Propiedades.

La página Evaluación (título “Web”) en el Explorador de ejecución muestra la información relativa al servidor web, particularmente:

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