Registro de errores en las API HTTP

En este artículo se describen las funcionalidades de registro de errores de las interfaces de programación de aplicaciones (API) del Protocolo de transferencia de hipertexto (HTTP).

Versión original del producto: Windows Server 2008 R2, Windows Server 2008, Windows Server 2012 R2, Windows Server 2012, Windows 10, Windows 8.1
Número de KB original: 820729

Resumen

La API HTTP controla automáticamente algunos errores que se producen en una aplicación basada en HTTP en lugar de pasarse a una aplicación para su control. Este comportamiento se produce porque la frecuencia de estos errores podría inundar un registro de eventos o un controlador de aplicación.

En los temas siguientes se describen los distintos aspectos del registro de errores de la API HTTP.

• Configuración del registro de errores de la API HTTP
  La configuración del Registro controla los errores de registros de la API HTTP, el tamaño máximo permitido de los archivos de registro y la ubicación de los archivos de registro.

• Formato de los registros de errores de la API HTTP
  La API HTTP crea archivos de registro que siguen las convenciones de archivos de registro de World Wide Web Consortium (W3C). Puede usar herramientas estándar para analizar estos archivos de registro. Sin embargo, a diferencia de los archivos de registro W3C, los archivos de registro de API HTTP no contienen los nombres de las columnas.

• Tipos de errores que registra la API HTTP
  La API HTTP registra muchos errores comunes.

Los métodos siguientes describen la resolución del registro de errores de la API HTTP.

Configuración del registro de errores de la API HTTP

Tres valores del Registro en una clave HTTP \Parameters controlan el registro de errores de la API HTTP. Estas claves se encuentran en la clave del Registro: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\HTTP\Parameters.

Debe tener credenciales de administrador o sistema local para cambiar los valores del Registro y ver o cambiar los archivos de registro y la carpeta que los contiene.

La información de configuración de los valores del Registro se lee cuando se inicia el controlador de API HTTP. Por lo tanto, si cambia la configuración, debe detener y reiniciar el controlador para leer los nuevos valores. Para ello, escriba los siguientes comandos de consola:

net stop http
net start http

La siguiente convención de nomenclatura se usa para asignar un nombre a los archivos de registro:
httperr + número de secuencia + .log
Ejemplo: httperr4.log

Los archivos de registro se ciclos cuando alcanzan el tamaño máximo que especifica el valor del Registro ErrorLogFileTruncateSize. Este valor no puede ser inferior a 1 megabyte (MB).

Si la configuración del registro de errores no es válida o si se produce algún tipo de error mientras la API HTTP escribe en los archivos de registro, la API HTTP usa el registro de eventos para notificar a los administradores que no se está produciendo el registro de errores.

En la tabla siguiente se describen los valores de configuración del Registro.

Formato de los registros de errores de la API HTTP

Por lo general, los archivos de registro de errores de la API HTTP tienen el mismo formato que los registros de errores de W3C, salvo que los archivos de registro de errores de la API HTTP no contienen encabezados de columna. Cada línea de un registro de errores de la API HTTP registra un error. Los campos aparecen en un orden específico. Un solo carácter de espacio (0x0020) separa cada campo del campo anterior. En cada campo, los signos más (0x002B) reemplazan los caracteres de espacio, las pestañas y los caracteres de control no imprimibles.

En la tabla siguiente se identifican los campos y el orden de los campos en un registro de errores.

Las siguientes líneas de ejemplo proceden de un registro de errores de la API HTTP:

2002-07-05 18:45:09 172.31.77.6 2094 172.31.77.6 80 HTTP/1.1 GET /qos/1kbfile.txt 503 - ConnLimit  
2002-07-05 19:51:59 127.0.0.1 2780 127.0.0.1 80 HTTP/1.1 GET /ThisIsMyUrl.htm 400 - Hostname  
2002-07-05 19:53:00 127.0.0.1 2894 127.0.0.1 80 HTTP/2.0 GET / 505 - Version_N/S  
2002-07-05 20:06:01 172.31.77.6 64388 127.0.0.1 80 - - - - - Timer_MinBytesPerSecond

Tipos de errores que registra la API HTTP

La API HTTP registra respuestas de error a clientes, tiempos de espera de conexión, solicitudes huérfanas y conexiones eliminadas que se controlan incorrectamente.

En la lista siguiente se identifican los tipos de errores que registra la API HTTP:

• Respuestas a clientes
  La API HTTP envía una respuesta de error a un cliente, por ejemplo, un error 400 causado por un error de análisis en la última solicitud recibida. Una vez que la API HTTP envía la respuesta de error, cierra la conexión.

• Tiempos de espera de conexión
  La API HTTP agota el tiempo de espera de una conexión. Si una solicitud está pendiente cuando se agota el tiempo de espera de la conexión, la solicitud se usa para proporcionar más información sobre la conexión en el registro de errores.

• Solicitudes huérfanas
  Un proceso en modo de usuario se detiene inesperadamente mientras todavía hay solicitudes en cola que se enrutan a ese proceso. La API HTTP registra las solicitudes huérfanas en el registro de errores. Los tipos de error específicos se denominan mediante cadenas de frase de motivo que siempre aparecen como el último campo de cada línea de error. En la tabla siguiente se identifican las frases de motivo de la API HTTP.