Compartilhar via


Solução de problemas de operações de API

As seções a seguir oferecem dicas de solução de problemas para operações de API.

De uma solicitação de rastreio com falha

O ambiente de desenvolvimento dá suporte ao uso de um recurso do IIS (Serviços de Informações da Internet) 7.0 para registrar informações sobre solicitações. O recurso é chamado de rastreamento de solicitação com falha e produz logs de rastreamento detalhados de acordo com os filtros estabelecidos na configuração de uma função Web.

Destino de registro em log

O Azure gera arquivos de log de rastreamento para o diretório do IIS padrão para logs de solicitação com falha. Por padrão, esse diretório é %SystemDrive%\inetpub\logs\FailedReqLogFiles.

Habilitando o rastreamento

Cada função web deve habilitar o rastreamento usando regras colocadas no arquivo web.config do projeto. Para habilitar o rastreamento, coloque o seguinte na system.webServer seção do arquivo web.config :

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

Para desabilitar o rastreamento, remova esta seção do arquivo web.config .

O cabeçalho x-ms-request-id

Cada solicitação feita no Armazenamento do Azure retorna um cabeçalho de resposta chamado x-ms-request-id. Esse cabeçalho contém um valor opaco que identifica exclusivamente a solicitação.

Se uma solicitação estiver falhando consistentemente e você tiver verificado que a solicitação foi formulada corretamente, você poderá usar esse valor para relatar o erro à Microsoft. No relatório, inclua as seguintes informações:

  • O valor de x-ms-request-id.
  • A hora aproximada em que a solicitação foi feita.
  • O serviço de armazenamento no qual a solicitação foi feita.
  • O tipo de operação que a solicitação tentou.

Confira também

REST dos serviços de armazenamento