Resolver problemas de operações da API
As secções seguintes oferecem sugestões de resolução de problemas para operações de API.
Rastreio de pedidos com falha
O ambiente de desenvolvimento suporta a utilização de uma funcionalidade dos Serviços de Informação Internet (IIS) 7.0 para registar informações sobre pedidos. A funcionalidade chama-se rastreio de pedidos com falha e produz registos de rastreio detalhados de acordo com filtros estabelecidos na configuração de uma função Web.
Destino do registo
O Azure produz ficheiros de registo de rastreio para o diretório do IIS predefinido para registos de pedidos falhados. Por predefinição, este diretório é %SystemDrive%\inetpub\logs\FailedReqLogFiles.
Ativar o rastreio
Cada função Web tem de ativar o rastreio através de regras colocadas no ficheiro deweb.config do projeto. Para ativar o rastreio, coloque o seguinte na system.webServer secção do ficheiro deweb.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 desativar o rastreio, remova esta secção do ficheiro web.config .
O cabeçalho x-ms-request-id
Cada pedido feito no Armazenamento do Azure devolve um cabeçalho de resposta com o nome x-ms-request-id. Este cabeçalho contém um valor opaco que identifica exclusivamente o pedido.
Se um pedido estiver a falhar de forma consistente e tiver verificado que o pedido está devidamente formulado, pode utilizar este valor para comunicar o erro à Microsoft. No seu relatório, inclua as seguintes informações:
- O valor de
x-ms-request-id. - A hora aproximada em que o pedido foi feito.
- O serviço de Armazenamento no qual o pedido foi feito.
- O tipo de operação que o pedido tentou.