Tutoriel : Résoudre les problèmes d’une application App Service avec Azure Monitor

resourceID=$(az webapp show -g myResourceGroup -n <app-name> --query id --output tsv)

workspaceID=$(az monitor log-analytics workspace show -g myResourceGroup --workspace-name <workspace-name> --query id --output tsv)

az monitor diagnostic-settings create --resource $resourceID \
 --workspace $workspaceID \
 -n myMonitorLogs \
 --logs '[{"category": "AppServiceConsoleLogs", "enabled": true},
  {"category": "AppServiceHTTPLogs", "enabled": true}]'

Résoudre les problèmes de l’application

Accédez à http://<app-name>.azurewebsites.net.

L’exemple d’application ImageConverter convertit les images incluses du format JPG au format PNG. Pour ce tutoriel, un bogue a été délibérément placé dans le code. Si vous sélectionnez un certain nombre d’images, l’application génère une erreur HTTP 500 durant leur conversion. Imaginez que ce scénario n’ait pas été envisagé pendant la phase de développement. Vous utiliserez Azure Monitor pour corriger l’erreur.

Vérification du bon fonctionnement de l’application

Pour convertir des images, cliquez sur Tools et sélectionnez Convert to PNG.

Sélectionnez les deux premières images, puis cliquez sur convert. Cette conversion s’effectue correctement.

Faire planter l’application

Vous avez vérifié le bon fonctionnement de l’application en convertissant deux images. À présent, vous essayez de convertir les cinq premières images.

Cette action échoue et génère une erreur HTTP 500 qui n’a pas été testée pendant le développement.

Utiliser une requête de journal pour visualiser les journaux Azure Monitor

Voyons quels journaux sont disponibles dans l’espace de travail Log Analytics.

Cliquez sur ce lien vers l’espace de travail Log Analytics pour accéder à votre espace de travail dans le portail Azure.

Dans le portail Azure, sélectionnez votre espace de travail Log Analytics.

Requêtes dans les journaux

Les requêtes de journal vous permettent d’appliquer pleinement la valeur des données collectées dans les journaux d’activité Azure Monitor. Vous utilisez des requêtes de journal pour identifier les journaux dans AppServiceHTTPLogs et AppServiceConsoleLogs. Pour plus d’informations sur les requêtes de journal, consultez la vue d’ensemble des requêtes de journal.

Visualiser AppServiceHTTPLogs en utilisant une requête de journal

Nous avons accédé à l’application. À présent, nous allons visualiser les données associées aux requêtes HTTP, se trouvant dans AppServiceHTTPLogs.

1. Cliquez sur Logs dans le volet de navigation de gauche.

2. Recherchez appservice, puis double-cliquez sur AppServiceHTTPLogs.

3. Cliquez sur Run.

La requête AppServiceHTTPLogs retourne toutes les requêtes des dernières 24 heures. La colonne ScStatus contient l’état HTTP. Pour diagnostiquer les erreurs HTTP 500, limitez l’état ScStatus à 500 et exécutez la requête comme indiqué ci-dessous :

AppServiceHTTPLogs
| where ScStatus == 500

Visualiser AppServiceConsoleLogs en utilisant une requête de journal

Vous avez identifié les erreurs HTTP 500. À présent, vous allez observer les sorties/erreurs standard de l’application. Ces journaux se trouvent dans « AppServiceConsoleLogs ».

(1) Cliquez sur + pour créer une requête.

(2) Double-cliquez sur la table AppServiceConsoleLogs, puis cliquez sur Run.

Comme la conversion de cinq images entraîne des erreurs de serveur, vous pouvez voir si l’application consigne également des erreurs en filtrant ResultDescription sur les erreurs comme indiqué ci-dessous :

AppServiceConsoleLogs |
where ResultDescription  contains "error" 

Vous voyez l’erreur suivante dans la colonne ResultDescription :

PHP Fatal error:  Allowed memory size of 134217728 bytes exhausted 
(tried to allocate 16384 bytes) in /home/site/wwwroot/process.php on line 20, 
referer: http://<app-name>.azurewebsites.net/

Joindre AppServiceHTTPLogs et AppServiceConsoleLogs

Vous avez identifié les erreurs HTTP 500 et les erreurs standard. À présent, vous devez vérifier s’il existe une corrélation entre ces messages. Ensuite, vous devez joindre les tables en fonction de l’horodatage, TimeGenerated.

Exécutez la requête suivante :

let myHttp = AppServiceHTTPLogs | where  ScStatus == 500 | project TimeGen=substring(TimeGenerated, 0, 19), CsUriStem, ScStatus;  

let myConsole = AppServiceConsoleLogs | project TimeGen=substring(TimeGenerated, 0, 19), ResultDescription;

myHttp | join myConsole on TimeGen | project TimeGen, CsUriStem, ScStatus, ResultDescription;

La colonne ResultDescription présente l’erreur suivante en même temps que les erreurs de serveur web :

PHP Fatal error:  Allowed memory size of 134217728 bytes exhausted 
(tried to allocate 16384 bytes) in /home/site/wwwroot/process.php on line 20, 
referer: http://<app-name>.azurewebsites.net/

Le message indique que la mémoire est saturée à la ligne 20 de process.php. Vous avez pu constater que l’application a généré une erreur quand l’erreur HTTP 500 s’est produite. À présent, examinons le code pour identifier le problème.

Identifier l’erreur

Dans le répertoire local, ouvrez le fichier process.php et examinez la ligne 20.

imagepng($imgArray[$x], $filename);

Le premier argument, $imgArray[$x], est une variable qui contient toutes les images JPG (en mémoire) à convertir. Toutefois, imagepng a besoin de l’image en cours de conversion uniquement et non de toutes les images. Le préchargement des images n’est pas nécessaire et peut entraîner la saturation de la mémoire, générant des erreurs HTTP 500. Nous allons mettre à jour le code pour charger les images à la demande et voir si ceci résout le problème. Ensuite, vous améliorez le code pour résoudre le problème de mémoire.

Corriger l’application

Mettre à jour localement et redéployer le code

Vous devez apporter les modifications suivantes à process.php pour résoudre le problème de saturation de la mémoire :

<?php

//Retrieve query parameters
$maxImages = $_GET['images'];
$imgNames  = explode(",",$_GET['imgNames']);

//Load JPEGs into an array (in memory)
for ($x=0; $x<$maxImages; $x++){
    $filename = './images/converted_' . substr($imgNames[$x],0,-4) . '.png';
    imagepng(imagecreatefromjpeg("./images/" . $imgNames[$x]), $filename);
}

Validez vos modifications dans Git, puis envoyez les modifications de code à Azure.

git commit -am "Load images on-demand in process.php"
git push azure main

Accéder à l’application Azure

Accédez à http://<app-name>.azurewebsites.net.

La conversion des images ne doit plus générer d’erreurs HTTP 500.

Nettoyer les ressources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources. Si vous ne pensez pas avoir besoin de ces ressources à l’avenir, supprimez le groupe de ressources en exécutant la commande suivante dans Cloud Shell :

az group delete --name myResourceGroup

L’exécution de cette commande peut prendre une minute.

Supprimez le paramètre de diagnostic à l’aide de la commande suivante :

az monitor diagnostic-settings delete --resource $resourceID -n myMonitorLogs

Vous avez appris à effectuer les opérations suivantes :

Étapes suivantes

• Interrogation de journaux d’activité grâce à Azure Monitor
• Dépannage d’une application web dans le Service d’application Microsoft Azure à l’aide de Visual Studio
• Analyse des journaux d’activité d’application dans HDInsight (en anglais)
• Tutoriel : Exécuter un test de charge pour identifier les goulots d’étranglement de performances dans une application web