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.