Registro de W3C
El registro extendido de W3C es el tipo de registro del lado servidor que se puede habilitar en la sesión del servidor o en el grupo de direcciones URL. Cuando el registro W3C está habilitado en un grupo de direcciones URL, el registro solo se realiza en las solicitudes que se enrutan al grupo de direcciones URL. Se crea un archivo de registro independiente para cada grupo de direcciones URL configurado para habilitar el registro W3C.
Cuando el registro W3C está habilitado en la sesión del servidor, funciona como forma centralizada de registro para todos los grupos de direcciones URL de la sesión del servidor. Se mantiene un único archivo de registro para todos los grupos de direcciones URL de la sesión del servidor.
En la tabla siguiente se enumeran los campos que puede registrar la API del servidor HTTP. La tabla contiene un subconjunto de las constantes HTTP_LOG_FIELD. Algunos de los campos que se enumeran a continuación se generan automáticamente mediante la API del servidor HTTP internamente y, por lo tanto, no se incluyen en la estructura de HTTP_LOG_FIELDS_DATA. La columna "Aparece como" contiene el texto que aparece en el archivo de registro. Los datos de la tabla están en el orden de aparición en el registro del archivo de registro.
Los campos que no están marcados como "API de servidor HTTP generada" deben pasarse dentro de HTTP_LOG_FIELDS_DATA estructura por aplicación. La aplicación podría generar esos campos a partir de la estructura de HTTP_REQUEST que se le ha pasado.
| Campo | Aparece como | Descripción | miembro de HTTP_LOG_FIELDS_DATA | constantes de HTTP_LOG_FIELDS |
|---|---|---|---|---|
| Fecha | fecha | Fecha en la que se produjo la actividad. | API del servidor HTTP generada. | HTTP_LOG_FIELD_DATE |
| Hora | Hora | Hora, en hora universal coordinada (UTC), en la que se produjo la actividad. | API del servidor HTTP generada. | HTTP_LOG_FIELD_TIME |
| Nombre del servicio y número de instancia | s-sitename | El nombre del servicio Internet y el número de instancia que se estaba ejecutando en el cliente. | ServiceName | HTTP_LOG_FIELD_SITE_NAME |
| Nombre del servidor | s-computername | Nombre del servidor en el que se generó la entrada del archivo de registro. | ServerName | HTTP_LOG_FIELD_COMPUTER_NAME |
| Dirección IP del servidor | s-ip | Dirección IP del servidor en el que se generó la entrada del archivo de registro. | ServerIp | HTTP_LOG_FIELD_SERVER_IP |
| Método | cs-method | Verbo solicitado, por ejemplo, un método GET. | Método | HTTP_LOG_FIELD_METHOD |
| Tallo de URI | cs-uri-stem | Destino del verbo, por ejemplo, Default.htm. | UriStem | HTTP_LOG_FIELD_URI_STEM |
| Consulta de URI | cs-uri-query | Consulta, si existe, que el cliente estaba intentando realizar. Una consulta de identificador de recursos universal (URI) solo es necesaria para páginas dinámicas. | UriQuery | HTTP_LOG_FIELD_URI_QUERY |
| Puerto de servidor | s-port | Número de puerto del servidor configurado para el servicio. | ServerPort | HTTP_LOG_FIELD_SERVER_PORT |
| Nombre de usuario | cs-username | Nombre del usuario autenticado al que obtuvo acceso al servidor. Los usuarios anónimos se indican mediante un guión. | Nombre de usuario | HTTP_LOG_FIELD_USER_NAME |
| Dirección IP del cliente | c-ip | Dirección IP del cliente que realizó la solicitud. | ClientIp | HTTP_LOG_FIELD_CLIENT_IP |
| Versión del protocolo | cs-version | Versión del protocolo HTTP que usó el cliente. | API del servidor HTTP generada. | HTTP_LOG_FIELD_VERSION |
| Agente de usuario | cs(User-Agent) | Tipo de explorador que usó el cliente. | UserAgent | HTTP_LOG_FIELD_USER_AGENT |
| Galleta | cs(Cookie) | Contenido de la cookie enviada o recibida, si existe. | Galleta | HTTP_LOG_FIELD_COOKIE |
| Referente | cs(Referer) | Sitio que el usuario visitó por última vez. Este sitio proporcionó un vínculo al sitio actual. | Referente | HTTP_LOG_FIELD_REFERRER |
| Anfitrión | cs-host | Nombre del encabezado de host, si existe. | Anfitrión | HTTP_LOG_FIELD_HOST |
| Estado HTTP | sc-status | Código de estado HTTP. | ProtocolStatus | HTTP_LOG_FIELD_STATUS |
| Subestado de protocolo | sc-substatus | Código de error de subestado. | SubStatus | HTTP_LOG_FIELD_SUB_STATUS |
| Estado de Win32 | sc-win32-status | Código de estado de Windows. | Win32Status | HTTP_LOG_FIELD_WIN32_STATUS |
| Bytes enviados | sc-bytes | Número de bytes enviados por el servidor. | API del servidor HTTP generada. | HTTP_LOG_FIELD_BYTES_SENT |
| Bytes recibidos | cs-bytes | Número de bytes recibidos y procesados por el servidor. | API del servidor HTTP generada. | HTTP_LOG_FIELD_BYTES_RECV |
| Tiempo necesario | tiempo necesario | Período de tiempo durante el que se realizó la acción, en milisegundos. | API del servidor HTTP generada. | HTTP_LOG_FIELD_TIME_TAKEN |
| Id. de secuencia | streamid | Identificador de secuencia. | API del servidor HTTP generada. | HTTP_LOG_FIELD_STREAM_ID |
El archivo de registro es un formato personalizado basado en texto ASCII. Los prefijos de campo del archivo se definen de la siguiente manera:
| Prefijo | Descripción |
|---|---|
| s | Acciones del servidor. |
| c | Acciones de cliente. |
| Sc | Acciones de servidor a cliente. |
| Cs | Acciones de cliente a servidor. |
La aplicación puede seleccionar uno o varios de los campos de archivo de registro extendido de W3C, pero no todos los campos contendrán información. En el caso de los campos seleccionados, pero para los que no hay información, aparece un guión (-) como marcador de posición. Si un campo contiene un carácter no imprimible, la API del servidor HTTP la reemplaza por un signo más (+) para conservar el formato del archivo de registro. Esto suele ocurrir con ataques de virus, cuando, por ejemplo, un usuario malintencionado envía retornos de carro y fuentes de línea que, si no se reemplazan por el signo más (+), interrumpirían el formato del archivo de registro. Los campos están separados por espacios.
Si el grupo de direcciones URL o la sesión del servidor habilita un campo, pero no está seleccionado para la solicitud, aparece en el archivo de registro con un guión (-) como marcador de posición.
Los archivos de registro se crean cuando llega la primera solicitud en la sesión de grupo de direcciones URL o servidor, no se crean cuando se configura el registro. En el ejemplo siguiente se muestra la primera entrada del archivo de registro de un archivo de registro W3C con los campos Ip del cliente, Nombre de usuario, IP del servidor, Puerto de servidor, Método, URI Stem, Consulta de URI, Estado y Agente de usuario habilitados:
#Software: Microsoft HTTP Server API 2.0
#Version: 1.0 // the log file version as it's described by "https://www.w3.org/TR/WD-logfile".
#Date: 2002-05-02 17:42:15 // when the first log file entry was recorded, which is when the entire log file was created.
#Fields: date time c-ip cs-username s-ip s-port cs-method cs-uri-stem cs-uri-query sc-status cs(User-Agent)
2002-05-02 17:42:15 172.22.255.255 - 172.30.255.255 80 GET /images/picture.jpg - 200 Mozilla/4.0+(compatible;MSIE+5.5;+Windows+2000+Server)
El campo que se tarda se inicializa cuando la API del servidor HTTP recibe el primer byte, antes de analizar la solicitud. La marca de tiempo que se tarda se detiene cuando se produce la última finalización del envío. El tiempo necesario no refleja el tiempo en toda la red. La primera solicitud al sitio muestra un tiempo ligeramente mayor que otras solicitudes similares porque la API del servidor HTTP abre el archivo de registro con la primera solicitud.