Résolution des problèmes liés aux opérations d’API
Les sections suivantes offrent des conseils de résolution des problèmes pour les opérations d’API.
Suivi des demandes ayant échoué
L’environnement de développement prend en charge l’utilisation d’une fonctionnalité d’Internet Information Services (IIS) 7.0 pour consigner des informations sur les demandes. La fonctionnalité est appelée suivi des demandes ayant échoué, et elle produit des journaux de suivi détaillés en fonction des filtres établis dans la configuration d’un rôle web.
Destination de journalisation
Azure place les fichiers journaux de suivi dans le répertoire IIS par défaut pour les journaux de demandes ayant échoué. Par défaut, ce répertoire est %SystemDrive%\inetpub\logs\FailedReqLogFiles.
Activation du suivi
Chaque rôle web doit activer le suivi à l’aide de règles placées dans le fichier web.config du projet. Pour activer le suivi, placez ce qui suit dans la system.webServer section de votre fichier 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>
Pour désactiver le suivi, supprimez cette section du fichier web.config .
En-tête x-ms-request-id
Chaque requête effectuée sur stockage Azure retourne un en-tête de réponse nommé x-ms-request-id. Cet en-tête contient une valeur opaque qui identifie de façon unique la requête.
Si une demande échoue systématiquement et que vous avez vérifié que la requête est correctement formulée, vous pouvez utiliser cette valeur pour signaler l’erreur à Microsoft. Dans votre rapport, incluez les informations suivantes :
- la valeur de la propriété
x-ms-request-id; - Heure approximative à laquelle la demande a été faite.
- Service de stockage sur lequel la demande a été effectuée.
- Type d’opération que la demande a tentée.