API 작업 문제 해결

다음 섹션에서는 API 작업에 대한 문제 해결 팁을 제공합니다.

실패한 요청 추적

개발 환경에서는 IIS(인터넷 정보 서비스) 7.0 기능을 사용하여 요청에 대한 정보를 기록할 수 있습니다. 이 기능을 실패한 요청 추적이라고 하며 웹 역할의 구성 내에 설정된 필터에 따라 자세한 추적 로그를 생성합니다.

로깅 대상

Azure는 실패한 요청 로그의 기본 IIS 디렉터리에 추적 로그 파일을 출력합니다. 기본적으로 이 디렉터리가 %SystemDrive%\inetpub\logs\FailedReqLogFiles입니다.

추적 사용

각 웹 역할은 프로젝트의 web.config 파일에 배치된 규칙을 사용하여 추적을 사용하도록 설정해야 합니다. 추적을 사용하도록 설정하려면 web.config 파일의 섹션에 다음을 system.webServer 배치합니다.

<tracing>  
  <traceFailedRequests>  
    <add path="*">  
      <traceAreas>  
        <add provider="ASP" verbosity="Verbose" />  
        <add provider="ASPNET" areas="Infrastructure,Module,Page,AppServices" verbosity="Verbose" />  
        <add provider="ISAPI Extension" verbosity="Verbose" />  
        <add provider="WWW Server" areas="Authentication,Security,Filter,StaticFile,CGI,Compression,Cache,RequestNotifications,Module" verbosity="Verbose" />  
      </traceAreas>  
      <failureDefinitions statusCodes="400-599" />  
    </add>  
  </traceFailedRequests>  
</tracing>  

추적을 사용하지 않도록 설정하려면 web.config 파일에서 이 섹션을 제거합니다.

x-ms-request-id 헤더

Azure Storage에 대해 이루어진 모든 요청은 라는 x-ms-request-id응답 헤더를 반환합니다. 이 헤더는 요청을 고유하게 식별하는 불투명 값을 포함합니다.

요청이 지속적으로 실패하고 요청이 제대로 작성되었는지 확인한 경우 이 값을 사용하여 오류를 Microsoft에 보고할 수 있습니다. 보고서에 다음 정보를 포함합니다.

  • x-ms-request-id의 값
  • 요청이 이루어진 대략적 시간입니다.
  • 요청이 이루어진 Storage 서비스입니다.
  • 요청이 시도한 작업의 유형입니다.

추가 정보

스토리지 서비스 REST