HTTP API에서 오류 로깅

이 문서에서는 HTTP(HyperText Transfer Protocol) API(애플리케이션 프로그래밍 인터페이스)의 오류 로깅 기능에 대해 설명합니다.

원래 제품 버전: Windows Server 2008 R2, Windows Server 2008, Windows Server 2012 R2, Windows Server 2012, Windows 10, Windows 8.1
원본 KB 번호: 820729

요약

HTTP 기반 애플리케이션에서 발생하는 일부 오류는 처리를 위해 애플리케이션에 다시 전달되는 대신 HTTP API에서 자동으로 처리됩니다. 이 동작은 이러한 오류의 빈도가 이벤트 로그 또는 애플리케이션 처리기를 플러시할 수 있기 때문에 발생합니다.

다음 topics HTTP API 오류 로깅의 다양한 측면을 설명합니다.

• HTTP API 오류 로깅 구성
  레지스트리 설정은 HTTP API 로그 오류, 허용되는 최대 로그 파일 크기 및 로그 파일의 위치를 제어합니다.

• HTTP API 오류 로그의 형식
  HTTP API는 W3C(World Wide Web Consortium) 로그 파일 규칙을 따르는 로그 파일을 만듭니다. 표준 도구를 사용하여 이러한 로그 파일을 구문 분석할 수 있습니다. 그러나 W3C 로그 파일과 달리 HTTP API 로그 파일에는 열 이름이 포함되지 않습니다.

• HTTP API에서 기록하는 오류 종류
  HTTP API는 많은 일반적인 오류를 기록합니다.

다음 메서드는 HTTP API 오류 로깅의 해결 방법을 설명합니다.

HTTP API 오류 로깅 구성

HTTP \Parameters 키 아래의 3개 레지스트리 값은 HTTP API 오류 로깅을 제어합니다. 이러한 키는 레지스트리 키 HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\HTTP\Parameters에 있습니다.

레지스트리 값을 변경하고 로그 파일과 해당 값이 포함된 폴더를 보거나 변경하려면 관리자/로컬 시스템 자격 증명이 있어야 합니다.

레지스트리 값의 구성 정보는 HTTP API 드라이버가 시작될 때 읽습니다. 따라서 설정을 변경하면 중지한 다음 드라이버를 다시 시작하여 새 값을 읽어야 합니다. 이렇게 하려면 다음 콘솔 명령을 입력합니다.

net stop http
net start http

다음 명명 규칙은 로그 파일의 이름을 지정하는 데 사용됩니다.
httperr + 시퀀스 번호 + .log
예: httperr4.log

로그 파일은 ErrorLogFileTruncateSize 레지스트리 값이 지정하는 최대 크기에 도달하면 순환됩니다. 이 값은 1MB(메가바이트) 미만일 수 없습니다.

오류 로깅 구성이 유효하지 않거나 HTTP API가 로그 파일에 쓰는 동안 오류가 발생하는 경우 HTTP API는 이벤트 로깅을 사용하여 관리자에게 오류 로깅이 발생하지 않음을 알립니다.

다음 표에서는 레지스트리 구성 값에 대해 설명합니다.

HTTP API 오류 로그의 형식

일반적으로 HTTP API 오류 로그 파일에는 열 머리글이 포함되지 않는다는 점을 제외하고 HTTP API 오류 로그 파일은 W3C 오류 로그와 동일한 형식을 갖습니다. HTTP API 오류 로그의 각 줄은 하나의 오류를 기록합니다. 필드는 특정 순서로 표시됩니다. 단일 공백 문자(0x0020)는 각 필드를 이전 필드와 구분합니다. 각 필드에서 더하기 기호(0x002B)는 공백 문자, 탭 및 인쇄할 수 없는 컨트롤 문자를 대체합니다.

다음 표에서는 오류 로그 레코드의 필드와 필드 순서를 식별합니다.

다음 샘플 줄은 HTTP API 오류 로그에서 가져옵니다.

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

HTTP API에서 기록하는 오류 종류

HTTP API는 클라이언트, 연결 시간 제한, 분리된 요청 및 잘못 처리된 삭제된 연결에 대한 오류 응답을 기록합니다.

다음 목록에서는 HTTP API가 기록하는 오류 종류를 식별합니다.

• 클라이언트에 대한 응답
  HTTP API는 클라이언트에 오류 응답을 보냅니다(예: 마지막으로 받은 요청의 구문 분석 오류로 인해 발생하는 400 오류). HTTP API가 오류 응답을 보낸 후 연결을 닫습니다.

• 연결 시간 제한
  HTTP API는 연결을 시간 초과합니다. 연결 시간이 초과되면 요청이 보류 중인 경우 요청은 오류 로그의 연결에 대한 자세한 정보를 제공하는 데 사용됩니다.

• 분리된 요청
  해당 프로세스로 라우팅되는 큐에 대기 중인 요청이 있는 동안 사용자 모드 프로세스가 예기치 않게 중지됩니다. HTTP API는 분리된 요청을 오류 로그에 기록합니다. 특정 오류 유형은 항상 각 오류 줄의 마지막 필드로 표시되는 Reason Phrase 문자열에 의해 명명됩니다. 다음 표에서는 HTTP API 이유 구를 식별합니다.